Microsoft SharePoint Online Spoke の設定方法Summary<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } この記事では、Microsoft SharePoint Online Spoke を設定する方法をステップバイステップで説明します。 設定に進む前に、Microsoft SharePoint Online Spoke のすべてのアクションを使用するには、2 つの Connection & Credential Alias を構成する必要があることを理解しておく必要があります。ドキュメントを参照してください: スポークのアクション SharePoint Online Connection & Credential AliasSharePoint Graph Connection & Credential Alias 注意: SharePoint Online は複数テナントをサポートしていません。複数テナントを使用する場合は、Microsoft SharePoint Graph Connection Alias のみを使用できます。 Release<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } すべて Instructions<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } > Integration Hub プラグイン (Integration Hub Professional Package) がインストールされていることを確認します。 > Microsoft SharePoint Online Spoke をインストールします。 1) Microsoft SharePoint Graph Connection を構成する : ドキュメントを参照してください : Microsoft SharePoint Graph Connection 1.Microsoft Azure にアプリケーションを登録する。 a.https://portal.azure.com/にログインします。 b.App registrations を選択します。 c. App registrations ページで + New registration を選択します。 d. フォームに入力します。 e. Register を選択します。 OAuth アプリが登録されました。OAuth アプリケーションが登録されます。 2. アプリケーション ID を取得するには、OAuth アプリケーションページから Application (client) ID をコピーします。 Microsoft SharePoint Graph および Microsoft SharePoint Online の Connection レコードを設定する際に、Application (client) ID が必要になります。 3. Client Secret を取得します。 a. OAuth アプリケーションページで Certificates & secrets を選択します。 b. + New client secret を選択します。 c. Client Secret を設定します。 注: Microsoft SharePoint Graph の Connection レコードを設定する際に Client Secret が必要です。 d. Add を選択します。Client Secret が生成されます。 e. Secret をコピーし、安全な場所に保管します。 4. Redirect URI Overview の下で、右側にある Redirect URI をクリックし、ServiceNow URL を入力します。 https://<servicenowinstanceurl>/oauth_redirect.do 5. 左ペインの Manage セクションで API permissions を選択します。 a. Configured permissions の下で + Add a permission を選択します。 b. Request API permissions ウィンドウで Microsoft Graph を選択します。 c. Delegated permissions を選択します。 d. Select permissions の下で検索フィールドに site と入力します。 e. Sites リストを展開します。 f. Sites.Read.All および Sites.ReadWrite.All を選択します。 g. Select permissions の下で検索フィールドに User.read と入力します。 h. Add permissions を選択します。 権限が追加されます。 i. 管理者の同意を付与するには、Configured permissions の下で Grant admin consent を選択します。 j. Yes を選択します。 Sites.Read.All 権限の Admin consent required 列の値が Yes の場合、管理者の同意は必須です。 >> 上記の手順で、Azure 側での SharePoint Graph Spoke の設定は完了です。次に erviceNow インスタンスで構成します。 ServiceNow インスタンスにログインします。All > Process Automation > Flow Designer に移動します。Connections タブをクリックします。MicrosoftSharePointGraph カードで View Details をクリックします。Configure をクリックします。 6.フォームに入力します。 ここでは、以前作成した Azure App から取得した Client ID、Client Secret、Tenant ID を使用します。 Edit and Get OAuth Token をクリックしてトークンを取得します。 Scope は次のような形式である必要があります。 offline_access https://graph.microsoft.com/.default 7. Microsoft Graph アクションを使用するために、ServiceNow インスタンスの Tenant テーブル (sn_sp_spoke_tenant) にレコードを作成します。 これで SharePoint Graph の設定は完了です。SharePoint Graph Connection & Credential Alias レコードを使用してアクションをテストする準備が整いました。 2) Microsoft SharePoint Online Connection レコードを構成する : ドキュメントを参照してください。 Microsoft SharePoint Online Connection 2 つの証明書を生成する必要があります。 (.PFX。Washington から Vancouver までは .JKS と .CER も使用できます。) 手順 1. マシンでターミナルを開きます。 2. スクリプトを実行します。 keytool -genkey -alias selfsigned -keyalg RSA -keypass <keypassword> -storepass <keystorepass> -keystore Keystore.jks -keysize 2048 -validity 1461 Keystore からいくつかの情報の入力が求められます。 3. 画像の例に従って独自の情報を入力します。 4. Return キーを押します。 5. 次のスクリプトを実行します。 keytool -export -keystore keystore.jks -alias selfsigned -file ketstore.cer 6.ソース Keystore のパスワードを入力します。(最初のコマンドで設定したパスワード) >>これで、2つのファイル(keystore.pfx および ketstore.cer)が準備できました。 次に、Azure ポータルに移動します。 7. Certificates & Secrets >> Certificates >> Upload Certificate に移動します。 左ペインの Manage セクションで Certificates & secrets を選択します。 Certificates & secrets の下で Certificates を選択します。 Upload certificate を選択します。Upload certificate ウィンドウでフォルダーアイコンを選択し、生成した .cer ファイルを指定します。Description フィールドに証明書の説明を入力します。Add を選択します。証明書がアップロードされます。 8. Thumbprint 列の値をコピーし、安全な場所に保管します。 注: Thumbprint の値全体をコピーしてください。 または Manifest をクリックして Thumbprint をコピーすることもできます。 9. Thumbprint 値を Base64 値にエンコードし、その値を後で使用できるよう記録します。 注: Hexadecimal to Base64 (Hex to Base64) 変換ツールを使用して Thumbprint 値を Base64 値に変換できます。 https://base64.guru/converter/encode/hex 10. Spoke がアクションを自動化するために必要な REST API アクセス権限を取得します。 a. 左ペインの Manage セクションで API permissions を選択します。 b. Configured permissions の下で + Add a permission を選択します。 c. Request API permissions ウィンドウで SharePoint を選択します。 d. Application permissions を選択します。 e. Sites リストを展開します。 f. Sites.FullControl.All を選択します。 これにより、ServiceNow インスタンスは Microsoft SharePoint Online 内のすべてのサイトに対する完全な制御権を持ちます。 g. Add permissions を選択します。 権限が追加されます。 h. 管理者の同意を付与するために、Grant admin consent for ServiceNow を選択します。 i. 確認ウィンドウで Yes を選択します。 管理者の同意が付与されます。 11. Azure アプリの構成はこれで完了です。次に ServiceNow インスタンスへ移動します。 System Definition > Certificates に移動します。Microsoft SharePoint Online Certificate レコードを開きます。 注: 必ずデフォルトレコードの Microsoft SharePoint Online Certificate を使用してください。 Key store password に pfx ファイル用のパスワードを入力します。(PFX ファイル生成時に設定したパスワード)添付ファイルアイコンをクリックし、生成した JKS 証明書を添付します。Validate Stores/Certificates をクリックします。Update をクリックします。 12. JWT Signing Key を構成します。 System OAuth > JWT Keys に移動します。Microsoft SharePoint Online JWT Keys レコードを開きます。Signing Key Password に、.PFX ファイルおよび .CER ファイル生成時に使用した秘密鍵の暗号化パスワードを入力します。Update をクリックします。 13.JWT プロバイダーを構成します。 注: Azure Portal で登録したアプリケーションの Application (client) ID と Directory (tenant) ID の値をコピーして記録します。 System OAuth > JWT Providers に移動します。Microsoft SharePoint Online JWT Provider レコードを開きます。Standard Claims 関連リストで iss、sub、および aud の値を入力します。 Aud (audience): Azure で Endpoints をクリックし、「OAuth 2.0 token endpoint (v1)」の値をコピーします。 https://login.microsoftonline.com/83d47a61-9880-4b17-afb7-5297a1f5dd54/oauth2/token Iss: Azure Portal で登録したアプリケーションの Application (client) ID Sub: Azure Portal で登録したアプリケーションの Application (client) ID d. Update をクリックします。 14. Microsoft SharePoint Online を OAuth Provider として登録する Microsoft SharePoint Online アカウント構成時に生成した情報を使用して、Microsoft SharePoint Online を OAuth Provider として登録し、インスタンスが OAuth 2.0 トークンを要求できるようにします。 System OAuth > Application Registry に移動します。New をクリックします。What kind of OAuth application? というメッセージが表示されます。Connect to a third party OAuth Provider を選択します。空の Application Registries フォームが表示されます。次の値を入力します。 Authorization URL は入力不要です。 Token Revocation URL も必須ではありません。 OAuth Entity Scopes 関連リストで次の値を持つレコードを挿入します。 Scope: https://<MS-SharePoint-tenant-name>.sharepoint.com/.default フォームヘッダーを右クリックし、Save をクリックします。 システムが OAuth 資格情報を検証し、OAuth Entity Profiles 関連リストを作成します。 15. Microsoft SharePoint Online Spoke 用の Credential レコードを作成する Microsoft SharePoint Online アカウント構成時に作成した Microsoft SharePoint Online カスタム OAuth アプリケーション用の Credential レコードを作成します。Microsoft SharePoint Online Spoke の Connection & Credential Alias は、これらの資格情報を使用してアクションを認証します。 Connections & Credentials > Connection & Credential Aliases に移動します。MicrosoftSharePointOnline の Connection & Credential Alias レコードを開きます。Connections タブで New をクリックします。フォームに入力します。(ここでは Credential レコードも作成し、前述で作成した OAuth アプリケーションを指定する必要があります) e. Attributes タブで、Thumbprint の Base64 エンコード値を入力します。 注: Thumbprint の値は 16 進数です。Hexadecimal to Base64 (Hex to Base64) 変換ツールを使用して Base64 値に変換できます。 f. Submit をクリックします。 Microsoft SharePoint Online アカウントが ServiceNow インスタンスと統合され、Spoke を使用できる状態になります。 Microsoft SharePoint Online アクションを使用するには、ServiceNow インスタンスの Tenant テーブル (sn_sp_spoke_tenant) にレコードを作成します。 Tenant の設定についてはドキュメントを参照してください: Define Microsoft SharePoint Online tenants 注意: 2 つの Connection & Credential Alias レコードを作成しているため、それらの Alias を関連付けるために Tenant テーブル内にも 2 つの Tenant を作成する必要があります。複数の Tenant を作成する場合は、異なる Tenant 用のすべての Alias を sn_sp_spoke_tenant テーブルに追加する必要があります。 これで Microsoft SharePoint Online Spoke の設定は正常に完了です。 Related Links<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } Microsoft SharePoint Online Spoke を見つけて SharePoint 統合に使用したいと考えていますが、Spoke のセットアップに Sites.FullControl.All 権限が必要なため、セキュリティチームが使用を許可していません。 権限の詳細については、こちらを参照してください: Microsoft SharePoint Online スポークの権限について