Microsoft Outlook の統合

Microsoft Outlook アクションコネクタを使用して、自然言語で Amazon Quick で Outlook の E メール、カレンダー、問い合わせ APIsに直接アクセスします。

この統合をセットアップするには、2 つのステップが必要です。まず、アプリケーションを Microsoft Entra に登録し、そのアクセス許可を設定します。次に、Amazon Quick で統合を作成し、Entra アプリに接続します。Amazon Quick がサポートする認証方法の詳細については、「」を参照してください認証方法。

[開始する前に]

統合を設定する前に、以下があることを確認してください。

• Outlook または Exchange Online にアクセスできる Microsoft 365 アカウント。

• 少なくとも Application Developer のアクセス許可を持つ Microsoft Entra 管理センターへのアクセス。

• サブスクリプションの要件については、「」を参照してくださいコンソールで統合を設定する。

Microsoft Entra の設定

Amazon Quick を設定する前に、Microsoft Entra でアプリ登録を作成します。Amazon Quick コンソールに移動する前に、Entra で次の手順をすべて実行します。

アプリ登録の詳細については、Microsoft ドキュメントの「Microsoft ID プラットフォームでアプリケーションを登録する」を参照してください。

アプリケーションを登録する

1. Microsoft Entra 管理センターを開きます。

2. 左側のナビゲーションで、Entra ID を選択し、App registrations を選択します。

3. [New registration] (新規登録) を選択します。

4. Name に、統合のわかりやすい名前を入力します。

5. サポートされているアカウントタイプでは、この組織ディレクトリのアカウントのみを選択します。

6. リダイレクト URI で、ウェブ を選択し、 と入力しますhttps://{region}.quicksight.aws.amazon.com/sn/oauthcallback。{region} を Amazon Quick インスタンスがデプロイされている AWS リージョンに置き換えます。

7. [登録] を選択します。

8. 概要ページで、アプリケーション (クライアント) ID とディレクトリ (テナント) ID をコピーします。Amazon Quick 設定には、これらの値が必要です。

クライアントシークレットを作成する

Amazon Quick には、Microsoft Entra で認証するためのクライアントシークレットが必要です。このシークレットは、アプリ登録のパスワードとして機能します。

1. アプリの登録から、証明書とシークレットを選択します。

2. 新しいクライアントシークレットを選択します。

3. 説明を入力し、有効期限を選択します。

4. [Add] (追加) を選択します。

5. すぐに値をコピーします。この値は 1 回のみ表示されます。

重要

シークレット ID ではなくシークレット値をコピーします。値は、認証に使用される長い文字列です。

API アクセス許可を設定する

Microsoft Graph は、この統合に 2 つのアクセス許可タイプをサポートしています。委任されたアクセス許可により、アプリはサインインユーザーに代わって動作できます。アプリケーションのアクセス許可により、アプリケーションはサインインユーザーなしで動作できます。詳細については、Microsoft ドキュメントの「Microsoft Graph アクセス許可の概要」を参照してください。

1. アプリ登録から API アクセス許可を選択します。

2. アクセス許可の追加を選択し、Microsoft Graph を選択します。

3. 認証方法に基づいて委任されたアクセス許可またはアプリケーションのアクセス許可を選択し、以下の表からアクセス許可を追加します。

4. アクセス許可を承認するには、[テナント名] の管理者同意を付与を選択します。

ユーザー認証 (委任されたアクセス許可) の場合:

Entra アプリ登録に委任されたアクセス許可として以下を追加します。アクセス許可の完全なリファレンスについては、Microsoft ドキュメントの「Microsoft Graph のアクセス許可リファレンス」を参照してください。

Outlook アクション統合 – 委任されたアクセス許可

アクセス許可	説明
Mail.ReadWrite	アプリがユーザーメールボックスで E メールを作成、読み取り、更新、削除できるようにします。
Mail.Send	アプリが組織内のユーザーとしてメールを送信できるようにします。
Calendars.ReadWrite	アプリがユーザーカレンダーでイベントを作成、読み取り、更新、削除できるようにします。
Calendars.ReadWrite.Shared	委任カレンダーや共有カレンダーなど、ユーザーがアクセスできるすべてのカレンダーでイベントを作成、読み取り、更新、削除することをアプリに許可します。
User.Read	ユーザーがアプリにサインインすることを許可し、アプリがサインインしたユーザーのプロファイルを読み取ることを許可します。
User.Read.All	アプリが組織内の他のユーザーのプロファイルプロパティの完全なセットを読み取ることを許可します。
Contacts.Read	アプリがユーザーの連絡先を読み取ることを許可します。
Place.Read.All	カレンダーイベントやその他のアプリケーションの会社の場所 (会議室と会議室リスト) をアプリが読み取ることを許可します。
MailboxSettings.Read	アプリがユーザーのメールボックス設定を読み取ることを許可します。
offline_access	ユーザーが再度サインインしなくても、アプリがアクセストークンを更新できるようにします。これにより、ユーザーが再認証する必要がある頻度が減ります。

注記

User.Read.All と には管理者の同意Place.Read.Allが必要です。管理者は、ユーザーが認証する前に同意を付与する必要があります。

サービス認証 (アプリケーションのアクセス許可) の場合:

Entra アプリ登録にアプリケーションアクセス許可として以下を追加します。

Outlook アクション統合 – アプリケーションのアクセス許可

アクセス許可	説明
Mail.ReadWrite	アプリがすべてのメールボックスでメールを作成、読み取り、更新、削除できるようにします。
Mail.Send	アプリが任意のユーザーとしてメールを送信できるようにします。
Calendars.ReadWrite	アプリがすべてのカレンダーのイベントを作成、読み取り、更新、削除できるようにします。
User.Read.All	アプリがユーザープロファイルを読み取ることを許可します。
Contacts.Read	アプリがすべてのメールボックス内のすべての連絡先を読み取ることを許可します。
Place.Read.All	カレンダーイベントやその他のアプリケーションの会社の場所 (会議室と会議室リスト) をアプリが読み取ることを許可します。
MailboxSettings.Read	アプリがユーザーのメールボックス設定を読み取ることを許可します。

重要

サービス認証では、すべてのアクションがサービスアカウントとして実行されます。この統合にアクセスできるユーザーは、サービスアカウントがアクセスできるすべてのメールボックスでアクションを実行できます。組織のセキュリティ要件に応じて、アプリケーションのアクセス許可の範囲を適切に設定します。

認証情報を記録する

Microsoft Entra 管理センターを離れる前に、次の値があることを確認してください。Amazon Quick 設定にはこれらが必要です。

Microsoft Entra から必要な認証情報

値	検索先
アプリケーション (クライアント) ID	アプリ登録の概要ページ
ディレクトリ (テナント) ID	アプリ登録の概要ページ
クライアントシークレット値	証明書とシークレットページ

Amazon Quick で統合を設定する

Entra 設定が完了したら、Amazon Quick で統合を作成します。

1. Amazon Quick コンソールで、統合を選択します。

2. [Actions] タブを選択します。

3. Microsoft Outlook を選択し、追加 (プラス「＋」) ボタンを選択します。

4. 統合の詳細を入力します。

   • 名前 – Outlook 統合の説明名。

   • 説明 (オプション) – 統合の目的。

5. 接続タイプを選択し、接続設定を入力します。

   1. ユーザー認証 (OAuth) では、次のフィールドを設定します。

      • ベース URL – https://graph.microsoft.com/v1.0

      • クライアント ID – Entra アプリ登録からのアプリケーション (クライアント) ID。

      • クライアントシークレット – Entra アプリ登録からのクライアントシークレット値。

      • トークン URL – https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token

      • 認証 URL – https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize

      • リダイレクト URL – https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

   2. サービス認証では、次のフィールドを設定します。

      • クライアント ID – Entra アプリ登録からのアプリケーション (クライアント) ID。

      • クライアントシークレット – Entra アプリ登録からのクライアントシークレット値。

      • トークン URL – https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token

      • 範囲 – .default

6. [作成して続ける] を選択します。

7. 統合を共有するユーザーを選択します。

8. [次へ] を選択します。

使用可能なアクション

統合を設定すると、次のアクションを使用できます。

Microsoft Outlook で使用可能なアクション

Category	アクション	説明
E メール	ユーザーメールを一覧表示する	メールボックス内の E メールを表示します。
E メール	フォルダメッセージを一覧表示する	特定のメールフォルダにメッセージを表示します。
E メール	E メールの表示	ID で E メールの詳細を取得します。
E メール	ユーザー E メールを送信する	新しい E メールメッセージを送信します。
E メール	E メールへの返信	既存の E メールに返信します。
E メール	ユーザー E メールを転送する	E メールを他の受信者に転送します。
E メール	E メールの更新	E メールのプロパティを編集します。
E メール	E メールの削除	メールボックスから E メールを削除します。
E メール	E メールをフォルダに移動する	E メールを別のフォルダに移動します。
E メール	E メール添付ファイルを一覧表示する	E メールの添付ファイルを表示します。
E メール	添付ファイルの取得	ID で添付ファイルの詳細とコンテンツを取得します。
カレンダー	カレンダーイベントを一覧表示する	カレンダーでイベントを表示します。
カレンダー	カレンダービューを一覧表示する	指定した日付範囲の会議を表示します。
カレンダー	カレンダーイベントの作成	新しい会議または予約を作成します。
カレンダー	カレンダーイベントの更新	既存のイベントを変更します。
カレンダー	カレンダーイベントの削除	カレンダーからイベントを削除します。
カレンダー	会議時間の検索	参加者の可用性に基づいて会議時間を提案します。
Contacts	連絡先を一覧表示する	連絡先を表示します。
[ユーザー]	ユーザーのリストを取得する	組織内のユーザーを表示します。
設定	メールボックス設定の取得	メールボックス設定を読み取ります。
場所	場所を一覧表示する	会議室とルームリストを表示します。

の管理とトラブルシューティング

統合を編集、共有、または削除するには、「」を参照してください既存の統合の管理。

認証問題

• アプリ登録が正しくない – Microsoft Entra のアプリ登録に必要な API アクセス許可が含まれ、管理者の同意が付与されていることを確認します。

• 期限切れのクライアントシークレット – 証明書とシークレットでクライアントシークレットの有効期限が切れているかどうかを確認し、必要に応じて新しいシークレットを生成します。

• リダイレクト URI が正しくない — Microsoft Entra のリダイレクト URI が と一致することを確認しますhttps://{region}.quicksight.aws.amazon.com/sn/oauthcallback。

一般的なエラーメッセージ

• Access denied. You do not have permission to perform this action – 認証されたユーザーに必要なアクセス許可がありません。管理者に連絡して、適切なアクセス許可を確認して付与してください。

• AADSTS50020: User account from identity provider does not exist in tenant – ユーザーアカウントが正しい Microsoft Entra テナントで設定されていません。アプリ登録のディレクトリ (テナント) ID に一致するユーザーアカウントがテナントに存在することを確認します。