Apple Messages for Business の OAuth セットアップ

OAuth2 認証を使用して、ID プロバイダー (IdP) を 業務用 Apple Messages と統合します。

業務用 Apple Messages を ServiceNow® インスタンスに接続する

業務用 Apple Messages サイトで次の手順を実行して、業務用 Apple Messages アカウントを ServiceNow® インスタンスに接続します。

1. 業務用 Apple Messages ページ (register.apple.com) に移動し、Messages for Business アカウントにログインします。
2. [統合 OAUTH2 認証 (Integrated OAuth2 Authentication)] セクションに移動します。
3. ID プロバイダー (IdP) からの認証 URL を [OAuth URL] フィールドに追加します。
4. IdP のトークン URL を [トークン URL] フィールドに追加します。
5. IdP のクライアント ID を [クライアント識別子 (Client Identifier)] フィールドに追加します。
6. 次を参照してください。 Apple ドキュメント アカウントで OAuth2 認証 業務用 Apple Messages を構成する詳細な手順については、こちらをご覧ください。

ServiceNow® インスタンスで OAuth を設定する

1. ServiceNow® インスタンスに移動して、OAuth を設定します。
2. 次の手順を使用して、アプリケーションレジストリー (oauth_entity) テーブルに新しいレコードを作成します：「Use a third-party OAuth provider」。
   • 権限許可タイプ [認証コード] を使用します。
   • トークン URL を追加します。
3. 次の手順を使用して、[OAuth エンティティスコープ] (oauth_entity_scope) テーブルに新しいレコードを作成します：「Specify an OAuth scope」。複数のスコープがある場合は、スコープごとに新しいレコードを追加し、スコープごとに対応するエンティティプロファイルスコープレコードを作成します。
4. 次の手順を使用して、接続および資格情報エイリアス (sys_alias) テーブルに新しいレコードを作成します：「Create a Connection & Credential alias」。この接続エイリアスは、次のステップで作成する http 接続レコードを取得するために使用されます。
5. 次の手順を使用して、HTTP(s) 接続 (http_connection) テーブルに新しいレコードを作成します：「Create an HTTP(s) connection」。
   • 接続のタイプ - [HTTP(S) 接続] を選択
   接続エイリアスを、前

   • のステップで作成した sys_alias レコードに設定します。

   • 接続 URL を設定し、IdP に従って、ユーザー情報 API を取得します。(例： https://<your-idp-app>.com/api/v1/users)
6. アクションデザイナーを使用してプロファイルパーサーアクションを作成します。例については、次に示すコードスニペットを参照してください：「業務用 Apple Messagesのプロファイルパーサーアクションの作成」。詳細については、「Building actions」を参照してください。
7. 次の手順を使用して、[プロバイダーアプリケーション認証] (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 レコードに設定します。