ServiceNow offers a developer sandbox to interact and develop against their APIs. If you want to try out the ServiceNow Notifer in Iguana XIguanaX, you’ll first need to login or signup for a ServiceNow developer account and create an App:
...
| Expand |
|---|
| title | Create an ssh key pair and upload the public key certificate file to your ServiceNow instance |
|---|
|
ServiceNow uses OAuth2.0 JWT API endpoint to authenticate external requests. Therefore we need to upload a public key to ServiceNow so it can verify the integrity of JWT tokens signed by clients (ie. Iguana X), ensuring secure authentication of external requests. Use OpenSSL command line to generate a key pair. You can use the following sample terminal commands:
| Code Block |
|---|
openssl genrsa -out private.pem 1024
openssl req -new -x509 -key private.pem -out public.cer -days 365 |
Upload the public key to the X.509 Certificates table. You’ll use the private key in Iguana later. Use the explorer in the All tab to navigate to System Definition > Certifications. Click New, fill out the required information and paste your public key.
  Image Removed Image Added |
| Expand |
|---|
| title | Create a REST API Auth Scope to provide access to the create scope for the ServiceNow Table API |
|---|
|
Navigate to System Web Services > API Auth Scopes > REST API Auth Scope Create a new auth scope with the appropriate permissions as shown in the screenshot: REST API: Table API Auth Scope: create new scope (ex. ticket_create)
 |
| Expand |
|---|
| title | Create an application endpoint (OAuth JWT API endpoint) |
|---|
|
Navigate to System OAuth > Application Registry, click New. Choose Create an OAuth JWT API endpoint for external clients and fill out the required details: Name: the name of the application endpoint (ex. IguanaX) OAuth Application User: a non-admin user account used to authenticate the connection. A new user can be created if necessary. (If this field is missing you can add it by right clicking the top grey bar > Configure > Form Design) Auth Scope: the scope of access that external clients connecting to this endpoint will have. Click Insert a new row, add ticket_create, the scope we previously created.
 Image Removed Image AddedClick Submit and then click on the newly created application. At the bottom of the page, click New to create a Jwt Verifier Map. For sys certificate, select the public key file you previously uploaded.
 Image Removed Image Added |
| Expand |
|---|
| title | Note down all the authentication details required for Iguana to authenticate |
|---|
|
From the current application endpoint page, note down the following fields for your Iguana X IguanaX component: Instance ID (ex. dev252204) Client ID Client Secret (automatically generated) Jwt Verifier Map Kid (automatically generated) User field (Email) associated with the selected OAuth Application User (ex. iguanax@demo.com)
 Image Removed Image AddedHead into Iguana X IguanaX to start setting up the ServiceNow Notifier! |
...