Ardoq’s ServiceNow integration is a two-way integration that allows you to:
Import your data as components or references into Ardoq so you can visualize the dependencies that exist between them and other components in your architecture such as applications, departments, people, etc.
Export your modified ServiceNow data from Ardoq to ServiceNow to maintain your data up to date at all times. Read our ServiceNow Export article for more details.
With Ardoq’s ServiceNow integration, you can also automate imports by setting a daily or weekly interval schedule.
ServiceNow Setup
Install the Ardoq add-on on your ServiceNow instance
Navigate to the ServiceNow Store and install the Ardoq ServiceNow Add-on.
Note: You will need ServiceNow HI credentials to install add-ons. Contact your company ServiceNow admin if needed.
Log in to your ServiceNow instance and set up an integration user
We recommend that you create a dedicated integrations-specific user with table-permissions limited to exactly the data you want to sync with Ardoq.
Note: Assign the role x_ardas_ardoq_int.rest
to your integration user. Without this role, the user won’t be able to use the integration. Additionally, multi-factor authentication should be disabled by default for the integration user.
Ardoq Setup
From the main menu, navigate to Home > Import and integrations and select ServiceNow.
Select the Connections tab and click Create new connection
In the dialog that appears, fill in the following details:
Connection name: A relevant name for your ServiceNow connection.
Base URL: The URL to your ServiceNow instance.
Authentication type: Select an authentication type — basic or OAuth — and fill in the relevant credentials.
Note: Make sure that the Base URL doesn't contain /login.do at the end.
Click Create connection to finalize your changes.
Importing Data from ServiceNow
With your connection ready, you can click Create new import from the ServiceNow integration page.
On the Select data tab, select the connection you just created and Ardoq will fetch the tables from your ServiceNow instance.
Note: Tables fetched from ServiceNow depend on the provided user's permissions.
Select the tables and the relevant fields you want to import into Ardoq.
Note: Reference fields will show two entries in the field list: the label of the reference and the ServiceNow sys-id of the referenced record. This will allow you to create references based on either the ID or name.
Proceed to the Configure data step when you're ready and map your ServiceNow fields into Ardoq using the standard configuration process.
Scheduling Your Import
After a successful test successful import, you can schedule Ardoq to perform daily or weekly imports of your configured tables.
When scheduling an import, you can choose to disable manual data changes in the workspace. Enabling this ensures your workspace mirrors the source data. For more details, read our article on data sync strategies on import.
ServiceNow Integration Permissions for Ardoq
Basic Permissions
The ServiceNow integration is flexible — there are no restrictions on the data you can import from ServiceNow.
Once the Ardoq Integration add-on is installed from the ServiceNow store, an Ardoq user account with the specific role x_ardas_ardoq_int.rest
is required.
For security and efficiency, ensure the integration user has access only to necessary tables for importing and exporting data, aligning with the principle of least privilege.
It's critical to define Groups, Roles, and Access Control Lists (ACLs) in ServiceNow accurately. Precise ACL privileges are needed on tables for read, create, write, and delete operations.
Ensure that the integration user has canRead
privileges with the group x_ardas_ardoq_int.rest
assigned to these operations. For exporting data from Ardoq to ServiceNow, canCreate
, canWrite,
and canDelete
privileges must be enabled for the integration user.
ACL Rules
You'll need to ensure that the following rules are properly set up:
User Roles: Match ServiceNow roles with required access levels in Ardoq.
Table Level ACL Rules: Control the integration user’s access to necessary tables.
Access controls within ServiceNow should be configured based on the roles assigned to tables to ensure appropriate read and write operations are maintained. Additionally, it's crucial to activate these rules to enforce the access control effectively. After setting up these role-based access permissions and activating them, the integration user should gain the necessary visibility of the table.
Field Level ACL Rules: Manage permissions at the field level within tables. Remember, field-level ACL rules can supersede table-level ACL rules.
When exporting from Ardoq to ServiceNow, the integration user must have the capabilities to write and delete.
Remember to double-check User Roles, Table-level, and Field-level ACL rules to maintain secure integration. Field-level ACLs can override broader ACL policies.
Refer to the ServiceNow documentation for a complete guide on setting up ACL rules: Access Control Rules and Creating an ACL Rule.
To ensure seamless integration between ServiceNow and Ardoq, the integration user must have the following combination of roles:
X_ardas_ardoq_int.rest: Core Ardoq integration role.
Sn_cmdb_user: Provides read access to specific CMDB tables, the CMDB class manager hierarchy, relationships, and service maps.
Service_viewer: Allows read access to every table in CMDB as all tables inherit from
cmdb_ci
.
FAQ
Does the Ardoq integration with Servicenow allow import of all tables or just CMDB tables?
As long as the integration user being used for the ServiceNow integration has the appropriate read permissions in ServiceNow then all the tables can be retrieved.
Is it possible to specify which fields are/aren't bi-directional?
The import is a one-way update; there are no two-way fields.
What happens if the exact same field in Ardoq and Servicenow is updated at the same time? Which takes precedence?
Data from ServiceNow will override data at Ardoq side on import because it is 1-way update.
ServiceNow Pre-fetch Filtering
You have the flexibility to define a filter to refine the dataset before forwarding it to Ardoq. Keep in mind that you'll have to create a filter specific to ServiceNow using the sysparm_query format.
Error when fetching tables
Verify that the HTTP response time and size is adequate for the number of records being imported. Increase the limit if you get a fetch error.
Establishing a connection using a custom domain
Configure the gateway on port 443
to make sure there are no egress/outgoing traffic issues or the connection will be rejected.