Apple Messages for Business の OAuth セットアップ
OAuth2 認証を使用して、ID プロバイダー (IdP) を Apple Messages for Business と統合します。
Apple Messages for Business を ServiceNow® インスタンスにコネクトする
Apple Messages for Business サイトで次の手順を実行して、Apple Messages for Business アカウントを ServiceNow® インスタンスにコネクトします。
- Apple Messages for Business ページ (register.apple.com) に移動し、Messages for Business アカウントにログインします。
- [統合 OAUTH2 認証 (Integrated OAuth2 Authentication)] セクションに移動します。
- ID プロバイダー (IdP) からの認証 URL を [OAuth URL] フィールドに追加します。
- IdP のトークン URL を [トークン URL] フィールドに追加します。
- IdP のクライアント ID を [クライアント識別子 (Client Identifier)] フィールドに追加します。
- を参照してください Apple ドキュメント Apple Messages for Business アカウントで OAuth2 認証を構成する詳細な手順については、以下を参照してください。
ServiceNow® インスタンスで OAuth を設定する
- ServiceNow® インスタンスに移動して、OAuth を設定します。
- 次の手順を使用して、アプリケーションレジストリー (oauth_entity) テーブルに新しいレコードを作成します：「Use a third-party OAuth provider」。
- 権限許可タイプ [認証コード] を使用します。
- トークン URL を追加します。
- 次の手順を使用して、[OAuth エンティティスコープ] (oauth_entity_scope) テーブルに新しいレコードを作成します：「Specify an OAuth scope」。複数のスコープがある場合は、スコープごとに新しいレコードを追加し、スコープごとに対応するエンティティプロファイルスコープレコードを作成します。
- 次の手順を使用して、接続および資格情報エイリアス (sys_alias) テーブルに新しいレコードを作成します：「Create a Connection & Credential alias」。この接続エイリアスは、次のステップで作成する http 接続レコードを取得するために使用されます。
- 次の手順を使用して、HTTP(s) 接続 (http_connection) テーブルに新しいレコードを作成します：「Create an HTTP(s) connection」。
- 接続のタイプ - [HTTP(S) 接続] を選択
接続エイリアスを、前のステップで作成した sys_alias レコードに設定します。
- 接続 URL を設定し、IdP に従って、ユーザー情報 API を取得します。(例： https://<your-idp-app>.com/api/v1/users)
- ワークフロースタジオを使用してプロファイルパーサーアクションを作成します。例については、次に示すコードスニペットを参照してください：「Apple Messages for Businessのプロファイルパーサーアクションの作成」。詳細については、「Building actions」を参照してください。
- 次の手順を使用して、[プロバイダーアプリケーション認証] (sys_cs_provider_app_authentication) テーブルに新しいレコードを作成します。
- プロバイダーチャネル ID をプロバイダーアプリ (sys_cs_provider_application) に設定します。
- OAuth エンティティプロファイルを OAuth プロバイダー (oauth_entity) レコードで作成された oauth_entity_profile レコードに設定します。
プロファイル API 接続を、前に作成した http_connection レコードに設定します。
- プロファイル応答パーサーアクションを、定義した sys_hub_action_type_definition レコードに設定します。