Risk Exchange 用 ServiceNow プラグイン

2.0.0 (Requires minimum Cloud Exchange version 6.1.0)
Added

• ServiceNowからユーザー、デバイス、アプリケーションのエンティティの取得を追加しました。
• 次のアクションが追加されました：グループへのユーザーの追加/グループからのユーザーの削除、ロールへのユーザーの追加/ロールからのユーザーの削除、ユーザー委任の更新、デバイスタグの管理、アプリケーションタグの管理、アプリケーションデータの共有（Core CompanyまたはBusiness Applicationテーブルのいずれか）。

1.0.0
Added

• 初回リリース。

使うAPI一覧

APIエンドポイント	方法	使うケース
/api/now/table/sys _ユーザー	得る	ユーザー詳細を取得
/api/now/table/cmdb_ci_computer	得る	デバイスの詳細を取得
/api/now/table/cmdb_ci_business_app	得る	アプリケーションの詳細を取得
/api/now/table/sys _ユーザーグループ	得る	ユーザー・グループの詳細を取得
/api/now/table/sys_user_role	得る	ユーザーロールの詳細を取得
/api/now/table/sys _ユーザー	得る	電子メール/ユーザー名をsys_idに解決
/api/now/table/sys _ユーザーグループ	得る	ユーザーグループが存在するか確認
/api/now/table/sys _ユーザーグループ	役職	ユーザーグループを作成
/api/now/table/sysユーザーにロールを追加	得る	ユーザー・グループのメンバーシップを確認
/api/now/table/sysユーザーにロールを追加	役職	ユーザーをグループに追加する
/api/now/table/sys_user_grmember/{sys_id}	DELETE	ユーザーをグループから削除する
/api/now/table/sysユーザーにはロールがあります	得る	ユーザーにロールが割り当てられているか確認
/api/now/table/sysユーザーにはロールがあります	役職	ユーザーにロールを追加
/api/now/table/sys_user_has_role/{sys_id}	DELETE	ユーザーからロールを削除
/api/now/table/sys_user_delegate	得る	ユーザー委任が存在するか確認
/api/now/table/sys_user_delegate	役職	ユーザー委任レコードを作成
/api/now/table/sys_user_delegate/{sys_id}	パッチ	ユーザー委任レコードを更新
/api/now/table/sys_user_delegate/{sys_id}	DELETE	ユーザー委任レコードを削除
/api/now/table/cmdb_キー_バリュー	得る	デバイスまたはアプリケーションのタグレコードが既に存在するか確認
/api/now/table/cmdb_キー_バリュー	役職	デバイス/アプリケーションにタグ付け
/api/now/table/cmdb_key_value/{sys_id}	DELETE	デバイス/アプリケーションのタグを解除
/api/now/table/cmdb_ci_business_app	得る	cmdb_ci_business_appテーブルで既存のアプリケーションを検索
/api/now/table/cmdb_ci_business_app	役職	cmdb_ci_business_appテーブルにアプリケーションレコードを作成
/api/now/table/cmdb_ci_business_app/{sys_id}	パッチ	cmdb_ci_business_app テーブルのアプリケーションレコードを更新します
/api/now/table/core _会社	得る	core_companyテーブルで既存の会社を検索
/api/now/table/core_company/{sys_id}	パッチ	core_companyテーブルの会社レコードを更新
/api/now/v1/batch	役職	1回の呼び出しで、グループ、ロール、委任、タグ、アプリケーション/会社共有リクエストを一括実行

ユーザーのプル

Endpoint: GET /api/now/table/sys_user

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Query Parameters:

パラメータ	デスクリプション
sysparm_limit	10000
sysparm_offset	Pagination offset
sysparm_fields	返すフィールドのコンマ区切りリスト
sysparm_exclude_reference_link	true
sysparm_display_value	all
sysparm_query	active=true — 「非アクティブなユーザーを取得」が選択されていない場合にのみ含まれます

Sample Response:

{
  "result": [
    {
      "sys_id": {
        "display_value": "005d500b536073005e0addeeff7b12f4",
        "value": "005d500b536073005e0addeeff7b12f4"
      },
      "email": {
        "display_value": "survey.user@email.com",
        "value": "survey.user@email.com"
      },
      "user_name": {
        "display_value": "survey.user",
        "value": "survey.user"
      },
      "name": {
        "display_value": "survey user",
        "value": "survey user"
      },
      "failed_attempts": {
        "display_value": "0",
        "value": "0"
      },
      "password_needs_reset": {
        "display_value": "false",
        "value": "false"
      },
      "active": {
        "display_value": "true",
        "value": "true"
      },
      "last_login_time": {
        "display_value": "2019-04-05 15:16:30",
        "value": "2019-04-05 22:16:30"
      },
      "vip": {
        "display_value": "false",
        "value": "false"
      },
      "business_criticality": {
        "display_value": "3 - Non-critical",
        "value": "3"
      },
      "internal_integration_user": {
        "display_value": "false",
        "value": "false"
      },
      "web_service_access_only": {
        "display_value": "false",
        "value": "false"
      },
      "identity_type": {
        "display_value": "-",
        "value": "unclassified"
      },
      "federated_id": {
        "display_value": "UU/OJDA/H2viaQb8VqlJIYSYKwmbkOCLoFDQkTPv7XM=",
        "value": "UU/OJDA/H2viaQb8VqlJIYSYKwmbkOCLoFDQkTPv7XM="
      },
      "manager.email": {
        "display_value": "",
        "value": ""
      },
      "company.name": {
        "display_value": "",
        "value": ""
      },
      "department.name": {
        "display_value": "",
        "value": ""
      },
      "source": {
        "display_value": "",
        "value": ""
      }
    }
  ]
}

デバイスの取得

Endpoint: GET /api/now/table/cmdb_ci_computer

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Query Parameters:

パラメータ	デスクリプション
sysparm_limit	10000
sysparm_offset	Pagination offset
sysparm_fields	返すフィールドのコンマ区切りリスト
sysparm_exclude_reference_link	true
sysparm_display_value	all

Sample Response:

{
  "result": [
    {
      "sys_id": {
        "display_value": "00a96c0d3790200044e0bfc8bcbe5db4",
        "value": "00a96c0d3790200044e0bfc8bcbe5db4"
      },
      "name": {
        "display_value": "MacBook Pro 15\"",
        "value": "MacBook Pro 15\""
      },
      "serial_number": {
        "display_value": "ABE-486-V17263-DO",
        "value": "ABE-486-V17263-DO"
      },
      "ip_address": {
        "display_value": "",
        "value": ""
      },
      "mac_address": {
        "display_value": "",
        "value": ""
      },
      "fqdn": {
        "display_value": "",
        "value": ""
      },
      "dns_domain": {
        "display_value": "",
        "value": ""
      },
      "life_cycle_stage": {
        "display_value": "",
        "value": ""
      },
      "life_cycle_stage_status": {
        "display_value": "",
        "value": ""
      },
      "warranty_expiration": {
        "display_value": "",
        "value": ""
      },
      "attested": {
        "display_value": "false",
        "value": "false"
      },
      "attestation_status": {
        "display_value": null,
        "value": ""
      },
      "attestation_score": {
        "display_value": "",
        "value": ""
      },
      "unverified": {
        "display_value": "false",
        "value": "false"
      },
      "virtual": {
        "display_value": "false",
        "value": "false"
      },
      "fault_count": {
        "display_value": "0",
        "value": "0"
      },
      "environment": {
        "display_value": null,
        "value": ""
      },
      "discovery_source": {
        "display_value": null,
        "value": ""
      },
      "asset_tag": {
        "display_value": "P1000503",
        "value": "P1000503"
      },
      "assigned_to.email": {
        "display_value": "eduardo.bellendir@example.com",
        "value": "eduardo.bellendir@example.com"
      },
      "managed_by": {
        "display_value": "",
        "value": ""
      },
      "most_frequent_user": {
        "display_value": "",
        "value": ""
      },
      "owned_by": {
        "display_value": "",
        "value": ""
      }
    }
  ]
}

アプリケーションのプル

Endpoint: GET /api/now/table/cmdb_ci_business_app

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Query Parameters:

パラメータ	デスクリプション
sysparm_limit	10000
sysparm_offset	Pagination offset
sysparm_fields	返すフィールドのカンマ区切りリスト（クライアント側のエコーフィルタリング用にdiscovery_sourceフィールドが追加されます）
sysparm_exclude_reference_link	true
sysparm_display_value	all

Sample Response:

{
  "result": [
    {
      "sys_id": {
        "display_value": "5d935f86835e8b104f7556a6feaad35b",
        "value": "5d935f86835e8b104f7556a6feaad35b"
      },
      "name": {
        "display_value": "CrowdStrike",
        "value": "CrowdStrike"
      },
      "asset_tag": {
        "display_value": "",
        "value": ""
      },
      "short_description": {
        "display_value": "",
        "value": ""
      },
      "comments": {
        "display_value": "[Netskope CE] Last shared at: 2026-07-27 07:22:09Z\nApplication Name: CrowdStrike, Cloud Confidence Index: 1, CCL: low, Category Name: NetskopeAPP, Deep Link: netskope.com\n",
        "value": "[Netskope CE] Last shared at: 2026-07-27 07:22:09Z\nApplication Name: CrowdStrike, Cloud Confidence Index: 1, CCL: low, Category Name: NetskopeAPP, Deep Link: netskope.com\n"
      },
      "url": {
        "display_value": "https://app.netskope.example/app/CrowdStrike",
        "value": "https://app.netskope.example/app/CrowdStrike"
      },
      "vendor.name": {
        "display_value": "",
        "value": ""
      },
      "manufacturer.name": {
        "display_value": "",
        "value": ""
      },
      "category": {
        "display_value": "XDR",
        "value": "XDR"
      },
      "subcategory": {
        "display_value": "",
        "value": ""
      },
      "business_criticality": {
        "display_value": null,
        "value": ""
      },
      "data_classification": {
        "display_value": null,
        "value": ""
      },
      "operational_status": {
        "display_value": "Operational",
        "value": "1"
      },
      "install_status": {
        "display_value": "In Production",
        "value": "1"
      },
      "life_cycle_stage.name": {
        "display_value": null,
        "value": ""
      },
      "life_cycle_stage_status.name": {
        "display_value": null,
        "value": ""
      },
      "product_support_status": {
        "display_value": null,
        "value": ""
      },
      "certified": {
        "display_value": "false",
        "value": "false"
      },
      "attested": {
        "display_value": "false",
        "value": "false"
      },
      "attestation_status": {
        "display_value": "Not Yet Reviewed",
        "value": "Not Yet Reviewed"
      },
      "attestation_score": {
        "display_value": "",
        "value": ""
      },
      "environment": {
        "display_value": null,
        "value": ""
      },
      "application_type": {
        "display_value": null,
        "value": ""
      },
      "next_assessment_date": {
        "display_value": "",
        "value": ""
      },
      "active": {
        "display_value": "true",
        "value": "true"
      },
      "owned_by.email": {
        "display_value": "",
        "value": ""
      },
      "managed_by.email": {
        "display_value": "",
        "value": ""
      },
      "it_application_owner.email": {
        "display_value": "",
        "value": ""
      },
      "application_manager.email": {
        "display_value": "",
        "value": ""
      },
      "support_group.name": {
        "display_value": "",
        "value": ""
      },
      "company.name": {
        "display_value": "",
        "value": ""
      },
      "user_base": {
        "display_value": null,
        "value": ""
      },
      "active_user_count": {
        "display_value": "",
        "value": ""
      },
      "discovery_source": {
        "display_value": null,
        "value": ""
      },
      "sys_updated_on": {
        "display_value": "2026-07-28 01:49:06",
        "value": "2026-07-28 08:49:06"
      }
    }
  ]
}

グループを取得

Endpoint: GET /api/now/table/sys_user_group

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Query Parameters:

パラメータ	デスクリプション
sysparm_fields	sys_id,name
sysparm_limit	10000
sysparm_offset	Pagination offset
sysparm_exclude_reference_link	true

Sample Response:

{
  "result": [
    { "sys_id": "019ad92ec7230010393d265c95c260dd", "name": "Analytics Settings Managers" }
  ]
}

ロールを取得

Endpoint: GET /api/now/table/sys_user_role

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Query Parameters:

パラメータ	デスクリプション
sysparm_fields	sys_id,name
sysparm_limit	10000
sysparm_offset	Pagination offset
sysparm_exclude_reference_link	true

Sample Response:

{
  "result": [
    { "sys_id": "011ba5aa0a0a0b3001a439c580549134", "name": "role_delegator" }
  ]
}

電子メール/ユーザー名の値をシステムIDに変換

Endpoint: GET /api/now/table/sys_user

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Query Parameters:

パラメータ	デスクリプション
sysparm_query	emailIN\<v1,v2,…\>^ORuser_nameIN\<v1,v2,…\>
sysparm_fields	sys_id,電子メール,user_name
sysparm_limit	10000

Sample Response:

{
  "result": [
    {
      "sys_id": "005d500b536073005e0addeeff7b12f4",
      "user_name": "survey.user",
      "email": "survey.user@email.com"
    },
    {
      "sys_id": "02826bf03710200044e0bfc8bcbe5d55",
      "user_name": "jimmie.barninger",
      "email": "jimmie.barninger@example.com"
    }
  ]
}

ユーザーグループ

Check if Group exists

Endpoint: GET /api/now/table/sys_user_group?sysparm_query=name=<group_name>

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Query Parameters:

パラメータ	デスクリプション
sysparm_query	name=\<group_name\>
sysparm_fields	sys_id,name

Sample Response:

{
  "result": [
    { "sys_id": "019ad92ec7230010393d265c95c260dd", "name": "Analytics Settings Managers" }
  ]
}

Create Group

Endpoint: POST /api/now/table/sys_user_group

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Request Body:

{ "name": "<group name>" }

Sample Response:

{
  "result": {
    "sys_id": "0b22a56a83d28f104f7556a6feaad354",
    "name": "Netskope-CE-Doc-Test-Group-1785236837",
    "active": "true",
    "exclude_manager": "false",
    "include_members": "false"
  }
}

Check User group membership

Endpoint: GET /api/now/table/sys_user_grmember 

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Query Parameters:

パラメータ	デスクリプション
sysparm_query	user=\<uid\>^group=\<gid\>
sysparm_fields	sys_id
sysparm_limit	1 — remove-branchルックアップでは省略

Sample Response:

{
  "result": [
    { "sys_id": "2f22296a83d28f104f7556a6feaad31d" }
  ]
}

Add User to group

Endpoint: POST /api/now/table/sys_user_grmember — 追加

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Request Body:

{ "user": "<uid>", "group": "<gid>" }

Sample Response:

{
  "result": {
    "sys_id": "2f22296a83d28f104f7556a6feaad31d",
    "user": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user/005d500b536073005e0addeeff7b12f4",
      "value": "005d500b536073005e0addeeff7b12f4"
    },
    "group": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user_group/0b22a56a83d28f104f7556a6feaad354",
      "value": "0b22a56a83d28f104f7556a6feaad354"
    }
  }
}

Remove User from Group

Endpoint: DELETE /api/now/table/sys_user_grmember/{sys_id} — 削除

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Sample Response:

204 No Content

ユーザーロール

Check if role is assigned to User

Endpoint: GET /api/now/table/sys_user_has_role

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Query Parameters:

パラメータ	デスクリプション
sysparm_query	user=\<uid\>^role=\<rid\>
sysparm_fields	sys_id
sysparm_limit	1 — remove-branchルックアップでは省略

Sample Response:

{
  "result": [
    { "sys_id": "e4526d6a83d28f104f7556a6feaad3b9" }
  ]
}

Add role to User

Endpoint: POST /api/now/table/sys_user_has_role — 追加

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Request Body:

{ "user": "<uid>", "role": "<rid>" }

Sample Response:

{
  "result": {
    "sys_id": "e4526d6a83d28f104f7556a6feaad3b9",
    "state": "active",
    "inherited": "false",
    "user": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user/005d500b536073005e0addeeff7b12f4",
      "value": "005d500b536073005e0addeeff7b12f4"
    },
    "role": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user_role/011ba5aa0a0a0b3001a439c580549134",
      "value": "011ba5aa0a0a0b3001a439c580549134"
    },
    "granted_by": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user_group/not-applicable",
      "value": "not-applicable"
    }
  }
}

Remove Role from User

Endpoint: DELETE /api/now/table/sys_user_has_role/{sys_id} — 削除

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Sample Response:

204 No Content

ユーザー委任

Check if user delegation exists

Endpoint: GET /api/now/table/sys_user_delegate

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Query Parameters:

パラメータ	デスクリプション
sysparm_query	user=\<uid\>^delegate=\<did\>
sysparm_fields	プレ削除ルックアップで、sys_id、approvals、assignments、notifications、invitationsをsys_idのみに削減
sysparm_limit	1

Sample Response:

{
  "result": [
    { "sys_id": "2462a1aa83d28f104f7556a6feaad31c" }
  ]
}

Create user delegation record

Endpoint: POST /api/now/table/sys_user_delegate — 作成（既存の行なし、≥1つの設定を選択）

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Request Body:

{
  "user": "<uid>",
  "delegate": "<did>",
  "starts": "<start date>",
  "ends": "<end date>",
  "approvals": "true",
  "assignments": "true",
  "notifications": "true",
  "invitations": "true"
}

Sample Response:

{
  "result": {
    "sys_id": "2462a1aa83d28f104f7556a6feaad31c",
    "user": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user/005d500b536073005e0addeeff7b12f4",
      "value": "005d500b536073005e0addeeff7b12f4"
    },
    "delegate": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user/02826bf03710200044e0bfc8bcbe5d3f",
      "value": "02826bf03710200044e0bfc8bcbe5d3f"
    },
    "starts": "2026-07-28 00:00:00",
    "ends": "2026-08-27 00:00:00",
    "approvals": "true",
    "assignments": "true",
    "notifications": "true",
    "invitations": "true"
  }
}

Update User delegation record

Endpoint: PATCH /api/now/table/sys_user_delegate/{sys_id}

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Request Body:

{
  "approvals": "false",
  "assignments": "true",
  "notifications": "false",
  "invitations": "true"
}

Sample Response:

{
  "result": {
    "sys_id": "85ec852f83d687504f7556a6feaad3d3",
    "user": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user/005d500b536073005e0addeeff7b12f4",
      "value": "005d500b536073005e0addeeff7b12f4"
    },
    "delegate": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user/02826bf03710200044e0bfc8bcbe5d55",
      "value": "02826bf03710200044e0bfc8bcbe5d55"
    },
    "starts": "2026-07-31 00:00:00",
    "ends": "2026-08-30 00:00:00",
    "approvals": "false",
    "assignments": "true",
    "notifications": "false",
    "invitations": "true"
  }
}

Delete User delegation record

Endpoint: DELETE /api/now/table/sys_user_delegate/{sys_id}

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Sample Response:

204 No Content

デバイスタグの管理

Check if device tag already exists

Endpoint: GET /api/now/table/cmdb_key_value

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Query Parameters:

パラメータ	デスクリプション
sysparm_query	configuration_item=\<ci\>^key=\<key\> — addブランチの存在チェック用に、^value=\<v\>句が追加されます。
sysparm_fields	sys_id

Sample Response:

{
  "result": [
    { "sys_id": "048265aa83d28f104f7556a6feaad378" }
  ]
}

Tag Device

Endpoint: POST /api/now/table/cmdb_key_value

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Request Body:

{ "configuration_item": "<ci>", "key": "<key>", "value": "<value>" }

Sample Response:

{
  "result": {
    "sys_id": "048265aa83d28f104f7556a6feaad378",
    "configuration_item": {
      "link": "https://your-instance.service-now.com/api/now/table/cmdb_ci/00a96c0d3790200044e0bfc8bcbe5db4",
      "value": "00a96c0d3790200044e0bfc8bcbe5db4"
    },
    "key": "NetskopeCE",
    "value": "Doc-Test-Value"
  }
}

Untag Device

Endpoint: DELETE /api/now/table/cmdb_key_value/{sys_id}

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Sample Response:

204 No Content

アプリケーションタグを管理

Check if application tag exists

Endpoint: GET /api/now/table/cmdb_key_value

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Query Parameters:

パラメータ	デスクリプション
sysparm_query	configuration_item=\<ci\>^key=\<key\>^value=\<v\>
sysparm_fields	sys_id

Sample Response:

{
  "result": [
    { "sys_id": "048265aa83d28f104f7556a6feaad378" }
  ]
}

Tag Application

Endpoint: POST /api/now/table/cmdb_key_value — アプリケーションCIにタグ付け

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Request Body:

{ "configuration_item": "<ci>", "key": "<key>", "value": "<value>" }

Sample Response:

{
  "result": {
    "sys_id": "cc9265aa83d28f104f7556a6feaad3e0",
    "configuration_item": {
      "link": "https://your-instance.service-now.com/api/now/table/cmdb_ci/5d935f86835e8b104f7556a6feaad35b",
      "value": "5d935f86835e8b104f7556a6feaad35b"
    },
    "key": "NetskopeCE",
    "value": "Doc-Test-Value"
  }
}

Untag Application

Endpoint: DELETE /api/now/table/cmdb_key_value/{sys_id}

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Sample Response:

204 No Content

アプリケーションデータを共有 — CMDB CIビジネスアプリパス

Search Application by Name

Endpoint: GET /api/now/table/cmdb_ci_business_app

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Query Parameters:

パラメータ	デスクリプション
sysparm_query	name=\<app\>
sysparm_fields	sys_id,discovery_source

Sample Response:

{
  "result": []
}

Create Application Record

Endpoint: POST /api/now/table/cmdb_ci_business_app — 作成（既存の一致なし）

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Request Body:

{
  "name": "<app name>",
  "comments": "<summary block>",
  "discovery_source": "NetskopeCloudExchange"
}

Sample Response:

{
  "result": {
    "sys_id": "94a269aa83d28f104f7556a6feaad3f3",
    "name": "Netskope-CE-Doc-Test-App-1785236955",
    "discovery_source": "NetskopeCloudExchange",
    "comments": "[Netskope CE] Last shared at: 2026-07-28 11:00:00Z\nApplication Name: Netskope-CE-Doc-Test-App-1785236955, Cloud Confidence Index: 32, CCL: Poor, Category Name: Cloud Storage, Deep Link: https://example.com/app\n",
    "active": "true",
    "install_status": "1",
    "operational_status": "1"
  }
}

Update Application Record

Endpoint: PATCH /api/now/table/cmdb_ci_business_app/{sys_id} — 更新（既存の一致あり — コメントを置換）

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Request Body:

{ "comments": "<summary block>" }

Sample Response:

{
  "result": {
    "sys_id": "94a269aa83d28f104f7556a6feaad3f3",
    "name": "Netskope-CE-Doc-Test-App-1785236955",
    "discovery_source": "NetskopeCloudExchange",
    "comments": "[Netskope CE] Last shared at: 2026-07-28 12:00:00Z\nApplication Name: Netskope-CE-Doc-Test-App, Cloud Confidence Index: 45, CCL: Fair, Category Name: Cloud Storage, Deep Link: https://example.com/app\n",
    "sys_mod_count": "1"
  }
}

アプリケーションデータの共有 — 中核会社

Fetch Company details

Endpoint: GET /api/now/table/core_company

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Query Parameters:

パラメータ	デスクリプション
sysparm_query	アクション用に設定されたCompany、Parent Company、Operatorの値から構築されます。
sysparm_fields	sys_id,name,notes
sysparm_limit	10000

Sample Response:

{
  "result": {
    "sys_id": "0c43b088c6112275011a4bd46a4e6cc4",
    "name": "GenuineIntel",
    "notes": ""
  }
}

Update Company details

Endpoint: PATCH /api/now/table/core_company/{sys_id}

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Request Body:

{ "notes": "<block(s)>\n\n<existing notes>" }

Sample Response:

{
  "result": {
    "sys_id": "0c43b088c6112275011a4bd46a4e6cc4",
    "name": "GenuineIntel",
    "notes": "[Netskope CE] Last shared at: 2026-07-28 12:00:00Z\nApplication Name: Netskope-CE-Doc-Test-App, Cloud Confidence Index: 45, CCL: Fair, Category Name: Cloud Storage, Deep Link: https://example.com/app\n"
  }
}

バッチAPI

Endpoint: POST /api/now/v1/batch

Request Headers:

鍵	Value
Authorization	Basic base64(username:password)
ユーザーエージェント	netskope-ce-6.1.0-cre-servicenow-v2.0.0

Request Body:

{
  "batch_request_id": "netskope-ce-<tag>-<chunk_index>",
  "rest_requests": [
    {
      "id": "1",
      "method": "GET",
      "url": "/api/now/table/sys_user_grmember?sysparm_query=user%3D...&sysparm_fields=sys_id&sysparm_limit=1",
      "exclude_response_headers": true,
      "headers": [
        { "name": "Content-Type", "value": "application/json" },
        { "name": "Accept", "value": "application/json" }
      ],
      "body": "<base64 of the JSON body>"
    }
  ]
}

Sample Response:

{
  "batch_request_id": "netskope-ce-group-add-1",
  "serviced_requests": [
    { "id": "1", "status_code": 201, "body": "<base64 of the JSON body>" }
  ],
  "unserviced_requests": ["7", "8"]
}

Example — Add Users to Groups (`sys_user_grmember`):

リクエスト：

{
  "batch_request_id": "netskope-ce-group-add-1",
  "rest_requests": [
    {
      "id": "1",
      "method": "POST",
      "url": "/api/now/table/sys_user_grmember",
      "headers": [
        { "name": "Content-Type", "value": "application/json" },
        { "name": "Accept", "value": "application/json" }
      ],
      "body": "eyJ1c2VyIjogIjAwNWQ1MDBiNTM2MDczMDA1ZTBhZGRlZWZmN2IxMmY0IiwgImdyb3VwIjogImU1ZDI2MWVhODNkMjhmMTA0Zjc1NTZhNmZlYWFkMzc4In0="
    }
  ]
}

サブレスポンス本文（base64デコード済み）：

{
  “result”: {
    “sys_id”: “9ed2a1ea83d28f104f7556a6feaad332”,
    “user”: {
      “link”: “https://your-instance.service-now.com/api/now/table/sys_user/005d500b536073005e0addeeff7b12f4”,
     “value”: “005d500b536073005e0addeeff7b12f4”
    },
    “group”: {
      “link”: “https://your-instance.service-now.com/api/now/table/sys_user_group/e5d261ea83d28f104f7556a6feaad378”,
     “value”: “e5d261ea83d28f104f7556a6feaad378”
    }
  }
}

Example — Tag Applications/Devices (`cmdb_key_value`):

リクエスト：

{
  "batch_request_id": "netskope-ce-tag-add-1",
  "rest_requests": [
    {
      "id": "1",
      "method": "POST",
      "url": "/api/now/table/cmdb_key_value",
      "headers": [
        { "name": "Content-Type", "value": "application/json" },
        { "name": "Accept", "value": "application/json" }
      ],
      "body": "eyJjb25maWd1cmF0aW9uX2l0ZW0iOiAiMDBhOTZjMGQzNzkwMjAwMDQ0ZTBiZmM4YmNiZTVkYjQiLCAia2V5IjogIk5ldHNrb3BlQ0UiLCAidmFsdWUiOiAiRG9jLVRlc3QtVmFsdWUifQ=="
    }
  ]
}

サブレスポンス本文（base64デコード済み）：

{
  "result": {
    "sys_id": "43e2a1ea83d28f104f7556a6feaad346",
    "configuration_item": {
      "link": "https://your-instance.service-now.com/api/now/table/cmdb_ci/00a96c0d3790200044e0bfc8bcbe5db4",
      "value": "00a96c0d3790200044e0bfc8bcbe5db4"
    },
    "key": "NetskopeCE",
    "value": "Doc-Test-Value"
  }
}

Example — Share Applications (`cmdb_ci_business_app`):

リクエスト：

{
  "batch_request_id": "netskope-ce-share-app-share-1",
  "rest_requests": [
    {
      "id": "1",
      "method": "POST",
      "url": "/api/now/table/cmdb_ci_business_app",
      "headers": [
        { "name": "Content-Type", "value": "application/json" },
        { "name": "Accept", "value": "application/json" }
      ],
      "body": "<base64 of {\"name\": \"...\", \"comments\": \"...\", \"discovery_source\": \"NetskopeCloudExchange\"}>"
    }
  ]
}

サブレスポンス本文（Base64デコード後、空でないフィールドにトリミング済み — ServiceNowは約113列の行全体を返します）：

{
  "result": {
    "sys_id": "56f265ea83d28f104f7556a6feaad357",
    "name": "Netskope-CE-Doc-Test-BatchApp-1785237047",
    "discovery_source": "NetskopeCloudExchange",
    "comments": "[Netskope CE] Last shared at: 2026-07-28 11:00:00Z\nApplication Name: Netskope-CE-Doc-Test-BatchApp-1785237047, Cloud Confidence Index: 32, CCL: Poor, Category Name: Cloud Storage, Deep Link: https://example.com/app\n",
    "active": "true",
    "install_status": "1",
    "operational_status": "1"
  }
}

Example — Core Company path (`core_company`):

リクエスト（GETルックアップ）：

GET /api/now/table/core_company?sysparm_query=<query>&sysparm_fields=sys_id,name,notes

対応：

{
  "result": {
    "sys_id": "0c43b088c6112275011a4bd46a4e6cc4",
    "name": "GenuineIntel",
    "notes": ""
  }
}

リクエスト（PATCH更新）：

{ "notes": "<block(s)>\n\n<existing notes>" }

対応：

{
  "result": {
    "sys_id": "0c43b088c6112275011a4bd46a4e6cc4",
    "name": "GenuineIntel",
    "notes": "[Netskope CE] Last shared at: 2026-07-28 12:00:00Z\nApplication Name: Netskope-CE-Doc-Test-App, Cloud Confidence Index: 45, CCL: Fair, Category Name: Cloud Storage, Deep Link: https://example.com/app\n"
  }
}