Microsoft® OneDrive® コネクターを使用すると、チェーンでコマンド を使用して、Microsoft OneDrive または SharePoint® 内のファイルやフォルダを管理できます。例えば、このコネクターを使えば、次のことができる：
- ファイルやフォルダのコピー、削除、検索が可能。
- ファイルのダウンロードとアップロード
- 使用可能なドライブのリスト
メモ: このコネクターはWorkivaによって構築され、サードパーティのシステムに接続する。Workivaサポートチームは、お客様のワークスペース内でこのコネクターの構成をヘルプすることはできますが、Workivaプラットフォーム外で発生した問題のトラブルシューティングやその他のサポートを行うことはできません。
前提条件
接続を有効にするには、コネクターはMicrosoft Graph APIを使用します。接続を保護するために、コネクターはMicrosoft アプリケーション登録ポータル または Azure® Active Directory® に登録された指定アプリケーションを経由して OAuth 認証を使用します。
コネクターの設定には、以下のものが必要だ：
- Microsoft アプリケーション登録ポータルまたは Azure Active Directoryで登録されたアプリケーション。アプリケーションIDを記録する
- AzureアプリケーションのOAuthクライアントIDとシークレット
- コネクターが実行するコマンドに適したAzureアプリケーションのスコープ
- 接続するドライブのタイプとID。
メモ: マイクロソフトのグラフエクスプローラー (外部リンク) を使って、シェアポイントからこれらを取得することができる。
- プロジェクトのリダイレクトURI：
Microsoft Azure for OneDriveのセットアップ例
アプリケーションの登録
- Microsoft Azureポータルにログインします:
https://azure.microsoft.com/ja/account/ - Azure Active Directoryサービスにナビゲーション
- App Registrationsにナビゲーションし、Manage の下にあるNew Registrationをクリックする。
- 希望するアプリケーション名を入力し、登録を押します。
アプリケーション認証の構成
- Microsoft Azureポータルにログインします:
https://azure.microsoft.com/ja/account/ - Azure Active Directoryサービスにナビゲーション
- Manage の下にあるApp Registrationsにナビゲーション
- 更新された "Manage "パネルの下にある "Authentication "に移動する。
- Supported account types」で、 Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) を選択します。
- プラットフォームの追加でWeb を選択する。
- Redirect URIの下に、上記の有効なコールバックURLを入力
- サポートされるアカウントタイプ」の「MultiTenant 」に必ずチェックを入れてください。
メモ： OneDrive コネクターはマルチテナント オプションを有効にする必要があるため、アプリケーションがセキュリティ コンプライアンスのために正しく構成されていることを確認するのは Azure 管理者次第です。このオプションは、Azureセキュリティで正しく使用された場合、アプリケーションを誰にでも開放するものではない。以下は、その他のステップについての提案である。
- マルチテナントのセットアップに関するマイクロソフトの説明書を参照してください。
https://docs.microsoft.com/en-us/azure/active-directory/develop/single-and-multi-tenant-apps#best-practices-for-multi-tenant-apps - 個々のアプリケーションでセキュリティを有効にします。
https://docs.microsoft.com/ja/azure/active-directory/develop/howto-restrict-your-app-to-a-set-of-users#update-the-app-to-require-user-assignment - ユーザーにアプリケーションへのアクセスを割り当て/許可します。
https://docs.microsoft.com/ja/azure/active-directory/develop/howto-restrict-your-app-to-a-set-of-users#assign-the-app-to-users-and-groups
証明書と秘密の設定
- Microsoft Azureポータルにログインします:
https://azure.microsoft.com/ja/account/ - Azure Active Directoryサービスにナビゲーション
- Manage の下にあるApp Registrationsにナビゲーション
- 更新された「管理」パネルの下にある証明書にナビゲーション
- 中央パネルの新規クライアントシークレット をクリックします。
- 簡単な説明と有効期限をプロバイダーに入力すると、クライアントシークレットが表示されます。これを安全に保管し、Microsoft OneDriveコネクターに仕分けする必要があります。
API権限の設定
- Microsoft Azureポータルにログインします:
https://azure.microsoft.com/ja/account/ - Azure Active Directoryサービスにナビゲーション
- Manage の下にあるApp Registrationsにナビゲーション
- 更新されたManageパネルの下にある"API Permissionsにナビゲーション
- 中央パネルの権限追加をクリックする。
- Microsoft APIs でMicrosoft Graph を選択する。
- 依頼タイプとしてDelegate Permissions を選択する。
- 権限のリストから、必要なものを選びます：
User.Read、ファイル下のすべて、OpenId.offline_access。 - Grant Admin Consent をクリックします。
コネクターが使用するアクセス・レベルを定義します。Microsoft OneDrive コネクターでは、次のスコープ がサポートされています：
ファイル.ReadWrite.Selected ファイル.ReadWrite.AppFolder ファイル.ReadWrite.All ファイル.ReadWrite ファイル.Read.Selected ファイル.Read.All ファイル.Read offline_access
offline_access スコープは最低限必要。
セキュリティの実現
- Microsoft Azureポータルにログインします:
https://azure.microsoft.com/ja/account/ - Azure Active Directoryサービスにナビゲーション
- Manage の下にあるEnterprise Applications をクリックします。
- リストからアプリケーションを選択し、編集プロセスを開始します。アプリケーションがデフォルトで表示されていない場合は、「管理」の「すべてのアプリケーション」をクリックします。
- 管理の下にあるプロパティ をクリックします。
- プロパティ画面で以下のプロパティを設定し、上記で作成したAPIアクセスの使用を許可する：
-
ユーザーがサインインできるようにするか？ = はい
-
ユーザー割り当てが必要か？ = はい
-
(オプション）ユーザーに可視性？ = いいえ
-
- 次に、管理下のユーザーとグループ をクリック
- 標準的な Azure AD プロセスで、必要に応じてユーザーを追加します。 これは、OneDriveの使用が許可され、適切なMicrosoft OneDriveライセンスを持っているユーザーのリストです。
Microsoft OneDriveコネクターの設定
注： 組織のチェーンでコネクターを使用できるようにするには、まず最初に組織のセキュリティ管理者が構成から コネクターを有効にする必要があります。
- チェーンビルダー から接続 をクリックし、右上の作成 をクリックします。
-
コネクター 接続 で、Microsoft OneDrive とデフォルトの CloudRunner を選択します。
- 基本情報の下に、コマンドの識別をヘルプするユニークな名称と説明を入力します。
-
OAuth で、コネクターの Azure アプリケーションの OAuth クライアント ID とシークレットを入力します。
- コネクターのアクセス レベルを決定するには、Azure アプリケーションの認証スコープ を入力します。
- 最低限、
offline_accessスコープが必要である。
- 最低限、
- 接続と OAuth 認証情報を承認するには、Connect をクリックします。
- [プロパティ]で、接続の詳細を入力します。
プロパティ 詳細 ドライブタイプ ドライブ、グループ、ユーザー、サイトなど、接続するドライブのタイプ別を選択します。自分のユーザー・ドライブに接続するには、「現在のユーザー（Me）」を選択します。 ドライブタイプID ドライブタイプ に基づいて、接続するドライブのIDを入力します。例えば、ドライブタイプ が「ユーザー」の場合はユーザーIDを、「サイト」の場合はサイトIDを入力する。 メモ: マイクロソフトのグラフエクスプローラー (外部リンク) を使って、シェアポイントからこれらを取得することができる。
- 接続に使用する環境を選択し、保存します。
- 接続をテストするには、 コネクターのファイルダウンロード コマンド でチェーン を作成・実行し、有効な出力を返すことを確認する。
トラブルシューティング
Microsoft OneDriveまたはSharePointへの接続に失敗した場合：
- コネクターの Azure アプリケーション OAuth 認証情報が存在し、正しく、有効であることを確認します。OAuth証明書には有効期限が定められており、証明書の有効期限が切れている可能性があります。この場合、新規証明書を作成し、Connector に新規クライアントシークレットを入力する必要がある。新規秘密作成の詳細については、証明書と秘密の設定 を参照のこと。
- コネクターに入力されたドライブタイプとIDを確認する。マイクロソフトのグラフエクスプローラー (外部リンク)を使って、シェアポイントからこれらを取得することができます。
- プロジェクトのリダイレクトURIを確認する：