ServiceNow を Google SecOps と統合する

このドキュメントでは、ServiceNow を Google Security Operations（Google SecOps）と統合する方法について説明します。

ユースケース

ServiceNow の統合では、Google SecOps の機能を使用して、次のユースケースをサポートしています。

  • 自動インシデント チケット発行: SIEM やその他のセキュリティ ツールから発生したセキュリティ通知から ServiceNow インシデントを自動的に作成します。

  • インシデントの拡充と対応: 手動でのチケット発行を減らし、元の通知から関連情報をインシデントに拡充することで、インシデント対応ワークフローを効率化します。

  • フィッシングの修復: メールのヘッダーの収集、添付ファイルの調査、類似メールの検索など、繰り返されるフィッシング調査手順を自動化して、対応時間を短縮します。

  • 脆弱性修復のオーケストレーション: 脆弱性スキャンの結果に基づいて、パッチ適用または緩和アクションの ServiceNow 変更リクエストを自動的に作成することで、脆弱性修復ワークフローをオーケストレートします。

  • ユーザー ライフサイクルの自動化: ServiceNow ワークフローのトリガーに基づいて、さまざまなシステム（アクセス制御、メール プラットフォーム、アプリケーション）でユーザーのプロビジョニングとプロビジョニング解除のタスクを自動化します。

  • 脅威インテリジェンスのコンテキスト: ServiceNow プラットフォームから直接取得した脅威インテリジェンス データでセキュリティ通知を拡充し、アナリストが対応アクションの優先順位を付けるためのコンテキストを増やします。

始める前に

Google SecOps プラットフォームで統合を構成する前に、次の前提条件を完了していることを確認してください。

  • ServiceNow ユーザー アカウント: ターゲット レコードのクエリ、作成、更新を行うための十分な権限を持つ専用のユーザー アカウント。
  • ServiceNow ロール: アカウントに必要なシステムロール（sn_incident_write と itil）と、ジャーナル コメントの読み取りアクセスを許可するカスタム ユーザー アクセス構成があることを確認します。
  • ネットワーク接続: Google SecOps IP アドレスまたはリモート エージェント インフラストラクチャからのトラフィックが ServiceNow インスタンス エンドポイントに到達できるようにするネットワーク構成。
  • 認証の詳細: 組織の認証ポリシーを決定します。認証には、標準の基本認証または OAuth 2.0 認証を使用できます。

ServiceNow でユーザー アクセスを構成する

統合でコメントの同期、フィールドの更新、アクションのシームレスな実行を可能にするには、ServiceNow プラットフォームで次の管理タスクを実行する必要があります。

ServiceNow インターフェースの操作方法については、公式の ServiceNow プロダクト ドキュメントをご覧ください。

  1. カスタムロールを作成する: [Roles] > [New] に移動し、API コメント アクセスの処理専用の新しいロールを作成します。
  2. 新しいアクセス制御リスト（ACL）ルールを作成する: 統合では、コメントと作業メモを追跡するために、sys_journal_field テーブルへの読み取りアクセス権が必要です。[アクセス制御] > [新規] に移動します。このルールを作成するには、昇格された権限を持つアカウントでログインする必要があります。

  3. ACL パラメータを構成する:

    • [Type] を record に設定します。
    • [オペレーション] を read に設定します。
    • [Name] フィールドで、最初のプルダウンから [Journal Entry sys_journal_field] を選択し、2 番目のプルダウンから [-- None --] を選択します。
    • フォームの下部にある [Requires role] リストに移動し、新しく作成したカスタム コメントロールを追加します。[送信] をクリックします。

  4. 統合アカウントにロールを割り当てる: [ユーザー] に移動し、専用の統合アカウントを開いて、次のロールを付与します。

    • コメントを読み取るために作成したカスタムロール。
    • sn_incident_write: インシデントの取得やインシデントの更新などの基本的な操作に必要です。
    • itil: CMDB アクションと関連するアセット構成管理のルックアップ機能に必要です。

認証構成オプション

ServiceNow 統合では、3 つの異なる認証方法がサポートされています。組織のセキュリティ要件に沿って、次のいずれかの構成オプションを選択します。

オプション 1: OAuth 2.0 クライアント認証情報フロー（推奨）

この方法では、OAuth 2.0 クライアント認証情報付与とユーザーのなりすましを使用して、静的なユーザー パスワードをプラットフォームに公開することなく、データアクセスを安全に制限します。

フェーズ 1: ServiceNow で OAuth エンドポイントを作成する

  1. ServiceNow のナビゲーション メニューで [Application Registries] を検索し、[New] をクリックします。
  2. [New Inbound Integration Experience] を選択します。
  3. 接続タイプの一覧から [OAuth - Client credentials grant] を選択します。
  4. [名前] フィールドに、エンドポイント構成のわかりやすい名前を入力します。
  5. ID プロファイルのコンテキストを確立するために必要な OAuth プロバイダの名前または識別子を指定します。
  6. [OAuth application user] フィールドで、すべての自動 API アクティビティでなりすましに使用される専用の ServiceNow ユーザー アカウントを選択します。
  7. [送信] または [保存] をクリックします。
  8. 新しく作成したレジストリ レコードを再度開き、生成されたクライアント ID とクライアント シークレットをコピーして安全に保管します。

フェーズ 2: Google SecOps 内で構成する

  1. Google SecOps で、[Automation] > [Integrations Setup] に移動し、ServiceNow 構成ウィンドウを開きます。
  2. [API ルート] を入力します（デフォルトのプレースホルダ ドメインを実際の ServiceNow インスタンス URL に置き換えます）。
  3. フェーズ 1 で生成されたクライアント ID とクライアント シークレットを指定します。
  4. [ユーザー名]、[パスワード]、[更新トークン] の各フィールドが完全に空白になっていることを確認します。
  5. [Use Oauth Authentication] チェックボックスの設定を有効にします。
  6. [Test] をクリックして、接続 ping テストを使用してパラメータを検証します。成功した場合は、[保存] をクリックします。

オプション 2: 基本認証

この方法では、認証情報の直接検証を使用します。設定は簡単ですが、企業が多要素認証（MFA）を適用している場合や、基本認証ヘッダーをブロックしている場合は、制限されることがあります。

  1. ServiceNow で、統合ユーザーにローカルのユーザー名とパスワードがあることを確認します。
  2. Google SecOps で統合を構成するときに、[Api Root]（デフォルトのプレースホルダ ドメインを実際の ServiceNow インスタンス URL に置き換えます）、[Username]、[Password] を指定します。
  3. OAuth 関連のフィールドは空白のままにし、Use Oauth Authentication がオフになっている（チェックボックスがオフになっている）ことを確認します。
  4. [テスト] をクリックして、接続パラメータを検証します。成功したら、[保存] をクリックします。

オプション 3: 更新トークン フロー

組織で、更新トークン チェーンを使用して OAuth セキュリティ制御を必要とし、バックグラウンドでアクセス トークンをプログラムで取得する場合は、この方法を使用します。

  1. ServiceNow インスタンスでフェーズ 1 を完了して、クライアント ID とクライアント シークレットを生成します。
  2. 更新トークンを生成するセクションの手順を完了して、有効な認証トークン文字列を取得します。
  3. Google SecOps で、ServiceNow 統合インスタンスの構成ウィンドウを開きます。
  4. 構成済みの認証情報を使用して、パラメータを完全に入力します。
    • API ルート（デフォルトのプレースホルダ ドメインを実際の ServiceNow インスタンス URL に置き換えます）。
    • ユーザー名
    • パスワード
    • クライアント ID
    • クライアント シークレット
  5. [Use Oauth Authentication] チェックボックスをオンにします。
  6. 更新トークンを生成するセクションのワークフローから取得したトークン文字列を [更新トークン] フィールドに貼り付けます。
  7. [テスト] をクリックして、接続パラメータを検証します。成功したら、[保存] をクリックします。

更新トークンを生成する（Google SecOps）

更新トークンを生成するには、ヘルパー アクションを実行するように統合を一時的に構成する必要があります。

  1. Google SecOps で、[Automation] > [Integrations Setup] に移動します。
  2. この初期設定手順では、[Use Oauth Authentication] チェックボックスがオフになっていることを確認します。
  3. API ルート、ユーザー名、パスワード、クライアント ID、クライアント シークレットを使用して、一時的な ServiceNow 統合インスタンスを構成し、[保存] をクリックします。
  4. ケースをシミュレートするか、既存のケースを開きます。
  5. ケースに対して ServiceNow の [Get Oauth Token] アクションを手動で実行します。
  6. アクションの JSON 結果から refresh_token 値をコピーして、最終的な統合インスタンスを構成するときに [更新トークン] フィールドで使用します。

統合のパラメータ

ServiceNow の統合には、次のパラメータが必要です。

パラメータ 説明
Api Root

必須。

ServiceNow インスタンスの API ルート。

デフォルト値は https://INSTANCE.service-now.com/api/now/v1/ です。
Username

必須。

ServiceNow アカウントのユーザー名。
Password

必須。

ServiceNow アカウントのパスワード。
Incident Table

省略可。

インシデント関連のアクションとレコードの取得に使用する API テーブル名またはパス。

デフォルトでは、統合は table/incident パスを使用します。
Verify SSL

省略可。

選択すると、統合は ServiceNow サーバーに接続するときに SSL 証明書を検証します。

デフォルトで有効になっています。
Client ID

省略可。

ServiceNow 統合のクライアント ID。クライアント認証情報を使用した OAuth 2.0 認証に必要です。

認証には、更新トークンまたはクライアント認証情報のいずれかを使用できます。更新トークンとクライアント認証情報の両方が構成されている場合、統合は認証に更新トークンを使用します。
Client Secret

省略可。

ServiceNow 統合のクライアント シークレット。クライアント認証情報を使用した OAuth 2.0 認証に必要です。

認証には、更新トークンまたはクライアント認証情報のいずれかを使用できます。更新トークンとクライアント認証情報の両方が構成されている場合、統合は認証に更新トークンを使用します。
Refresh Token

省略可。

ServiceNow 統合の更新トークン。更新トークンを使用した OAuth 2.0 認証に必要です。

この構成済みの更新トークンは 90 日ごとに有効期限が切れます。

認証には、更新トークンまたはクライアント認証情報のいずれかを使用できます。更新トークンとクライアント認証情報の両方が構成されている場合、統合は認証に更新トークンを使用します。
Use Oauth Authentication

省略可。

選択すると、統合は OAuth 2.0 を使用して認証します。

OAuth 2.0 認証では、クライアント認証情報（Client ID と Client Secret）または Refresh Token のいずれかを設定する必要があります。

デフォルトでは無効にされています。

Google SecOps で統合を構成する方法については、統合を構成するをご覧ください。

必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスを構成してサポートする方法については、複数のインスタンスのサポートをご覧ください。

操作

アクションの詳細については、 デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。

添付ファイルを追加

Add Attachment アクションを使用して、ServiceNow のテーブルレコードに添付ファイルを追加します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

Add Attachment アクションには、次のパラメータが必要です。

パラメータ 説明
Table Name

必須。

添付ファイルが追加されるレコードを含むテーブルの名前。
Record Sys ID

必須。

添付ファイルが追加されるレコードのシステム ID（sys_id）。
File Path

必須。

添付するファイルの絶対パスのカンマ区切りのリスト。
Mode

省略可。

同じ名前のファイルがすでにレコードに存在する場合のアクションの動作。

値は次のいずれかになります。

  • Add New Attachment: このアクションにより、ファイルが新しい個別の添付ファイルとして追加されます。同じ名前のファイルを使用できます。
  • Overwrite Existing Attachment: このアクションにより、同じ名前を共有する既存のアタッチメントが置き換えられます。

デフォルト値は Add New Attachment です。

アクションの出力

Add Attachment アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Add Attachment アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "result": {
        "size_bytes": "742",
        "file_name": "placeholder_document.txt",
        "sys_mod_count": "0",
        "average_image_color": "",
        "image_width": "",
        "sys_updated_on": "2025-01-01 10:00:00",
        "sys_tags": "",
        "table_name": "incident",
        "sys_id": "TEST_SYS_ID_ATTACH_123456789",
        "image_height": "",
        "sys_updated_by": "admin",
        "download_link": "https://placeholder.service-now.com/api/now/attachment/TEST_SYS_ID_ATTACH_123456789/file",
        "content_type": "multipart/form-data",
        "sys_created_on": "2025-01-01 10:00:00",
        "size_compressed": "438",
        "compressed": "true",
        "state": "pending",
        "table_sys_id": "TEST_SYS_ID_RECORD_ABCDEFG",
        "chunk_size_bytes": "700000",
        "hash": "test_hash_0000000000000000000000000000000000000000000000000000000000000000",
        "sys_created_by": "admin"
    }
}
出力メッセージ

Add Attachment アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully added the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

Action wasn't able to add the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

No attachments were added to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

 アクションが成功しました。
Error executing action "Add Attachment". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、[Add Attachment] アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

コメントを追加

[コメントを追加] アクションを使用して、ServiceNow インシデントにコメントを追加します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

Add Comment アクションには、次のパラメータが必要です。

パラメータ 説明
Incident Number

必須。

コメントを追加するインシデントの番号（INCINCIDENT_NUMBER 形式）。
Comment

必須。

インシデントに追加するコメント。

アクションの出力

Add Comment アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
スクリプトの結果

次の表に、コメントを追加アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

コメントを追加して返信を待つ

[コメントを追加して返信を待つ] アクションを使用して、ServiceNow インシデントにコメントを追加し、そのインシデントに新しいコメントまたは返信が追加されるまで、ハンドブックの実行を一時停止します。アクションの出力は、新しいコメントの内容です。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

[Add Comment and Wait for Reply] アクションには、次のパラメータが必要です。

パラメータ 説明
Incident Number

必須。

コメントを追加するインシデントの番号（INCINCIDENT_NUMBER 形式）。
Comment

必須。

インシデントに追加するコメント。

アクションの出力

Add Comment and Wait for Reply アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
スクリプトの結果

次の表に、[コメントを追加して返信を待つ] アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
new_comment

レコードにコメントを追加する

[Add Comment To Record] アクションを使用して、ServiceNow の特定のテーブルレコードにコメントまたは作業メモを追加します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

Add Comment To Record アクションには、次のパラメータが必要です。

パラメータ 説明
Table Name

必須。

コメントまたはメモを追加するテーブルの名前。
Type

必須。

追加するコメントまたはメモの種類。

値は次のいずれかになります。

  • Comment
  • Work Note

デフォルト値は Comment です。
Record Sys ID

必須。

コメントまたは作業メモを追加するシステム ID（sys_id）。
Text

必須。

コメントまたは作業メモの内容。
Wait For Reply

省略可。

選択すると、アクションは非同期で実行され、新しいコメントまたは作業メモがレコードに追加されるまで実行が一時停止されます。

このアクションでは、コメントを追加した場合はコメントが追跡され、作業メモを追加した場合は作業メモが追跡されます。

デフォルトでは無効にされています。

アクションの出力

Add Comment To Record アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Add Comment To Record アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "sys_id": "4355183607523010ff23f6fd7c1ed0a8",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "Test comment content.",
    "sys_created_by": "admin",
    "element": "comments"
}
出力メッセージ

Add Comment To Record アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明
Successfully added COMMENT_OR_NOTE " CONTENT" to TABLE_NAME with Sys_ID SYS_ID in ServiceNow. アクションが成功しました。
Error executing action "Add Comment To Record". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、Add Comment To Record アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

親インシデントを追加

[Add Parent Incident] アクションを使用して、ServiceNow のインシデントに親インシデントを追加します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

[Add Parent Incident] アクションには、次のパラメータが必要です。

パラメータ 説明
Parent Incident Number

必須。

親インシデント番号（INCINCIDENT_NUMBER 形式）。例: INC0000051。

このアクションにより、Child Incident Numbers 内のすべてのインシデントが親インシデントの子として追加されます。
Child Incident Numbers

必須。

指定された親インシデントの子インシデントとして設定するインシデント番号のカンマ区切りのリスト。形式は INCINCIDENT_NUMBER（例: INC0000051）です。

アクションの出力

[Add Parent Incident] アクションの出力は次のとおりです。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、親インシデントを追加アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "2a100a1c2fc42010c518532a2799b621",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
出力メッセージ

Add Parent Incident アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明
Successfully set PARENT_INCIDENT_NUMBER as the "Parent Incident" for the following incidents in ServiceNow: CHILD_INCIDENT_NUMBERS. アクションが成功しました。
Error executing action "Add Parent Incident". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

インシデントをクローズする

[Close Incident] アクションを使用して、ServiceNow インシデントをクローズします。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

[Close Incident] アクションには、次のパラメータが必要です。

パラメータ 説明
Incident Number

必須。

クローズするインシデントの番号（INCINCIDENT_NUMBER 形式）。
Close Reason

必須。

インシデントをクローズする理由。
Resolution Code

必須。

インシデントの解決コード。

値は次のいずれかになります。

  • Duplicate
  • Known error
  • No resolution provided
  • Resolved by caller
  • Resolved by change
  • Resolved by problem
  • Resolved by request
  • Solution provided
  • Workaround provided
  • User error

デフォルト値は Solution provided です。
Close Notes

必須。

インシデントのクローズメモ。

アクションの出力

[Close Incident] アクションの出力は次のとおりです。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
スクリプトの結果

次の表に、インシデントをクローズアクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

アラート インシデントを作成する

[Create Alert Incident] アクションを使用して、ハンドブックの実行を開始するアラートの詳細に基づいて、ServiceNow で新しいインシデントを作成します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

Create Alert Incident アクションには、次のパラメータが必要です。

パラメータ 説明
Impact

必須。

インシデントの影響レベル。

値は次のいずれかになります。

  • 1（高）
  • 2（中）
  • 3（低）

デフォルト値は 1 です。
Urgency

必須。

インシデントの緊急度。

値は次のいずれかになります。

  • 1（高）
  • 2（中）
  • 3（低）

デフォルト値は 1 です。
Category

省略可。

インシデントのカテゴリ。
Assignment Group ID

省略可。

インシデントを割り当てるグループのフルネーム。
Assigned User ID

省略可。

インシデントを割り当てるユーザーの氏名。
Description

省略可。

インシデントの説明。

アクションの出力

[Create Alert Incident] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Create Alert Incident アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010005",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by":
    "admin", "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "1",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 05:13:25",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 05:13:25",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 07:13:25",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 05:13:25",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
スクリプトの結果

次の表に、アラート インシデントを作成アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

インシデントを作成する

[Create Incident] アクションを使用して、ServiceNow で新しいインシデントを作成します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

[Create Incident] アクションには、次のパラメータが必要です。

パラメータ 説明
Short Description

必須。

インシデントの簡単な説明。
Impact

必須。

インシデントの影響レベル。

値は次のいずれかになります。

  • 1（高）
  • 2（中）
  • 3（低）

デフォルト値は 1 です。
Urgency

必須。

インシデントの緊急度。

値は次のいずれかになります。

  • 1（高）
  • 2（中）
  • 3（低）

デフォルト値は 1 です。
Category

省略可。

インシデントのカテゴリ。
Assignment Group ID

省略可。

インシデントを割り当てるグループのフルネーム。
Assigned User ID

省略可。

インシデントを割り当てるユーザーの氏名。
Description

省略可。

インシデントの説明。
Custom Fields

省略可。

更新するフィールド名と対応する値を含む JSON 形式の文字列（例: {"location":"London", "category":"database"}）。

このパラメータを使用すると、アクション入力として明示的に定義されていないフィールドを変更できます。

アクションの出力

[Create Incident] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Create Incident アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010005",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by":
    "admin", "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "1",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 05:13:25",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 05:13:25",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 07:13:25",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 05:13:25",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
スクリプトの結果

次の表に、[インシデントを作成] アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
incident_number INCIDENT_NUMBER

レコードを作成する

[Create Record] アクションを使用して、さまざまな ServiceNow テーブルに新しいレコードを作成します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

Create Record アクションには、次のパラメータが必要です。

パラメータ 説明
Table Name

省略可。

新しいレコードが作成される ServiceNow テーブルの名前（例: incident）。
Object Json Data

省略可。

新しいレコードの定義に必要なフィールドと値のペア（インシデント フィールドや CMDB アイテム属性など）を含む JSON オブジェクト。

アクションの出力

Create Record アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Create Record アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010021",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "3",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "5",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 08:24:34",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": " ",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 08:24:34",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": " ",
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": " ",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 08:24:34",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "3",
    "reopen_count": "0"
}
スクリプトの結果

次の表に、レコードを作成アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
object_sys_id OBJECT_SYS_ID

添付ファイルをダウンロード

添付ファイルをダウンロードアクションを使用して、特定の ServiceNow レコードに添付されているファイルとドキュメントを Google SecOps 環境のローカル フォルダにダウンロードします。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

添付ファイルをダウンロードアクションには、次のパラメータが必要です。

パラメータ 説明
Table Name

必須。

添付ファイルをダウンロードするレコードを含む ServiceNow テーブルの名前（incident など）。
Record Sys ID

必須。

添付ファイルのダウンロード元となるレコードのシステム ID（sys_id）。
Download Folder Path

必須。

ダウンロードした添付ファイルが保存される Google SecOps 環境のフォルダの絶対パス。
Overewrite

省略可。

選択すると、同じ名前のファイルが上書きされます。

デフォルトでは無効にされています。

アクションの出力

Download Attachments アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Download Attachments アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "result": [
        {"absolute_file_path" : ["PATH"]
            "size_bytes": "187",
            "file_name": "example.txt",
            "sys_mod_count": "1",
            "average_image_color": "",
            "image_width": "",
            "sys_updated_on": "2020-10-19 09:58:39",
            "sys_tags": "",
            "table_name": "problem",
            "sys_id": "SYS_ID",
            "image_height": "",
            "sys_updated_by": "system",
            "download_link": "https://example.service-now.com/api/now/attachment/ID/file",
            "content_type": "text/plain",
            "sys_created_on": "2020-10-19 09:58:38",
            "size_compressed": "172",
            "compressed": "true",
            "state": "available",
            "table_sys_id": "57771d002f002010c518532a2799b6cc",
            "chunk_size_bytes": "700000",
            "hash": "a4fbb8ab71268903845b59724835274ddc66e095de553c5e0c1da8fecd04ee45",
            "sys_created_by": "admin"
        }
    ]
}
出力メッセージ

Download Attachments アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully downloaded the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

Action wasn't able to download the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

Action wasn't able to download attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

 アクションが成功しました。
Error executing action "Download Attachments". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、Download Attachments アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

子インシデントの詳細を取得する

[Get Child Incident Details] アクションを使用して、ServiceNow の親インシデントに基づいて子インシデントに関する情報を取得します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

[Get Child Incident Details] アクションには、次のパラメータが必要です。

パラメータ 説明
Parent Incident Number

必須。

子インシデントの詳細を取得する親インシデントの番号。INCINCIDENT_NUMBER の形式で指定します。
Max Child Incident To Return

省略可。

アクションが親インシデントから返す子インシデントの最大数。

デフォルト値は 50 です。

アクションの出力

Get Child Incident Details アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用可能
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
ケースウォール テーブル

[Get Child Incident Details] アクションでは、次の表が提供されます。

テーブル名: 子インシデントの詳細

テーブル列:

  • Sys ID（sys_id としてマッピング）
  • 数値（number としてマッピング）
  • 簡単な説明（short_description としてマッピング）
  • 作成場所（sys_created_on としてマッピング）
JSON の結果

次の例は、Get Child Incident Details アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  ATF Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "2a100a1c2fc42010c518532a2799b621",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
出力メッセージ

[Get Child Incident Details] アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully retrieved information about child incidents related to the PARENT_INCIDENT_NUMBER incident in ServiceNow.

Action wasn't able to retrieve information about the child incidents in ServiceNow. Reason: incident PARENT_INCIDENT_NUMBER was not found.

No child incidents were found.

 アクションが成功しました。
Error executing action "Get Child Incident Details". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、Get Child Incident Details アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

CMDB レコードの詳細を取得する

[Get CMDB Record Details] アクションを使用して、ServiceNow の同じクラスから詳細な CMDB レコードを取得します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

Get CMDB Record Details アクションには、次のパラメータが必要です。

パラメータ 説明
Class Name

必須。

レコードを取得する CMDB クラスの名前（cmdb_ci_appl など）。

クラス名の詳細については、クラス定義とメタデータの表示と編集をご覧ください。
Sys ID

必須。

詳細を取得する CMDB レコードのシステム ID（sys_id）のカンマ区切りのリスト。
Max Records To Return

省略可。

各関係タイプ（relates to や depends on など）に対して返されるレコード関係の最大数。

デフォルト値は 50 です。

アクションの出力

[Get CMDB Record Details] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Get CMDB Record Details アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "result": {
        "outbound_relations": [
            {
                "sys_id": "56f3a7ad7f701200bee45f19befa910f",
                "type": {
                    "display_value": "Members::Member of",
                    "link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
                    "value": "ID"
                },
                "target": {
                    "display_value": "Example",
                    "link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
                    "value": "ID"
                }
            }
        ],
        "attributes": {
            "attested_date": "",
            "skip_sync": "false",
            "operational_status": "1",
            "caption": "",
            "cluster_type": "",
            "sys_updated_on": "2016-01-06 19:04:07",
            "attestation_score": "",
            "discovery_source": "",
            "first_discovered": "",
            "sys_updated_by": "example.user",
            "cluster_status": "",
            "due_in": "",
            "sys_created_on": "2016-01-06 16:47:15",
            "sys_domain": {
                "display_value": "global",
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "install_date": "",
            "invoice_number": "",
            "gl_account": "",
            "sys_created_by": "example.user",
            "warranty_expiration": "",
            "cluster_version": "",
            "asset_tag": "",
            "fqdn": "",
            "change_control": "",
            "owned_by": "",
            "checked_out": "",
            "sys_domain_path": "/",
            "delivery_date": "",
            "maintenance_schedule": "",
            "install_status": "1",
            "cost_center": "",
            "attested_by": "",
            "supported_by": "",
            "dns_domain": "",
            "name": "SAP-LB-Win-Cluster",
            "assigned": "",
            "purchase_date": "",
            "subcategory": "Cluster",
            "short_description": "",
            "assignment_group": "",
            "managed_by": "",
            "managed_by_group": "",
            "last_discovered": "",
            "can_print": "false",
            "sys_class_name": "cmdb_ci_win_cluster",
            "manufacturer": "",
            "sys_id": "SYS_ID",
            "cluster_id": "",
            "po_number": "",
            "checked_in": "",
            "sys_class_path": "/!!/!5/!$",
            "vendor": "",
            "mac_address": "",
            "company": "",
            "model_number": "",
            "justification": "",
            "department": "",
            "assigned_to": "",
            "start_date": "",
            "cost": "",
            "comments": "",
            "sys_mod_count": "1",
            "serial_number": "",
            "monitor": "false",
            "model_id": "",
            "ip_address": "",
            "duplicate_of": "",
            "sys_tags": "",
            "cost_cc": "USD",
            "support_group": "",
            "order_date": "",
            "schedule": "",
            "environment": "",
            "due": "",
            "attested": "false",
            "unverified": "false",
            "correlation_id": "",
            "attributes": "",
            "location": "",
            "asset": "",
            "category": "Resource",
            "fault_count": "0",
            "lease_id": ""
        },
        "inbound_relations": [
            {
                "sys_id": "3b3d95297f701200bee45f19befa910c",
                "type": {
                    "display_value": "Depends on::Used by",
                    "link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
                    "value": "ID"
                },
                "target": {
                    "display_value": "IP-Router-3",
                    "link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
                    "value": "ID"
                }
            }
        ]
    }
}
出力メッセージ

Get CMDB Record Details アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully returned details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST.

Action wasn't able to return details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST

Action wasn't able to return details for CMDB records in the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found.

Action wasn't able to return details for CMDB record with Sys ID SYS_ID in the Class CLASS_NAME in Service Now. Reason: Record with Sys ID SYS_ID was not found in Class CLASS_NAME.

Information about the provided Sys IDs was not found.

 アクションが成功しました。
Error executing action "Get CMDB Record Details". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、CMDB レコードの詳細を取得アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

インシデントを取得する

Get Incident アクションを使用して、ServiceNow インシデントに関する情報を取得します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

Get Incident アクションには、次のパラメータが必要です。

パラメータ 説明
Incident Number

必須。

取得する ServiceNow インシデントの固有識別子（INCINCIDENT_NUMBER 形式）。

アクションの出力

Get Incident アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Get Incident アクションの使用時に受信した JSON 結果の出力を示しています。

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": "2012",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010041",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "10",
    "notify": "1",
    "resolved_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": "2020-07-10 12:53:06",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "priority": "1",
    "state": "7",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 12:18:04",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "sdf",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": "0",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": "Closed by Caller",
    "business_duration": "1970-01-01 00:00:00",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 13:13:57",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": "1970-01-01 00:35:02",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "false",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 14:33:28",
    "severity": "3",
    "incident_state": "7",
    "resolved_at": "2020-07-10 12:53:06",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 12:18:04",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": "Closed/Resolved by Caller",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
スクリプトの結果

次の表に、Get Incident アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
incident_number INCIDENT_NUMBER

OAuth トークンを取得する

Get Oauth Token アクションを使用して、ServiceNow の OAuth 更新トークンを取得します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

なし

アクションの出力

Get Oauth Token アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Get Oauth Token アクションの使用時に受信した JSON 結果の出力を示しています。

{
    "access_token": "Na4Kb1oWpFcYNUnyAjsYldiTMxYF1Cz79Q",
    "refresh_token": "0ryCENbbvfggZbNG9rFFd8_C8X0UgAQSMQkPJNStGwEEt0qNt-F1lw",
    "scope": "useraccount",
    "token_type": "Bearer",
    "expires_in": 1799
}
出力メッセージ

Get Oauth Token アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明
Successfully generated Oauth tokens for ServiceNow. Now navigate to the configuration tab and put "refresh_token" value in the "Refresh Token" parameter. Note: "Username" and "Password" parameters can be emptied. アクションが成功しました。
Error executing action "Get Oauth Token". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、OAuth トークンを取得アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

レコードの詳細を取得する

Get Record Details アクションを使用して、ServiceNow の特定のテーブル レコードに関する情報を取得します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

Get Record Details アクションには、次のパラメータが必要です。

パラメータ 説明
Table Name

必須。

情報を取得するレコードを含む ServiceNow テーブルの名前（incident など）。
Record Sys ID

必須。

詳細を取得する特定の ServiceNow レコードのシステム ID（sys_id）。
Fields

省略可。

取得したレコードから返す特定のフィールド（列）のカンマ区切りのリスト（sys_id,number,short_description など）。

値を指定しない場合、アクションはレコードのデフォルト フィールドを返します。

アクションの出力

[Get Record Details] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Get Record Details アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  ATF Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "SYS_ID",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
出力メッセージ

Get Record Details アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully retrieved information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow.

Action wasn't able to retrieve information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow. Reason: ERROR_REASON.

 アクションが成功しました。
Error executing action "Get Record Details". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、Get Record Details アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

ユーザーの詳細を取得する

[Get User Details] アクションを使用して、ServiceNow の sys_id パラメータを使用してユーザーに関する情報を取得します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

Get User Details アクションには、次のパラメータが必要です。

パラメータ 説明
User Sys IDs

省略可。

詳細を取得するユーザーに対応するシステム ID のカンマ区切りのリスト（sys_id_1,sys_id_2 など）。
Emails

省略可。

詳細を取得するユーザーに対応するメールアドレスのカンマ区切りのリスト（email1@example.com,email2@example.com など）。

アクションの出力

[Get User Details] アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用可能
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
ケースウォール テーブル

[Get User Details] アクションでは、次の表が提供されます。

テーブル名: User Details

テーブル列:

  • Sys ID（sys_id としてマッピング）
  • Name（name としてマッピング）
  • ユーザー名（user_name としてマッピング）
  • メール（email としてマッピング）
JSON の結果

次の例は、Get User Details アクションを使用したときに受信した JSON 結果の出力を示しています。

{
    "result": [
        {
            "calendar_integration": "1",
            "country": "",
            "last_position_update": "",
            "user_password": "example",
            "last_login_time": "",
            "source": "",
            "sys_updated_on": "2020-08-29 02:42:42",
            "building": "",
            "web_service_access_only": "false",
            "notification": "2",
            "enable_multifactor_authn": "false",
            "sys_updated_by": "user@example",
            "sys_created_on": "2012-02-18 03:04:52",
            "agent_status": "",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "",
            "vip": "false",
            "sys_created_by": "admin",
            "longitude": "",
            "zip": "",
            "home_phone": "",
            "time_format": "",
            "last_login": "",
            "default_perspective": "",
            "geolocation_tracked": "false",
            "active": "true",
            "sys_domain_path": "/",
            "cost_center": {
                "link": "https://example.service-now.com/api/now/table/cmn_cost_center/ID",
                "value": "ID"
            },
            "phone": "",
            "name": "Example User",
            "employee_number": "",
            "password_needs_reset": "false",
            "gender": "Male",
            "city": "",
            "failed_attempts": "",
            "user_name": "example.user",
            "latitude": "",
            "roles": "",
            "title": "",
            "sys_class_name": "sys_user",
            "sys_id": "SYS_ID",
            "internal_integration_user": "false",
            "ldap_server": "",
            "mobile_phone": "",
            "street": "",
            "company": {
                "link": "https://example.service-now.com/api/now/table/core_company/ID",
                "value": "ID"
            },
            "department": {
                "link": "https://dev98773.service-now.com/api/now/table/cmn_department/ID",
                "value": "ID"
            },
            "first_name": "Example",
            "email": "example@example.com",
            "introduction": "",
            "preferred_language": "",
            "manager": "",
            "business_criticality": "3",
            "locked_out": "false",
            "sys_mod_count": "4",
            "last_name": "User",
            "photo": "",
            "avatar": "063e38383730310042106710ce41f13b",
            "middle_name": "",
            "sys_tags": "",
            "time_zone": "",
            "schedule": "",
            "on_schedule": "",
            "date_format": "",
            "location": {
                "link": "https://example.service-now.com/api/now/table/cmn_location/ID",
                "value": "ID"
            }
        }
    ]
}
出力メッセージ

Get User Details アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully retrieved information about users from ServiceNow with the following Sys IDs: SYS_ID_LIST.

Action wasn't able to retrieve information about the users in ServiceNow with the following Sys IDs: SYS_ID_LIST.

Information about the users with specified Sys IDs was not found in ServiceNow.

 アクションが成功しました。
Error executing action "Get User Details". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、Get User Details アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

CMDB レコードを一覧表示する

CMDB レコードを一覧表示するアクションを使用して、ServiceNow の同じクラスの CMDB レコードを一覧表示します。

このアクションは Google SecOps エンティティに対しては実行されません。

クエリフィルタの生成

Query Filter パラメータは、標準の ServiceNow エンコードされたクエリ文字列（sysparm_query）を受け入れます。これらの文字列は、ServiceNow インターフェース内で直接生成するか（たとえば、リスト表示でフィルタを作成して [クエリをコピー] を選択する）、手動で作成できます。

これらの文字列を生成して使用する方法については、ServiceNow ドキュメントのエンコードされたクエリ文字列をご覧ください。

アクションへの入力

List CMDB Records アクションには、次のパラメータが必要です。

パラメータ 説明
Class Name

必須。

レコードを取得する CMDB クラスの名前（cmdb_ci_appl など）。

ServiceNow クラス名の詳細については、クラス定義とメタデータの表示と編集をご覧ください。
Query Filter

省略可。

返されるレコードをフィルタするために使用される、エンコードされたクエリ文字列（sys_idLIKE1^sys_idSTARTSWITH0 など）。

ServiceNow のリスト表示で [Copy query] オプションを使用すると、有効なクエリ文字列を生成できます。詳細については、エンコードされたクエリ文字列をご覧ください。
Max Records To Return

省略可。

適用されたフィルタに基づいて取得するレコードの最大数。

デフォルト値は 50 です。

アクションの出力

List CMDB Records アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用可能
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
ケースウォール テーブル

List CMDB Records アクションは、次の表を提供します。

テーブル名: CLASS_NAME Records

テーブル列:

  • Name（name としてマッピング）
  • Sys ID（sys_id としてマッピング）
JSON の結果

次の例は、List CMDB Records アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "result": [
        {
            "sys_id": "SYS_ID",
            "name": "Example server"
        }
    ]
}
出力メッセージ

List CMDB Records アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully listed CMDB records for the Class CLASS_NAME in ServiceNow.

Action wasn't able to list CMDB records for the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found in Service Now.".format(Class name)

 アクションが成功しました。
Error executing action "List CMDB Records". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、List CMDB Records アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

レコードのコメントを一覧表示する

List Record Comments アクションを使用して、ServiceNow の特定のテーブル レコードに関連するコメントを一覧表示します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

List Record Comments アクションには、次のパラメータが必要です。

パラメータ 説明
Table Name

必須。

コメントを一覧表示するレコードを含む ServiceNow テーブルの名前（incident など）。
Record Sys ID

必須。

コメントを一覧表示するレコードのシステム ID（sys_id）。
Type

必須。

取得するコメントまたはメモの種類。

値は次のいずれかになります。

  • Comment
  • Work Note

デフォルト値は Comment です。
Max Results To Return

省略可。

返されるコメントまたは作業メモの最大数。

デフォルト値は 50 です。

アクションの出力

List Record Comments アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、List Record Comments アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "sys_id": "SYS_ID",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "test",
    "sys_created_by": "admin",
    "element": "comments"
}
出力メッセージ

List Record Comments アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

No CONTENT_TYPE were found for TABLE_NAME with Sys ID SYS_ID in ServiceNow.

 アクションが成功しました。
Error executing action "List Record Comments". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、List Record Comments アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

[List Records Related To User] アクションを使用して、ServiceNow のユーザーに関連するテーブルのレコードを一覧表示します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

[List Records Related To User] アクションには、次のパラメータが必要です。

パラメータ 説明
Table Name

必須。

関連するレコードを検索する ServiceNow テーブルの名前（incident など）。
Usernames

必須。

関連するレコードを取得するユーザー名のカンマ区切りのリスト。
Max Days Backwards

必須。

関連するレコードを検索するために、現在の日付から遡る日数。

デフォルト値は 1 です。
Max Records To Return

省略可。

ユーザーごとに返されるレコードの最大数。

デフォルト値は 50 です。

アクションの出力

List Records Related To User アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、List Records Related To User アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-19 14:18:40",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010008",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-19 14:18:40",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-19 14:18:20",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "TEST",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": "",
            "sys_id": "SYS_ID",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": {
                "link": "https://example.service-now.com/api/now/table/core_company/ID",
                "value": "ID"
            },
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
         "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
出力メッセージ

List Records Related To User アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully retrieved related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST.

Action wasn't able to retrieve related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST.

No related table records were retrieved for the provided users.

アクションが成功しました。
Error executing action "List Records Related To User". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、ユーザーに関連するレコードを一覧表示するアクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

Ping

Ping アクションを使用して、ServiceNow への接続をテストします。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

なし

アクションの出力

Ping アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
スクリプトの結果

次の表に、Ping アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

インシデントを更新

[Update Incident] アクションを使用して、インシデント情報を更新します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

インシデントの更新アクションには、次のパラメータが必要です。

パラメータ 説明
Incident Number

必須。

更新する ServiceNow インシデントの固有識別子（INCINCIDENT_NUMBER 形式）。
Short Description

省略可。

インシデントの簡単な説明。
Impact

省略可。

インシデントの影響レベル。

値は次のいずれかになります。

  • 1（高）
  • 2（中）
  • 3（低）

デフォルト値は 1 です。
Urgency

省略可。

インシデントの緊急度。

値は次のいずれかになります。

  • 1（高）
  • 2（中）
  • 3（低）

デフォルト値は 1 です。
Category

省略可。

インシデントのカテゴリ。
Assignment Group ID

省略可。

インシデントを割り当てるグループの完全な名前。
Assigned User ID

省略可。

インシデントを割り当てるユーザーのフルネーム。
Description

省略可。

インシデントの説明。
Incident State

省略可。

ラベル（New や In Progress など）ではなく、インシデント状態の基盤となる ServiceNow 値（1 や in_progress など）。
Custom Fields

省略可。

更新するフィールド名と対応する値を含む JSON 形式の文字列（例: {"location":"London", "category":"database"}）。

このパラメータを使用すると、アクション入力として明示的に定義されていないフィールドを変更できます。

アクションの出力

[Update Incident] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Update Incident アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": "2012",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010041",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "10",
    "notify": "1",
    "resolved_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": "2020-07-10 12:53:06",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "priority": "1",
    "state": "7",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 12:18:04",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "sdf",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": "0",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": "Closed by Caller",
    "business_duration": "1970-01-01 00:00:00",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 13:13:57",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": "1970-01-01 00:35:02",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "false",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 14:33:28",
    "severity": "3",
    "incident_state": "7",
    "resolved_at": "2020-07-10 12:53:06",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 12:18:04",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": "Closed/Resolved by Caller",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
スクリプトの結果

次の表に、インシデントの更新アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
incident_number INCIDENT_NUMBER

レコードの更新

Update Record アクションを使用して、ServiceNow のさまざまなテーブルに属する既存のレコードを変更します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

Update Record アクションには、次のパラメータが必要です。

パラメータ 説明
Table Name

省略可。

更新するレコードを含む ServiceNow テーブルの名前（incident など）。
Object Json Data

必須。

レコードに適用するフィールドと値のペア（{"short_description": "Updated description"} など）を含む JSON オブジェクト。
Record Sys ID

必須。

更新する特定のレコードのシステム ID（sys_id）。

アクションの出力

Update Record アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Update Record アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010021",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "3",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "5",
    "state": "1",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 08:24:34",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": " ",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 08:24:34",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": " ",
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": " ",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 08:24:34",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "3",
    "reopen_count": "0"
}
スクリプトの結果

次の表に、レコードを更新アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
record_sys_id RECORD_SYS_ID

コメントを待つ

Wait For Comments アクションを使用して、ServiceNow の特定のテーブル レコードにコメントまたは作業メモが追加されるまで、ハンドブックの実行を一時停止します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

コメントを待つアクションには、次のパラメータが必要です。

パラメータ 説明
Table Name

必須。

コメントを待機するレコードを含む ServiceNow テーブルの名前（incident など）。
Record Sys ID

必須。

コメントをモニタリングするレコードのシステム ID（sys_id）。
Type

必須。

アクションが待機するコメントまたはメモの種類。

値は次のいずれかになります。

  • Comment
  • Work Note

デフォルト値は Comment です。
Wait Mode

必須。

アクションが待機を停止して続行するタイミングを決定する条件。

値は次のいずれかになります。

  • Until Timeout: アクションはタイムアウト期間全体を待機してから、蓄積されたすべてのコメントを返します。
  • Until First Message: このアクションは、アクションの開始後に最初の新しいコメントまたは作業メモが投稿されるまで待機します。
  • Until Specific Text: Text で指定されたテキストを含むコメントまたは作業メモが投稿されるまで、アクションは待機します。

デフォルト値は Until Timeout です。
Text

省略可。

新しいコメントまたは作業メモ内でアクションが待機する特定のテキスト文字列。

このパラメータは、Wait Mode の値に Until Specific Text が選択されている場合にのみ使用されます。

アクションの出力

Wait For Comments アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Wait For Comments アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "sys_id": "SYS_ID",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "test",
    "sys_created_by": "admin",
    "element": "comments"
}
出力メッセージ

Wait For Comments アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

No new CONTENT_TYPE were added during the timeframe of action execution to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

 アクションが成功しました。
Error executing action "Wait For Comments". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、[Wait For Comments] アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

フィールドの更新を待つ

[Wait for Field Update] アクションを使用して、ServiceNow データレコードの特定のフィールドが想定される値のいずれかに更新されるまで、ハンドブックの実行を一時停止します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

フィールドの更新を待機アクションには、次のパラメータが必要です。

パラメータ 説明
Table Name

必須。

モニタリングするレコードを含む ServiceNow テーブルの名前（incident など）。
Record Sys ID

必須。

フィールドの更新をモニタリングするレコードのシステム ID（sys_id）。
Field - Column Name

必須。

アクションが変更をモニタリングする列（フィールド）の名前。
Field - Values

必須。

モニタリング対象のフィールドで見つかった場合に、アクションが待機を停止して続行する値のカンマ区切りのリスト（In Progress,Resolved など）。

アクションの出力

[Wait for Field Update] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
スクリプトの結果

次の表に、フィールドの更新を待機アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
updated_field UPDATED_FIELD

ステータスの更新を待つ

ステータスの更新を待機アクションを使用して、特定の ServiceNow インシデント ステータス（状態）が想定される値のいずれかに更新されるまで、ハンドブックの実行を一時停止します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

ステータスの更新を待機アクションには、次のパラメータが必要です。

パラメータ 説明
Incident Number

必須。

モニタリングする ServiceNow インシデントの固有識別子（INCINCIDENT_NUMBER 形式）。
Statuses

必須。

インシデント ステータス（状態）のカンマ区切りのリスト。このステータスに達すると、アクションは待機を停止して続行します（In Progress,Resolved など）。

アクションの出力

ステータスの更新を待機アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
スクリプトの結果

次の表に、[ステータス更新を待機] アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
new_status STATUS

コネクタ

Google SecOps でコネクタを構成する方法については、データを取り込む（コネクタ）をご覧ください。

ServiceNow コネクタ

ServiceNow コネクタを使用して、ServiceNow からインシデントを取得します。

動的クエリリストの操作

ServiceNow コネクタでは、動的リストによって、コネクタが ServiceNow のクエリに使用する sysparm_query が変更されます。これにより、レコードタイプでサポートされているフィールドに基づいてレコードをフィルタリングできます。

フィルタを定義するには、次の形式で 1 つのフィールドと値のペアを含むように各動的リストアイテムを構成します。 FIELD_NAME=VALUE.

例: category=security。

Use whitelist as a blacklist が有効になっている場合、コネクタはクエリロジックを反転し、動的リストがフィルタではなくブロックリストとして機能するようにします。

コネクタの入力

ServiceNow コネクタには、次のパラメータが必要です。

パラメータ 説明
Product Field Name

必須。

商品名が保存されるフィールドの名前。

商品名は主にマッピングに影響します。コネクタのマッピング プロセスを合理化して改善するため、デフォルト値はコードから参照されるフォールバック値に解決されます。このパラメータに無効な入力があると、デフォルトでフォールバック値に解決されます。

デフォルト値は Product Name です。
Event Field Name

必須。

イベント名（サブタイプ）を決定するフィールドの名前。

デフォルト値は sys_class_name です。
Rule Generator

省略可。

レコードの取得時に適用する特定のクエリまたはルールセットを値で定義するフィールドの名前。
Api Root

必須。

ServiceNow インスタンスの API ルート。

デフォルト値は https://INSTANCE.service-now.com/api/now/v1/ です。
Username

必須。

ServiceNow アカウントのユーザー名。
Password

必須。

ServiceNow アカウントのパスワード。
Verify SSL

省略可。

選択すると、統合は ServiceNow サーバーに接続するときに SSL 証明書を検証します。

デフォルトで有効になっています。
Use sys_domain Environment

省略可。

選択すると、コネクタは ServiceNow の sys_domain フィールドを、取り込まれたケースの環境として使用します。

このフィールドがないか、使用できない場合、コネクタはデフォルトで Environment パラメータで指定された値を使用します。
Days Backwards

省略可。

レコードを取得する、現在時刻から遡る日数。

このパラメータは、最初のコネクタ実行で使用されるか、以前のコネクタのタイムスタンプが期限切れになった場合のフォールバック値として使用されます。

デフォルト値は 5 です。
Disable Overflow

省略可。

選択すると、コネクタは Google SecOps のオーバーフロー メカニズムを無視します。
Max Incidents Per Cycle

省略可。

各コネクタのイテレーション中に取得するインシデントの最大数。

デフォルト値は 10 です。
Environments Whitelist

省略可。

コネクタが Google SecOps に取り込む環境（ドメイン）のカンマ区切りのリスト（env1,env2 など）。
Use whitelist as a blacklist

省略可。

選択すると、コネクタは動的リストを拒否リストとして使用します。

デフォルトでは無効にされています。
PythonProcessTimeout

必須。

現在のスクリプトを実行する Python プロセスのタイムアウト上限（秒単位）。

デフォルト値は 60 です。
Incident Table

省略可。

インシデント関連のアクションとレコードの取得に使用する API テーブル名またはパス。

デフォルトでは、統合は table/incident パスを使用します。
Client ID

省略可。

ServiceNow 統合のクライアント ID。クライアント認証情報を使用した OAuth 2.0 認証に必要です。

認証には、更新トークンまたはクライアント認証情報のいずれかを使用できます。更新トークンとクライアント認証情報の両方が構成されている場合、統合は認証に更新トークンを使用します。
Client Secret

省略可。

ServiceNow 統合のクライアント シークレット。クライアント認証情報を使用した OAuth 2.0 認証に必要です。

認証には、更新トークンまたはクライアント認証情報のいずれかを使用できます。更新トークンとクライアント認証情報の両方が構成されている場合、統合は認証に更新トークンを使用します。
Refresh Token

省略可。

ServiceNow 統合の更新トークン。更新トークンを使用した OAuth 2.0 認証に必要です。

この構成済みの更新トークンは 90 日ごとに有効期限が切れます。

認証には、更新トークンまたはクライアント認証情報のいずれかを使用できます。更新トークンとクライアント認証情報の両方が構成されている場合、統合は認証に更新トークンを使用します。
Assignment Group

省略可。

コネクタがレコードを取り込む割り当てグループの名前。
Use Oauth Authentication

省略可。

選択すると、統合は OAuth 2.0 を使用して認証します。

OAuth 2.0 認証では、クライアント認証情報（Client ID と Client Secret）または Refresh Token のいずれかを設定する必要があります。

デフォルトでは無効にされています。
Server Time Zone

省略可。

ServiceNow サーバーで構成されているタイムゾーン（UTC や Asia/Jerusalem など）。

デフォルト値は UTC です。
Table Name

省略可。

レコードを取得するテーブルの名前（incident など）。
Event Name

省略可。

レコードの取り込み時に作成された Google SecOps イベントの名前（ServiceNowEvent など）。
Proxy Server Address

省略可。

使用するプロキシ サーバーのアドレス。
Proxy Username

省略可。

認証に使用するプロキシのユーザー名。
Proxy Password

省略可。

認証に使用するプロキシ パスワード。
Get User Information

省略可。

選択すると、コネクタはインシデントに関連するユーザーに関する情報も取得します。

デフォルトでは無効にされています。

ジョブ

ジョブの詳細については、新しいジョブを構成すると高度なスケジューリングをご覧ください。

ServiceNow - クローズされたインシデントの同期

ServiceNow - Sync Closed Incidents ジョブを使用して、クローズされた ServiceNow インシデントを、対応する Google SecOps のアラートとケースと同期します。

このジョブは、アラートとして取り込まれた ServiceNow インシデントと、ServiceNow タグとインシデント番号を含む TICKET_ID コンテキスト値を含むケースを処理します。

ジョブのパラメータ

ServiceNow - Sync Closed Incidents ジョブには、次のパラメータが必要です。

パラメータ 説明
API Root 必須

ServiceNow インスタンスの API ルート。デフォルトは、https://INSTANCE.service-now.com/api/now/v1/ です。
Username 必須

ServiceNow インスタンスのユーザー名。
Password 必須

ServiceNow インスタンスのパスワード。
Verify SSL Optional

選択すると、統合は ServiceNow サーバーに接続するときに SSL 証明書を検証します。デフォルトで有効になっています。
Client ID Optional

ServiceNow 統合のクライアント ID。クライアント認証情報を使用した OAuth 2.0 認証に必要です。認証には、更新トークンまたはクライアント認証情報のいずれかを使用できます。更新トークンとクライアント認証情報の両方が構成されている場合、統合は認証に更新トークンを使用します。
Client Secret Optional

ServiceNow 統合のクライアント シークレット。クライアント認証情報を使用した OAuth 2.0 認証に必要です。認証には、更新トークンまたはクライアント認証情報のいずれかを使用できます。更新トークンとクライアント認証情報の両方が構成されている場合、統合は認証に更新トークンを使用します。
Refresh Token Optional

ServiceNow 統合の更新トークン。更新トークンを使用した OAuth 2.0 認証に必要です。この構成済みの更新トークンは 90 日ごとに有効期限が切れます。認証には、更新トークンまたはクライアント認証情報のいずれかを使用できます。更新トークンとクライアント認証情報の両方が構成されている場合、統合は認証に更新トークンを使用します。
Use OAuth Authentication Optional

選択すると、統合は OAuth 2.0 を使用して認証を行います。OAuth 2.0 認証では、クライアント認証情報（Client ID と Client Secret）または Refresh Token のいずれかを設定する必要があります。デフォルトでは無効にされています。
Max Hours Backwards Optional

クローズされたインシデントを検索して同期するために、現在の時刻から遡る時間数。デフォルトは、24 です。
Table Name 必須

クローズされたインシデントを検索するデータベース テーブルの名前（例: incident）。

ServiceNow - インシデントを同期する

ServiceNow - Sync Incidents ジョブを使用して、ServiceNow のインシデント フィールドと添付ファイルを Google SecOps の関連するケースとアラートと同期します。

このジョブを実行するには、ServiceNow 統合ユーザーに ITIL（itil）ロールが必要です。詳細については、ServiceNow のドキュメントの基本システムロールをご覧ください。

職務要件

ジョブが正しく機能するように、Google SecOps のケースまたはアラート（Sync Level パラメータによって異なる）で次の構成が設定されていることを確認します。

  • タグ: ケースに ServiceNow Incident Sync タグが付いている必要があります。
  • コンテキスト値: ケースまたはアラートには、ServiceNow インシデント番号のカンマ区切りリスト（INC0000050,INC0000051 など）を含む TICKET_ID コンテキスト キーが必要です。Siemplify Utilities 統合の [Set Scope Context Value] アクションを使用して、TICKET_ID コンテキスト値を設定します。

ジョブのパラメータ

ServiceNow - Sync Incidents ジョブには、次のパラメータが必要です。

パラメータ 説明
API Root 必須

ServiceNow インスタンスの API ルート。デフォルトは、https://INSTANCE.service-now.com/api/now/v1/ です。
Username Optional

ServiceNow インスタンスのユーザー名。

基本パスワード認証を使用して認証する場合、このパラメータは必須です。
Password Optional

ServiceNow インスタンスのパスワード。

基本パスワード認証を使用して認証する場合、このパラメータは必須です。
Sync Level 必須

ジョブがデータを同期するレベル。指定できる値: Case、Alert。デフォルトは Case です。
Max Hours Backwards 必須

同期するケースを検索する、現在の時刻から遡る最大時間数。デフォルトは、24 です。
Verify SSL Optional

選択すると、統合は ServiceNow サーバーに接続するときに SSL 証明書を検証します。デフォルトで有効になっています。
Use OAuth Authentication Optional

選択すると、ジョブは基本認証ではなく OAuth 認証を使用します。選択した場合、Client ID、Client Secret、Refresh Token のパラメータは必須です。デフォルトでは無効にされています。
Client ID Optional

ServiceNow アプリケーションのクライアント ID。Use OAuth Authentication が選択されている場合は必須。
Client Secret Optional

ServiceNow アプリケーションのクライアント シークレット。Use OAuth Authentication が選択されている場合は必須。
Refresh Token Optional

ServiceNow アプリケーションの更新トークン。Use OAuth Authentication が選択されている場合は必須。

テーブル レコードのコメントの同期

Sync Table Record Comments ジョブを使用して、ServiceNow テーブル レコードと Google SecOps ケース間でコメントを同期します。

ジョブのパラメータ

Sync Table Record Comments ジョブには、次のパラメータが必要です。

パラメータ 説明
API Root 必須

ServiceNow インスタンスの API ルート。デフォルトは、https://INSTANCE.service-now.com/api/now/v1/ です。
Username 必須

ServiceNow インスタンスのユーザー名。
Password 必須

ServiceNow インスタンスのパスワード。
Verify SSL Optional

選択すると、統合は ServiceNow サーバーに接続するときに SSL 証明書を検証します。デフォルトで有効になっています。
Client ID Optional

ServiceNow 統合のクライアント ID。クライアント認証情報を使用した OAuth 2.0 認証に必要です。認証には、更新トークンまたはクライアント認証情報のいずれかを使用できます。更新トークンとクライアント認証情報の両方が構成されている場合、統合は認証に更新トークンを使用します。
Client Secret Optional

ServiceNow 統合のクライアント シークレット。クライアント認証情報を使用した OAuth 2.0 認証に必要です。認証には、更新トークンまたはクライアント認証情報のいずれかを使用できます。更新トークンとクライアント認証情報の両方が構成されている場合、統合は認証に更新トークンを使用します。
Refresh Token Optional

ServiceNow 統合の更新トークン。更新トークンを使用した OAuth 2.0 認証に必要です。この構成済みの更新トークンは 90 日ごとに有効期限が切れます。認証には、更新トークンまたはクライアント認証情報のいずれかを使用できます。更新トークンとクライアント認証情報の両方が構成されている場合、統合は認証に更新トークンを使用します。
Use OAuth Authentication Optional

選択すると、統合は OAuth 2.0 を使用して認証を行います。OAuth 2.0 認証では、クライアント認証情報（Client ID と Client Secret）または Refresh Token のいずれかを設定する必要があります。デフォルトでは無効にされています。
Table Name 必須

コメントの同期元となるレコードを検索する ServiceNow テーブルの名前（例: incident）。

タグ別にテーブル レコードのコメントを同期する

Sync Table Record Comments By Tag ジョブを使用して、ServiceNow テーブル レコードと Google SecOps ケース間でコメントを同期します。

職務要件

ジョブが正しく機能するには、Google SecOps ケースに次の 2 つのタグが必要です。

  • ServiceNow TABLE_NAME（<var class="readonly">TABLE_NAME</var> は ServiceNow テーブルの名前（incident など））。
  • ServiceNow TicketId: TICKET_ID（<var class="readonly">TICKET_ID</var> は、対応するレコードのシステム ID または番号）。

ジョブのパラメータ

Sync Table Record Comments By Tag ジョブには、次のパラメータが必要です。

パラメータ 説明
API Root 必須

ServiceNow インスタンスの API ルート。デフォルトは、https://INSTANCE.service-now.com/api/now/v1/ です。
Username 必須

ServiceNow インスタンスのユーザー名。
Password Mandatory

ServiceNow インスタンスのパスワード。
Table Name 必須

検索するデータベース テーブルの名前（incident など）。
Verify SSL Optional

選択すると、統合は ServiceNow サーバーに接続するときに SSL 証明書を検証します。デフォルトで有効になっています。

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。