SharePointコネクタの使用
SharePointコネクタを使用すると、特定のSharePointサイト上のファイルとリストにアクセスすることができます。以下のオペレータを使用することができます。
- Read SharePoint
- Write SharePoint
- Delete SharePoint
- Loop SharePoint
- Read List SharePoint
このドキュメントでは、以下の方法について説明します。
Microsoftアカウントへの接続
SharePointサービスにアクセスするには、Microsoftとのアプリケーション接続を設定する必要があります。これにはいくつかの手順があり、最後に、すべてのSharePointオペレータの入力として必要なSharePoint接続を作成するための認証情報が得られます。これらの手順では、ユーザー固有の選択が必要ですが、全体的なワークフローといくつかのヒントをここで説明します。
接続はv1.0エンドポイントを使用するMicrosoftのGraph APIに基づいています。Graph APIに関する詳細は、https://developer.microsoft.com/en-us/graphを参照してください。
- 会社のActive Directoryアカウント(SharePoint、Outlook、またはその他のOffice365サービスにアクセスするために使用)でMicrosoft Azure Portalのhttps://portal.azure.comにログインします。
- App Registrationsを検索し、New registrationをクリックします。アプリケーションの名前を入力し、WebタイプのリダイレクトURI「https://localhost」を指定します。
- アプリケーションの作成中に、ハッシュ文字列であるクライアントシークレットがシステムから提供されます。これは接続に必要なので、保存しておいてください。後で証明書とシークレットから新規シークレットを作成できます。
- アプリ作成時に、Access tokensとID tokensの2つのチェックボックスを有効にしてください。後でAuthenticationで編集できます。
権限付与
アプリを作成したら、APIレベルの権限を付与する必要があります。左側のパネルでAPI permissionsリンクをクリックします。Microsoft Graph APIの階層が表示されます。
Application Flowの場合、Application permissionsを選択し、少なくとも以下の権限を付与します。
- Application.ReadWrite.All
- Application.ReadWrite.OwnedBy
- Device.ReadWrite.All
- Directory.Read.All
- Directory.ReadWrite.All
- Domain.ReadWrite.All
- Sites.Manage.All
- Sites.Read.All
- Sites.ReadWrite.All
- User.Read.All
OAuth 2.0 Delegated Flowの場合、Delegated permissionsを選択し、少なくとも以下の権限を付与します。
- AllSites.Manage
- AllSites.Read
- AllSites.Write
- MyFiles.Read
- MyFiles.Write
- Project.Read
- Project.Write
アプリが作成されたら、アプリの名前をクリックします。Connectionに必要なプロパティが表示されます。
- アプリケーション(クライアント) ID、および
- ディレクトリ(テナント) ID
管理者はアカウントを承認する必要があります。承認はこのURLを開き、表示されるメッセージに従って行います。URLは次の形式で作成できます。
https://login.microsoftonline.com/<YOUR_DIRECTORY_TENANT_ID>/adminconsent?client_id=<YOUR_APPLICATION_CLIENT_ID>
山かっこで囲まれたプレースホルダーの以前に取得した値が必要です。
SharePointサイトは、SharePoint URLに表示されます。URLが以下の場合、
https://company.sharepoint.com/sites/onboarding
以下の通りです。
- SharePointのURLはcompany.sharepoint.comです。
- SharePoint Siteはonboardingです。
承認が完了すると、接続を使用できるようになります。
