View a markdown version of this page

Microsoft OneDrive アクション統合 - Amazon Quick
[開始する前に]Microsoft Entra の設定Amazon Quick で統合を設定する使用可能なアクションの管理とトラブルシューティング

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

Microsoft OneDrive アクション統合

Microsoft OneDrive アクションコネクタを使用して、自然言語で Amazon Quick で OneDrive ファイル、フォルダ、Excel ワークブックを直接管理します。

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

[開始する前に]

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

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 ドキュメントの「Microsoft Graph アクセス許可の概要」を参照してください。

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

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

  3. 委任されたアクセス許可を選択し、以下の表からアクセス許可を追加します。

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

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

OneDrive アクション統合 – 委任されたアクセス許可
アクセス許可 説明
Files.ReadWrite アプリがサインインしたユーザーのファイルを読み取る、作成、更新、削除できるようにします。
User.Read.All サインインしたユーザーに代わって、アプリが組織内のすべてのユーザーのプロファイルプロパティの完全なセットを読み取ることを許可します。
offline_access ユーザーが再度サインインしなくても、アプリケーションがアクセストークンを更新できるようにします。これにより、ユーザーが再認証する必要がある頻度が減ります。

認証情報を記録する

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

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

Amazon Quick で統合を設定する

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

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

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

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

  4. Microsoft OneDrive でアクションを実行する を選択します。

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

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

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

  6. 接続設定を入力します。

    • ベース 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

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

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

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

使用可能なアクション

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

Microsoft OneDrive で使用可能なアクション
Category アクション 説明
ドライブとアイテム ドライブの取得 ドライブのプロパティと関係を取得します。
ドライブとアイテム 項目を一覧表示する ドライブに含まれるすべての項目を取得します。
ドライブとアイテム Get Item ドライブに含まれる項目を取得します。
ドライブとアイテム フォルダの作成 ユーザーのドライブに新しいフォルダを作成します。
ドライブとアイテム Update Item ファイルまたはフォルダのメタデータを更新します。
ドライブとアイテム Delete Item ファイルまたはフォルダを削除します。項目をごみ箱に移動します。
ドライブとアイテム 子フォルダを一覧表示する フォルダの子に項目のコレクションを返します。
ドライブとアイテム 項目のコピー ファイルまたはフォルダのコピーを別の場所に作成します。
ドライブとアイテム アクセス許可の追加 ファイルまたはフォルダの共有招待を送信します。
ドライブとアイテム ファイルをアップロードする 新しいファイルをアップロードするか、既存のファイルを更新します。最大 250 MB のファイルをサポートします。
Excel ワークブック シートを一覧表示する ワークシートオブジェクトのリストを取得します。
Excel ワークブック シートの追加 新しいワークシートをワークブックに追加します。
Excel ワークブック シートの読み取り ワークシートオブジェクトのプロパティを取得します。
Excel ワークブック 更新シート ワークシートオブジェクトのプロパティを更新します。
Excel ワークブック シートの削除 ワークブックからワークシートを削除します。
Excel ワークブック セルの読み取り 行と列番号で単一のセルの値を取得します。
Excel ワークブック セルの書き込み 行と列番号で単一のセルの値を設定します。
Excel ワークブック 読み取り範囲 範囲の値を取得します。
Excel ワークブック 書き込み範囲 範囲の値を更新します。
Excel ワークブック 範囲をクリアする 範囲の値、形式、塗りつぶし、境界線をクリアします。
Excel ワークブック 範囲の削除 範囲に関連付けられたセルを削除します。
Excel ワークブック 使用範囲の取得 値またはフォーマットを持つセルを含む最小範囲を取得します。

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

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

認証問題

  • アプリ登録が正しくない – 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 に一致するユーザーアカウントがテナントに存在することを確認します。