Servicenow Cmdb
The ServiceNow CMBD can be used to find CI(Configuration Item) records in the ServiceNow CMDB(Configuration Management Database) and respectively pull the record enrichment.
Prerequisites
The ServiceNow CMBD connector requires an URL, an Username, and a Password to interact with the API.
Capabilities
This connector provides the following capabilities:
- Get CI Records
Notes
For more information about the API and its capabilities:
This plugin was last tested against product version: v1 API.
Configurations
HTTP Basic Authentication
Authenticates using username and password.
Configuration Parameters
Parameter | Description | Type | Required |
|---|---|---|---|
url | A URL to the target host. | string | Required |
username | Username | string | Required |
password | Password | string | Required |
verify_ssl | Verify SSL certificate | boolean | Optional |
http_proxy | A proxy to route requests through. | string | Optional |
Actions
Get CI Records
Returns the available configuration items (CI) for a specified Configuration Management Database (CMDB) class (table).
Endpoint
- URL: api/now/v1/table/{{className}}
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
path_parameters.className | string | Required | Parameters for the Get CI Records action |
parameters.sysparm_limit | number | Optional | Parameters for the Get CI Records action |
parameters.sysparm_offset | number | Optional | Parameters for the Get CI Records action |
parameters.sysparm_query | string | Optional | Parameters for the Get CI Records action |
Input Example
{"parameters":{"sysparm_limit":100,"sysparm_offset":0,"sysparm_query":"sysparm_query=operating_system=Windows"},"path_parameters":{"className":"cmdb_ci_linux_server"}}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
result | array | Result of the operation |
result.sys_id | string | Unique identifier |
result.name | string | Name of the resource |
Output Example
{"status_code":200,"response_headers":{"Set-Cookie":"JSESSIONID=D5DCFFBDAC700FA9E91AE22C11F4F6A2; Path=/; HttpOnly;Secure, glide_user...","Server-Timing":"sem_wait;dur=0, sesh_wait;dur=0","Content-Encoding":"gzip","X-Is-Logged-In":"true","X-Transaction-ID":"95fef03d1541","X-Total-Count":"4","X-Content-Type-Options":"nosniff","Pragma":"no-store,no-cache","Cache-Control":"no-cache,no-store,must-revalidate,max-age=-1","Expires":"0","Content-Type":"application/json;charset=UTF-8","Transfer-Encoding"...
Response Headers
Header | Description | Example |
|---|---|---|
Cache-Control | Directives for caching mechanisms | no-cache,no-store,must-revalidate,max-age=-1 |
Connection | HTTP response header: Connection | keep-alive |
Content-Encoding | HTTP response header: Content-Encoding | gzip |
Content-Type | The media type of the resource | application/json;charset=UTF-8 |
Date | The date and time at which the message was originated | Thu, 28 Sep 2023 12:55:08 GMT |
Expires | The date/time after which the response is considered stale | 0 |
Keep-Alive | HTTP response header: Keep-Alive | timeout=70 |
Pragma | HTTP response header: Pragma | no-store,no-cache |
Server | Information about the software used by the origin server | ServiceNow |
Server-Timing | HTTP response header: Server-Timing | sem_wait;dur=0, sesh_wait;dur=0 |
Set-Cookie | HTTP response header: Set-Cookie | JSESSIONID=D5DCFFBDAC700FA9E91AE22C11F4F6A2; Path=/; HttpOnly;Secure, glide_user=; Max-Age=0; Expires=Thu, 01-Jan-1970 00:00:10 GMT; Path=/; Secure; HttpOnly, glide_user_session=; Max-Age=0; Expires=Thu, 01-Jan-1970 00:00:10 GMT; Path=/; Secure; HttpOnly, glide_user_route=glide.516eb3ac9d9c5f64cf3e643031a64e92; Max-Age=2147483647; Expires=Tue, 16-Oct-2091 16:09:15 GMT; Path=/; Secure; HttpOnly, glide_session_store=51FEF03D472571107C36CD9BD36D4315; Max-Age=1800; Expires=Thu, 28-Sep-2023 13:25:08 GMT; Path=/; Secure; HttpOnly, BIGipServerpool_dev52829=999184138.50240.0000; path=/; Httponly; Secure |
Strict-Transport-Security | HTTP response header: Strict-Transport-Security | max-age=63072000; includeSubDomains |
Transfer-Encoding | HTTP response header: Transfer-Encoding | chunked |
X-Content-Type-Options | HTTP response header: X-Content-Type-Options | nosniff |
X-Is-Logged-In | HTTP response header: X-Is-Logged-In | true |
X-Total-Count | HTTP response header: X-Total-Count | 4 |
X-Transaction-ID | HTTP response header: X-Transaction-ID | 95fef03d1541 |