翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Microsoft OneNote の統合
<a name="microsoft-onenote-integration"></a>

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 がサポートする認証方法の詳細については、「」を参照してください[認証方法](quick-action-auth.md)。

## [開始する前に]
<a name="microsoft-onenote-prerequisites"></a>

統合を設定する前に、以下があることを確認してください。
+ 使用する OneNote ノートブックにアクセスできるアクティブな Microsoft 365 アカウント。
+ **カスタム OAuth アプリ**の場合: Microsoft Entra ID (以前の Azure Active Directory) にアクセスしてアプリケーションを登録し、OneNote の Microsoft Graph アクセス許可を設定します。
+ Amazon Quick サブスクリプションの要件については、「」を参照してください[コンソールで統合を設定する](integration-console-setup-process.md)。

## Microsoft Entra ID の設定
<a name="microsoft-onenote-source-setup"></a>

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

カスタム OAuth アプリ認証の場合は、[Microsoft Entra 管理センター](https://entra.microsoft.com/)にアプリケーションを登録し、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 ドキュメントの[「認証と認可の基本](https://learn.microsoft.com/en-us/graph/auth/auth-concepts)」を参照してください。アプリケーション (クライアント) ID とクライアントシークレット値を記録します。Amazon Quick を設定するときに必要になります。

## Amazon Quick でのコネクタのセットアップ
<a name="microsoft-onenote-quicksuite-setup"></a>

### 使用可能なタブから接続する
<a name="microsoft-onenote-quick-connect"></a>

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

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

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

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

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

### チームの作成タブから を作成する
<a name="microsoft-onenote-full-setup"></a>

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

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

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

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

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

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

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

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

   1. **カスタム 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 に置き換えます。

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

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

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

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

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

## 使用可能なアクション
<a name="microsoft-onenote-actions"></a>

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

## の管理とトラブルシューティング
<a name="microsoft-onenote-troubleshooting"></a>

コネクタを編集、共有、または削除するには、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。

### 認証問題
<a name="microsoft-onenote-troubleshooting-auth"></a>
+ **サインインが失敗する (デフォルトの OAuth アプリまたはカスタム OAuth アプリ)** – Microsoft 365 アカウントがアクティブであり、ウェブ上の OneNote に直接サインインできることを確認します。カスタム OAuth アプリの場合、Microsoft Entra ID アプリのリダイレクト URI が Amazon Quick コールバック URL と一致することを確認します。
+ **アクセス許可が不十分** – Microsoft Entra ID アプリで設定された Microsoft Graph アクセス許可に、使用するオペレーションに必要な OneNote スコープが含まれ、必要に応じて管理者の同意が付与されていることを確認します。
+ **無効なクライアント認証情報 (カスタム OAuth アプリ)** – クライアント ID とクライアントシークレットが Microsoft Entra ID アプリ登録の値と一致していることを確認します。クライアントシークレットの有効期限が切れていないことを確認します。