Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

CDC 用に ServiceNow インスタンスを構成する

Datastream を使用すると、ServiceNow インスタンスから BigQuery や Cloud Storage などのサポートされている宛先にデータを複製できます。接続プロファイルを作成する前に、専用の統合ユーザーを設定し、基本認証または OAuth 2.0 認証を構成します。必要に応じて、Datastream IP アドレスを許可リストに登録します。

始める前に

Datastream で使用する ServiceNow の構成を開始する前に、次のものが揃っていることを確認してください。

アクティブな ServiceNow インスタンス（例: company.service-now.com）。
ServiceNow インスタンスの管理者権限。ユーザーの作成、ロールの割り当て、OAuth アプリケーションレジストリの管理を行います。
ServiceNow インスタンスのバージョンに関する知識。

統合ユーザーを構成する

ServiceNow では、新規ユーザーを作成するか、既存のアカウントの設定を調整して Datastream へのアクセスを許可できます。セキュリティと監査の目的で、専用の統合ユーザーを作成することを強くおすすめします。

ServiceNow で、[User Administration] > [Users] に移動します。
新しいユーザーを作成するには、[New] をクリックします。既存のユーザーを編集するには、ユーザーリストでユーザー ID を検索し、クリックしてレコードを開きます。
ユーザーの詳細を構成します。
- [ユーザー ID] フィールドに一意の名前（datastream_integration など）を入力します。ユーザー識別子を新規ユーザーにのみ設定する。
- コネクタに OAuth 認証を選択する場合は、[名] フィールドと [姓] フィールドに値を入力して、ユーザーレコードをより適切に識別することをおすすめします。
- ID 構成: ServiceNow プラットフォームのバージョンに基づきます。
  - Xanadu 以降: [Identity type] プルダウンで [Machine] を選択します。これにより、[Web service access only] が自動的に有効になります。
  - Xanadu より前: [Web service access only] チェックボックスをオンにします。
レコードを保存します。
- 新規ユーザーの場合は、[送信] をクリックします。
- 既存のユーザーの場合は、[更新] をクリックします。
新しいユーザーを作成した場合は、レコードを再度開きます。リストでユーザーを見つけ、[ユーザー ID] をクリックしてレコードオプションにアクセスします。
パスワードを設定します。
1. フォームのヘッダーで [Set Password] をクリックします。
2. 安全なパスワードを入力し、[Save Password] をクリックします。
3. コネクタに基本認証を使用する場合は、接続プロファイルの構成時に必要になるため、パスワードをメモしておきます。
権限を割り当てます。複製するすべてのテーブルに対する読み取りアクセス権を統合ユーザーに付与する必要があります。また、コネクタには、sys_db_object、sys_table_rotation、sys_dictionary のシステムメタデータテーブルに対する明示的な読み取り権限が必要です。

省略可: OAuth 2.0 クライアント認証情報を構成する

OAuth 2.0 は、Datastream で ServiceNow コネクタを使用する場合に最も安全で推奨される認証方法です。永続的なパスワードの代わりに、クライアント ID とクライアントシークレットを使用します。

インスタンスの OAuth 2.0 プラグインを有効にします。詳細については、ServiceNow のドキュメントをご覧ください。
com.snc.platform.security.oauth.is.active システムプロパティが true に設定されていることを確認します。詳細については、ServiceNow のドキュメントをご覧ください。
glide.oauth.inbound.client.credential.grant_type.enabled システムプロパティが true に設定されていることを確認します。詳細については、ServiceNow のドキュメントをご覧ください。
インバウンド OAuth 構成を設定します。インスタンスのセキュリティ要件に応じて、次のいずれかの OAuth 構成スコープを選択できます。
- 広範なスコープ: 広範なスコープの OAuth を使用する場合、トークンベアラーは関連付けられたユーザーロールとアクセス制御リスト（ACL）を継承します。
- きめ細かい REST API 認証スコープ: このタイプの OAuth 構成では、関連付けられたユーザーロールと ACL に加えて、スコープで許可されている特定の REST API とメソッドに制限されます。
OAuth 統合レコードを作成します。詳細については、ServiceNow のドキュメントをご覧ください。
- Zurich プラットフォームバージョン以降の場合
- Zurich より前のプラットフォームバージョンの場合
OAuth 統合レコードを作成した後の構成は、プラットフォームのバージョンと OAuth スコープによって異なります。
- 広範な構成:
  - Zurich 以降: 統合レコードの [Auth scope] セクションで、[Auth scope] フィールドまたは [Limit authorization to the following APIs] フィールドにエントリがないこと、[Allow access only to APIs in selected scope] チェックボックスがオフになっていることを確認します。
  - チューリッヒ以前: [スコープの制限] プルダウンで [広範なスコープ] を選択し、[Auth スコープ] リストを空のままにします。
- きめ細かい REST API Auth スコープ構成: 必要に応じて、Auth スコープを使用して、トークンベアラーをスコープで許可されている特定の REST API とメソッドにさらに制限します。Datastream コネクタには、Table API への GET アクセスのみが必要です。プラットフォームのバージョンに応じて、次の手順を行います。
  - Zurich 以降: 統合レコードの [Auth scope] セクションで、認可スコープを選択し、Table API へのアクセスを制限します。
    
    注: 統合レコードの編集時に認可スコープを作成すると、デフォルトで、スコープは Table API のすべての API メソッドにアクセスできます。GET メソッドのみにアクセスを制限するには、[System Web Services] > [API Auth Scopes] > [REST API Auth Scope] に移動して、新しく作成されたレコードを手動で編集する必要があります。
  - チューリッヒ以前:
    1. 選択した認可スコープの Table API へのアクセスを制限します。詳細については、ServiceNow のドキュメントをご覧ください。
    2. [認証スコープ] セクションにスコープを追加します。
    3. [スコープ制限] ボックスで [安全なスコープ] を選択します。

省略可: IP アドレスのアクセス制御を構成する

ServiceNow インスタンスで IP アドレスアクセス制御を使用している場合は、Datastream IP アドレスを明示的に許可リストに登録する必要があります。

次の手順は、Datastream の IP アドレスを対象とする IP アドレスアクセス制御 DENY ルールがある場合にのみ必要です。デフォルトでは、インスタンスへのアクセスに IP 制限はありません。

ServiceNow で、[System Security] > [IP アドレスアクセス制御] に移動します。
[New] をクリックします。
レコード作成フォームで、次の設定を適用します。
1. [タイプ] プルダウンで、[許可] を選択します。
2. [方向] プルダウンで、[インバウンド] を選択します。
3. [範囲の開始] フィールドと [範囲の終了] フィールドに、Datastream の IP アドレスのリストから特定の IP アドレスまたはアドレス範囲を入力します。
4. [Active] チェックボックスがオンになっていることを確認します。
[送信] をクリックします。
Datastream アドレスのリストにある IP アドレスごとに、上記の手順を繰り返します。

次のステップ

ServiceNow ソースの詳細を確認する。