Set up a ServiceNow connector
Capabilities
Sync user identities from ServiceNow to ConductorOne
Resources supported:
- Roles
- Groups
Add a new ServiceNow connector
This task requires either the Connector Administrator or Super Administrator role in ConductorOne.
In ConductorOne, click Connectors > Add connector.
Search for ServiceNow and click Add.
Choose how to set up the new ServiceNow connector:
Add the connector to a currently unmanaged app (select from the list of apps that were discovered in your identity, SSO, or federation provider that aren’t yet managed with ConductorOne)
Add the connector to a managed app (select from the list of existing managed apps)
Create a new managed app
Do you SSO into ServiceNow using your identity, SSO, or federation provider? If so, make sure to add the connector to the unmanaged ServiceNow app that was created automatically when you integrated your provider with ConductorOne, rather than creating a new managed app.
Set the owner for this connector. You can manage the connector yourself, or choose someone else from the list of ConductorOne users. Setting multiple owners is allowed.
A ServiceNow connector owner must have the following permissions:
Connector Administrator or Super Administrator role in ConductorOne
Admin role in ServiceNow or an access control list able to access the following ServiceNow tables:
sys_user
- Userssys_user_role
- Rolessys_user_group
- Groupssys_user_grmember
- Group membershipsys_user_has_role
- User rolessys_group_has_role
- Group roles
- Click Next.
Next steps
If you are the connector owner, proceed to Configure your ServiceNow connector for instructions on integrating ServiceNow with ConductorOne.
If someone else is the connector owner, ConductorOne will notify them by email that their help is needed to complete the setup process.
Configure your ServiceNow connector
A user with the Connector Administrator or Super Administrator role in ConductorOne and an Admin role in ServiceNow (or access to the tables listed above via an access control list) must perform this task.
Step 1: Locate your ServiceNow deployment
Look up your ServiceNow deployment, which is found in the URL of your ServiceNow instance. For example, if your URL is https://example12345.service-now.com, your deployment ID is example12345.
Make a note of your deployment. We’ll use it in Step 2.
Step 2: Add your ServiceNow credentials to ConductorOne
In ConductorOne, navigate to the ServiceNow connector by either:
Clicking the Set up connector link in the email you received about configuring the connector.
Navigate to Connectors > ServiceNow (if there is more than one ServiceNow listed, click the one with your name listed as owner and the status Not connected).
Find the Settings area of the page and click Edit.
In the Deployment field, enter the ServiceNow deployment you looked up in Step 1.
In the Password and Username fields, enter the credentials for your ServiceNow account.
The user whose credentials you enter must have either the Admin role in ServiceNow or an access control list able to access the following ServiceNow tables:
sys_user
- Userssys_user_role
- Rolessys_user_group
- Groupssys_user_grmember
- Group membershipsys_user_has_role
- User rolessys_group_has_role
- Group roles
Optional. If you want to automatically create ServiceNow tickets to track provisioning tasks, click to Enable external tick processing. Read more about external ticketing system integrations here.
If you enable this option, you can add a catalog ID or category ID to filter down catalog items. These fields are optional, but ConductorOne only syncs 100 catalog items, so filtering is recommended.
Click Save.
The connector’s label changes to Syncing, followed by Connected. You can view the logs to ensure that information is syncing.
That’s it! Your ServiceNow connector is now pulling access data into ConductorOne.
Configure the ServiceNow integration using Terraform
As an alternative to the integration process described above, you can use Terraform to configure the integration between ServiceNow and ConductorOne.
See the ConductorOne ServiceNow integration resource page in the ConductorOne Terraform registry for example usage and the full list of required and optional parameters.