次の方法で共有

Outlook アドインのアクセス許可を理解する

  • [アーティクル]

Outlook アドインは、マニフェストで必要なアクセス許可レベルを指定します。 使用可能なレベルは 4 つあります。

アクセス許可レベル
非現実的な名前		 アドインのみのマニフェスト名 Microsoft 365 名の統合マニフェスト 概要の説明
制限 Restricted MailboxItem.Restricted.User ユーザーまたはメール アイテムに関する特定の情報に関連しないプロパティとメソッドへのアクセスを許可します。
アイテムの読み取り ReadItem MailboxItem.Read.User 制限付きで許可される内容に加えて、次のことができます。
  • 正規表現
  • Outlook アドイン API の読み取りアクセス
  • アイテムのプロパティとコールバック トークンの取得
  • カスタム プロパティの記述
読み取り/書き込み項目 ReadWriteItem MailboxItem.ReadWrite.User 読み取り項目で許可される内容に加えて、次のことができます。
  • makeEwsRequestAsync を除いた、完全な Outlook アドイン API のアクセス
  • アイテムのプロパティの設定
メールボックスの読み取り/書き込み ReadWriteMailbox Mailbox.ReadWrite.User 読み取り/書き込み項目で許可される内容に加えて、次のことができます。
  • アイテムやフォルダーの作成、読み取り、書き込み
  • アイテムの送信
  • makeEwsRequestAsync の呼び出し

アクセス許可はマニフェストで宣言されます。 マークアップはマニフェストの種類によって異なります。

  • アドインのみのマニフェスト: <Permissions> 要素を使用します。
  • Microsoft 365 の統合マニフェスト: "authorization.permissions.resourceSpecific" 配列内のオブジェクトの "name" プロパティを使用します。

注:

  • 追加オン送信機能を使用するアドインには補助アクセス許可が必要です。 アドインのみのマニフェストで、 ExtendedPermissions 要素でアクセス許可を指定します。 詳細については、「 Outlook アドインに追加送信を実装する」を参照してください。 統合マニフェストを使用して、"authorization.permissions.resourceSpecific" 配列の追加オブジェクトに Mailbox.AppendOnSend.User という名前でこのアクセス許可を指定します。
  • 共有フォルダーを使用するアドインには補助アクセス許可が必要です。 アドインのみのマニフェストでは、 SupportsSharedFolders 要素を true に設定して、アクセス許可を指定します。 詳細については、「 Outlook アドインで共有フォルダーと共有メールボックスのシナリオを実装する」を参照してください。 統合マニフェストを使用して、"authorization.permissions.resourceSpecific" 配列の追加オブジェクトに Mailbox.SharedFolder という名前でこのアクセス許可を指定します。

アクセス許可の 4 つのレベルは累積的です。メールボックス読み取り/書き込みアクセス許可にはアイテム読み取り/書き込み、アイテム読み取り、および制限付きが含まれており、アイテム読み取り/書き込みにはアイテム読み取りと制限付きが含まれており、またアイテム読み取りアクセス許可には制限付きが含まれています。

AppSource からインストールする前に、メール アドインによって要求されたアクセス許可を確認できます。 Exchange 管理センターで、インストールしたアドインに必要なアクセス許可を表示することもできます。

ヒント

Outlook アドインで正しいアクセス許可レベルが指定されていることを確認するには、アドインによって実装される各 API で必要な最小アクセス許可レベルを確認します。 最小限のアクセス許可レベルについては、「 Outlook API リファレンス」を参照してください。

制限付きアクセス許可

制限付きアクセス許可は、最も基本的なレベルのアクセス許可です。 アドインがマニフェストで特定のアクセス許可を要求しない場合、Outlook はこのアクセス許可を既定でメール アドインに割り当てます。

できること

ユーザーまたはアイテムに関する特定の情報に関連しないプロパティとメソッドへのアクセス (これを実行するメンバーのリストは、次のセクションを参照)。

できないこと

アイテムの読み取りアクセス許可

読み取り項目のアクセス許可は、アクセス許可モデルの次のレベルのアクセス許可です。

できること

  • 現在のアイテムのすべてのプロパティを読み取りフォームまたは新規作成フォームで読み取る。 たとえば、読み取りフォームで item.to し、新規作成フォームの item.to.getAsync を使用します。

  • Exchange オンプレミス環境では、Exchange Web Services (EWS) を使用して完全なメール アイテムを取得するためのコールバック トークンを取得します。

    重要

    従来の Exchange トークンは非推奨です。 2025 年 2 月から、Exchange Online テナントの従来の Exchange ユーザー ID とコールバック トークンの無効化を開始します。 タイムラインと詳細については、FAQ ページを参照してください。 これは、現在の脅威の状況に対応するために必要なツールを組織に提供する 、Microsoft の Secure Future Initiative の一部です。 Exchange ユーザー ID トークンは、引き続き Exchange オンプレミスで機能します。 入れ子になったアプリ認証は、今後のトークンに推奨される方法です。

  • そのアイテムのアドインが設定するカスタム プロパティの書き込み。

  • コンテキスト アドインで正規表現を使用します。

できないこと

アイテムの読み取り/書き込みアクセス許可

マニフェストで アイテムの読み取り/書き込み アクセス許可を指定して、このアクセス許可を要求します。 作成フォームでアクティブになり、書き込みメソッド (Message.to.addAsync または Message.to.setAsync) を使用するメール アドインは、このレベル以上のアクセス許可を使用する必要があります。

できること

  • Outlook で閲覧または新規作成されているアイテムのすべてのアイテム レベルのプロパティを読み書き。

  • そのアイテムで添付ファイルを追加または削除。

  • メールボックス.makeEWSRequestAsync を除き、メール アドインに適用できる Office JavaScript API の他のすべてのメンバーを使用します。

できないこと

  • mailbox.getCallbackTokenAsync によって提供されるトークンを次の目的に使用すること。

    • Outlook REST API を使用した現在のアイテムの更新または削除、またはユーザーのメールボックスにあるその他アイテムへのアクセス。
    • Outlook REST API を使用した現在の予定表イベント アイテムの取得。

  • Mailbox.makeEWSRequestAsync の使用。

メールボックスの読み取り/書き込みアクセス許可

メールボックスの読み取り/書き込みアクセス許可は、最高レベルのアクセス許可です。

Exchange オンプレミス環境では、 mailbox.getCallbackTokenAsync によって提供されるトークンは、Exchange Web サービス (EWS) 操作または Outlook REST API を使用して次の操作を実行するためのアクセスを提供します。

  • ユーザーのメール ボックスのアイテムのすべてのプロパティの読み取りと書き込み。
  • そのメール ボックスのフォルダーまたはアイテムの作成、読み取り、書き込み。
  • そのメールボックスからアイテムを送信します。

mailbox.makeEwsRequestAsync を使用すると、次の EWS 操作にアクセスできます。

サポートされていない操作を使用すると、エラーが返されます。

重要

従来の Exchange トークンは非推奨です。 2025 年 2 月から、Exchange Online テナントの従来の Exchange ユーザー ID とコールバック トークンの無効化を開始します。 タイムラインと詳細については、FAQ ページを参照してください。 これは、現在の脅威の状況に対応するために必要なツールを組織に提供する 、Microsoft の Secure Future Initiative の一部です。 Exchange ユーザー ID トークンは、引き続き Exchange オンプレミスで機能します。 入れ子になったアプリ認証は、今後のトークンに推奨される方法です。

関連項目