Microsoft OneNote の統合

Microsoft OneNote アクションコネクタを使用すると、自然言語で Microsoft 365 アカウントからノートブック、セクション、ページを直接 Amazon Quick で管理できます。コネクタは、OneNote オペレーションに Microsoft Graph を使用します。

Amazon Quick は、Microsoft OneNote の 2 つの認証方法をサポートしています。組織のセキュリティ要件に最適な方法を選択します。

• デフォルトの OAuth アプリケーション –AWSが管理する OAuth アプリケーションを使用します。追加の認証情報は必要ありません。ユーザーは Microsoft 365 アカウントで直接認証します。

• カスタム OAuth アプリ – Microsoft Entra ID に登録されたカスタマーマネージドアプリケーションを使用します。このオプションを使用すると、組織は OAuth 設定を完全に制御できます。

Amazon Quick がサポートする認証方法の詳細については、「」を参照してください認証方法。

[開始する前に]

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

• 使用する OneNote ノートブックにアクセスできるアクティブな Microsoft 365 アカウント。

• カスタム OAuth アプリの場合: Microsoft Entra ID (以前の Azure Active Directory) にアクセスしてアプリケーションを登録し、OneNote の Microsoft Graph アクセス許可を設定します。

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

Microsoft Entra ID の設定

デフォルトの OAuth アプリ認証を使用している場合は、このセクションをスキップして に進みますAmazon Quick でのコネクタのセットアップ。

カスタム OAuth アプリ認証の場合は、Microsoft Entra 管理センターにアプリケーションを登録し、OneNote の Microsoft Graph アクセス許可 (Notes.Read.All必要に応じて Notes.Read、Notes.ReadWrite、 など) を設定します。Amazon Quick コールバック URL をリダイレクト URI https://{region}.quicksight.aws.amazon.com/sn/oauthcallbackとして追加します。{region} を自分のAWSリージョン (例: ) に置き換えますus-east-1。step-by-stepの手順については、Microsoft Graph ドキュメントの「認証と認可の基本」を参照してください。アプリケーション (クライアント) ID とクライアントシークレット値を記録します。Amazon Quick を設定するときに必要になります。

Amazon Quick でのコネクタのセットアップ

使用可能なタブから接続する

デフォルトの OAuth アプリ認証を使用する場合は、追加の設定なしで、利用可能なタブから直接接続できます。

1. Amazon Quick コンソールで、コネクタを選択します。

2. 使用可能なタブで、OneNote を見つけて接続を選択します。

3. Microsoft サインインフローを完了し、リクエストされたアクセス許可を付与します。

代わりにカスタム OAuth アプリでコネクタを設定するには、以下で説明するようにチーム用に作成タブを使用します。

チームの作成タブから を作成する

1. Amazon Quick コンソールで、コネクタを選択します。

2. チームの作成タブを選択します。

3. OneNote を見つけて選択します。

4. コネクタの名前を入力します。必要に応じて、 + 説明を追加 を選択して説明を追加します。

5. Connection type で、Public network を選択します。

6. OAuth 設定では、次のいずれかの認証方法を選択し、必須フィールドを設定します。

   1. デフォルトの OAuth アプリの場合:

      追加の認証情報は必要ありません。[次へ] を選択して続行します。

   2. カスタム OAuth アプリの場合は、次のフィールドを設定します。

      • ベース URL (オプション) — Microsoft Graph ベース URL。例: https://graph.microsoft.com/v1.0

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

      • パブリック OAuth クライアント (オプション) – Microsoft Entra ID アプリがパブリッククライアント (クライアントシークレットなし) として設定されている場合は、このオプションを選択します。

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

      • トークン URL – Microsoft ID プラットフォームトークンエンドポイント。例: https://login.microsoftonline.com/common/oauth2/v2.0/token

      • 認可 URL – Microsoft ID プラットフォーム認可エンドポイント。例: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

      • リダイレクト URL – Amazon Quick コールバック URL があらかじめ入力されています。

      注記

      テナント固有の認証の場合は、トークン URL と認可 URL commonの を Microsoft Entra ID テナント ID に置き換えます。

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

8. Microsoft サインインウィンドウが開きます。リクエストされたアクセス許可を確認し、Accept を選択します。

9. レビューページで、コネクタで使用可能なアクションを確認します。[次へ] を選択します。

10. 公開ページで、コネクタにアクセスできるユーザーを選択します。組織内のすべてのユーザーに対してアクセスを有効にしたり、特定のチームやグループを検索したりできます。

11. [公開] を選択します。

使用可能なアクション

コネクタを設定すると、OneNote によって公開されるアクションが使用可能になります。コネクタの現在のアクションセットを確認するには、Amazon Quick コンソールのコネクタの利用可能なアクションビューに移動します。

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

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

認証問題

• サインインが失敗する (デフォルトの OAuth アプリまたはカスタム OAuth アプリ) – Microsoft 365 アカウントがアクティブであり、ウェブ上の OneNote に直接サインインできることを確認します。カスタム OAuth アプリの場合、Microsoft Entra ID アプリのリダイレクト URI が Amazon Quick コールバック URL と一致することを確認します。

• アクセス許可が不十分 – Microsoft Entra ID アプリで設定された Microsoft Graph アクセス許可に、使用するオペレーションに必要な OneNote スコープが含まれ、必要に応じて管理者の同意が付与されていることを確認します。

• 無効なクライアント認証情報 (カスタム OAuth アプリ) – クライアント ID とクライアントシークレットが Microsoft Entra ID アプリ登録の値と一致していることを確認します。クライアントシークレットの有効期限が切れていないことを確認します。