SharePoint ​

SharePointは、Microsoft Officeと統合されたWebベースのコラボレーション、ドキュメント管理、ストレージシステムです。主にドキュメント管理とストレージに使用されますが、高度な設定が可能で、利用状況は組織によって大きく異なります。

WorkatoのSharePointコネクターを使用すると、SharePointおよびその他のサードパーティアプリケーションを中心とした連携と自動化を構築できます。

APIバージョン ​

SharePointコネクターはSharePoint REST API v1を使用します。

SharePointへの接続方法 ​

SharePointをWorkatoに接続するには、Azureアカウントが必要です。 Workatoは次の認証方法をサポートしています。

• Authorization code grantコネクション
• Client credentials grantコネクション

Authorization code grantコネクション ​

この方法には、次のフィールドが必要です:

• Subdomain
• Client ID（任意）
• Client Secret（任意）

Azure PortalでWorkatoアプリを登録 ​

次の手順を実行してWorkatoアプリを登録し、Authorization code grantコネクション用のClient IDとシークレットを生成します。

https://www.workato.com/oauth/callback

これらの手順が完了したら、Azure Portalで設定したAPI権限を使用して、WorkatoでSharePointコネクションを設定します。

Workatoでセットアップを完了する ​

Client credentials grantコネクション ​

この方式には、次の値が必要です:

• Subdomain
• API Scope
• Tenant ID
• Client ID
• 証明書
• Private Key

Azure PortalでWorkatoアプリを登録 ​

次の手順を実行してWorkatoアプリを登録し、Client credentials grantコネクションに必要な値を取得します。

https://www.workato.com/oauth/callback

openssl genrsa -out domain.key 2048

openssl req -key domain.key -new -out domain.csr

openssl x509 -signkey domain.key -in domain.csr -req -days 365 -out domain.crt

Workatoに戻り、コネクションの設定を完了します。

Workatoで設定を完了 ​

Azure Portalでアプリを設定した後、WorkatoでSharePointコネクションを作成するには、次の手順を実行します。

接続に必要な権限 ​

コネクションを作成する前に、Azure Portal で Workato アプリに正しい SharePoint REST API の権限を割り当てる必要があります。必要なスコープは認証タイプによって異なります。

認可コードグラントコネクションの最小スコープ ​

認可コードグラント認証を使用して SharePoint にコネクションを確立するには、次の最小スコープが必要です。

• Sites.Selected (Delegated)

Sites.Selected権限だけでは、アプリに対していずれのサイトへのアクセスも付与されません。利用する予定の各サイトについて、SharePoint管理者またはグローバル管理者がアプリへのアクセスを付与する必要があります。詳細については「Grant site access for Sites.Selected」を参照してください。

Authorization code grantコネクションの推奨スコープ ​

Authorization code grantコネクションには、次のスコープを推奨します。これらのスコープは、このコネクターのすべてのトリガーとアクションを使用するために必要です。さらに、Azure Portalでこれらの権限をDelegated権限としてWorkatoアプリに割り当てる必要があります。

• AllSites.Write (Delegated)

Client credentials grantコネクションの最小スコープ ​

Client credentials grant認証を使用してSharePointへのコネクションを確立するには、次の最小スコープが必要です。

• Sites.Selected (Application)

Sites.Selected権限だけでは、アプリに対していずれのサイトへのアクセスも付与されません。利用する予定の各サイトについて、SharePoint管理者またはグローバル管理者がアプリへのアクセスを付与する必要があります。詳細については「Grant site access for Sites.Selected」を参照してください。

Client credentials grantコネクションの推奨スコープ ​

Client credentialsコネクションには、次のスコープを推奨します。これらのスコープは、SharePointコネクターのすべてのトリガーとアクションを使用するために必要です。さらに、Azure Portalでこれらの権限をApplication権限としてWorkatoアプリに割り当てる必要があります。

• Sites.ReadWrite.All (Application)

Microsoft Entra IDをSharePointコネクターに接続 ​

Microsoft Entra IDアカウントを使用してSharePointコネクターに接続するには、すべての同意要求が管理者によって付与されていることを確認してください。

管理者アカウントを使用して管理者の同意を付与するには、次の手順を実行します。