Workiva サポートセンター

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。

  注： ：MicrosoftのGraph Explorer（ ）を使用すると、SharePointからこれらの情報を取得できます。

• プロジェクトのリダイレクトURI：
  • PROD：https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • APAC：https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • CA：https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  • EU：https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback

Microsoft Azure for OneDriveのセットアップ例

アプリケーションの登録

1. Microsoft Azure ポータルにログインしてください：https://azure.microsoft.com/en-us/account/
2. のAzure Active Directory（ ）サービスに移動します。
3. の「App Registrations」（ ）に移動し、「Manage」の下にある「」の「New Registration」（ ）をクリックしてください。
4. 「」のアプリケーション名「 」を入力し、を押して、「 」を登録します。

アプリケーション認証の構成

1. Microsoft Azure ポータルにログインしてください：https://azure.microsoft.com/en-us/account/
2. のAzure Active Directory（ ）サービスに移動します。
3. 「」の「アプリ登録」ページ（ ）に、「管理」メニューから移動します。
4. 更新された「管理」パネル内の「認証」 に移動します。
5. 「サポートされているアカウントの種類」で、任意の組織ディレクトリ内の「 アカウント（任意のMicrosoft Entra IDテナント - マルチテナント）」を選択します。 。
6. 「プラットフォームを追加」の下で、「Web 」を選択します。
7. 「」の「リダイレクトURI」欄（ ）に、上記で指定した有効なコールバックURLを入力してください。
8. 「」の「サポート対象のアカウントタイプ」（ ）の下にある、「MultiTenant」（ ）のチェックボックスを必ずオンにしてください。

メモ： OneDrive コネクターはマルチテナント オプションを有効にする必要があるため、アプリケーションがセキュリティ コンプライアンスのために正しく構成されていることを確認するのは Azure 管理者次第です。このオプションは、Azureセキュリティで正しく使用された場合、アプリケーションを誰にでも開放するものではない。以下は、その他のステップについての提案である。

• Microsoftの「」ドキュメント（ ）のうち、マルチテナント設定に関する部分を確認してください。
• 個々のアプリケーションでセキュリティ機能を有効にし、に記載されている Microsoft の手順に従って、アプリの利用対象を特定のユーザーグループに制限してください（ ）。
• に記載されている Microsoft の手順に従い、ユーザーおよびグループへのアプリの割り当て（ ）を行い、ユーザーにアプリケーションへのアクセス権を割り当てたり許可したりしてください。

証明書と秘密の設定

1. Microsoft Azure ポータルにログインしてください：https://azure.microsoft.com/en-us/account/
2. のAzure Active Directory（ ）サービスに移動します。
3. 「」の「 」管理画面から、「」アプリの登録（ ）へ移動してください。
4. 更新された「」の「 」管理パネルの下にある「Certificates」に移動します。
5. 中央のパネルにある「」の「New Client Secret」 をクリックします。
6. の概要 およびの有効期限 について簡単に説明した後、クライアントシークレットが表示されます。これは、安全に保管し、Microsoft OneDrive コネクタに入力するために保存しておく必要があります。

API権限の設定

1. Microsoft Azure ポータルにログインしてください：https://azure.microsoft.com/en-us/account/
2. のAzure Active Directory（ ）サービスに移動します。
3. 「」の「 」管理画面から、「」アプリの登録（ ）へ移動してください。
4. 更新された「」の管理パネル内の「API 権限」へ移動し、を開きます。
5. 「」をクリックし、中央のパネルで「」の権限を追加します。
6. の「Microsoft API」 にある「」の「Microsoft Graph」 を選択してください。
7. 「」のリクエストタイプとして、「Delegate Permissions 」を選択します。 。
8. 必要な権限の一覧は以下の通りです：
   User.Read 、FILES 以下のすべての項目 およびOpenId.offline_access 。
9. 「」の「Grant Admin Consent」をクリックしてください。 。
10. コネクターが使用するアクセス・レベルを定義します。 Microsoft OneDrive コネクタでは、
    以下ののスコープ がサポートされています。
    • Files.ReadWrite.Selected 
    • Files.ReadWrite.AppFolder 
    • Files.ReadWrite.All 
    • Files.ReadWrite 
    • Files.Read.Selected 
    • Files.Read.All 
    • Files.Read 
    • オフラインアクセス

少なくとも、、offline_access、 、scope の各設定が必要です。

Files.Read.All および Files.ReadWrite.All が必要な理由

Workiva OneDrive コネクタは、OAuth 委任権限を使用して Microsoft Graph API を通じてお客様の Microsoft 環境と通信します。つまり、このコネクタは認証済みユーザーに代わって認証を行い、操作を実行します。

Sites.Selected が使用できない理由

Sites.Selected は、アプリケーションレベル（アプリ限定）のアクセスフロー向けに設計された SharePoint 独自の権限であり、Workiva コネクタが使用する委任権限モデルとは互換性がありません。また、アクセスは事前に承認されたSharePointサイトのみに制限されるため、コネクタが「検索」、「項目のコピー」、「項目の削除」といった、パスに基づく動的な操作を実行できなくなります。

セキュリティの実現

1. Microsoft Azure ポータルにログインしてください：https://azure.microsoft.com/en-us/account/
2. のAzure Active Directory（ ）サービスに移動します。
3. 「」の「Manage」セクションにある「Enterprise Applications」 をクリックし、 を選択してください。
4. リストからアプリケーションを選択し、編集プロセスを開始します。お使いのアプリケーションがデフォルトで一覧に表示されていない場合は、「」の「All Applications」 をクリックしてください。この操作は、「」の「Manage」 から行えます。
5. 「」のプロパティをクリックし、の管理（Manage）にある「 」を選択し、 を開きます。
6. 「のプロパティ」 画面で、上記で作成したAPIアクセスの使用を許可するために、以下のプロパティを設定します。

   • ユーザーのサインインを有効にしましたか？ = はい

   • ユーザーの割り当てが必要ですか？ = はい

   • （オプション）ユーザーに表示しますか？ = いいえ

7. 「」の「Manage」セクションにある「Users and Groups」 をクリックし、「 」を選択してください。
8. 必要に応じて、標準の Azure AD プロセスを使用してユーザーを追加できるようになりました。  これ
   は、OneDrive の使用が許可されており、適切な Microsoft OneDrive ライセンスを保有しているユーザーのリストです。

Microsoft OneDriveコネクターの設定

注： 組織のチェーンでコネクターを使用できるようにするには、まず最初に組織のセキュリティ管理者が構成から コネクターを有効にする必要があります。

1. の「Chain Builder」（ ）から、「Connections」（）をクリックし、compare_arrows を選択してから、右上の「Create」（ ）をクリックします。
2. 「コネクタの接続」 において、「」および「Microsoft OneDrive」を選択し、デフォルトの「CloudRunner」を選択します。
   
3. 基本情報の下に、コマンドの識別をヘルプするユニークな名称と説明を入力します。
4. OAuth で、コネクターの Azure アプリケーションの OAuth クライアント ID とシークレットを入力します。
   
5. コネクターのアクセス レベルを決定するには、Azure アプリケーションの認証スコープ を入力します。
   少なくとも、の「offline_access」 スコープが必要です。
6. 接続と OAuth 認証情報を承認するには、Connect をクリックします。

7. [プロパティ]で、接続の詳細を入力します。
   

   プロパティ	詳細
   ドライブタイプ	ドライブ、グループ、ユーザー、サイトなど、接続するドライブのタイプ別を選択します。 自分のユーザードライブに 接続するには、[] → [Current User (Me)] → [] の順に選択してください。
   ドライブタイプID	ドライブタイプ に基づいて、接続するドライブのIDを入力します。たとえば、のドライブタイプ が「ユーザー」の場合はユーザーIDを、 「サイト」の場合はサイトIDを入力してください。

   注： MicrosoftのGraph Explorer（ ）を使用すると、SharePointからこれらの情報を取得できます。

8. 接続に使用する環境を選択し、保存します。
9. 接続をテストするには、 コネクターのファイルダウンロード コマンド でチェーン を作成・実行し、有効な出力を返すことを確認する。

トラブルシューティング

Microsoft OneDriveまたはSharePointへの接続に失敗した場合：

• コネクターの Azure アプリケーション OAuth 認証情報が存在し、正しく、有効であることを確認します。OAuthの認証情報には有効期限が設定されており、証明書の有効期限が切れている可能性があります。この場合、新規証明書を作成し、Connector に新規クライアントシークレットを入力する必要がある。 新しいシークレットの作成方法の詳細については、「証明書とシークレットの
  設定」 を参照してください。
• コネクターに入力されたドライブタイプとIDを確認する。MicrosoftのGraph Explorer（ ）を使用すると、SharePointからこれらの情報を取得できます。
• プロジェクトのリダイレクトURIを確認する：
  • PROD：https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • APAC：https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • CA：https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  • EU：https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback