How to Set Up a Unito Service Account in ServiceNow to Sync Records

Create a dedicated service account with the right permissions to sync ServiceNow records to and from your tables with Unito.

In this article:

• Why create a service account?
• Prerequisites for creating a ServiceNow service account
• Set up a dedicated email address for your service account
• Create a new user in ServiceNow
• Managing permissions, tables and records
• Important Considerations

Why create a service account?

When Unito syncs information between ServiceNow and other tools, changes are attributed to the authorized user account. Using your personal account can lead to confusion and potential security concerns. By creating a separate service account, you:

• Clearly distinguish automated actions: Separate the activities performed by Unito from those of individual users.
• Maintain consistent flows: Avoid disruptions caused by changes to personal account credentials.
• Enhance security: Control the service account's permissions for a more secure integration.

Prerequisites for creating a ServiceNow service account:

• Admin Access: A ServiceNow administrator must assign the necessary role(s) to your service account. However, you don't need to be an admin yourself to create flows in Unito.
• Table Permissions: Your service account must have permission to create and edit records in the specific ServiceNow table(s) you intend to sync with Unito. These permissions are crucial for the service account to function properly and ensure successful data synchronization.

In the case of our demo, we gave our service account the itil role in order to sync records from an incidents table. 

Set up a dedicated email address for your service account

Before creating the ServiceNow service account, you'll need a dedicated email address for it. This helps distinguish its activities from those of individual users. 

Roughly, here's how to do this in Microsoft 365 and Google Workspace. If your company uses another email provider, consult their documentation for instructions on creating new users.

If your company uses Microsoft 365:

1. Go to the Microsoft 365 admin center.
2. Under Users, select Active users.
3. Click Add a user.
4. Follow the prompts to create a new user with a unique username and password.

If your company uses Google Workspace:

1. Go to the Google Admin console.
2. Click Users.
3. Click Add new user.
4. Follow the steps to enter the user's information and create an account.

Create a new user in ServiceNow

A ServiceNow admin must perform the following steps:

1. Navigate to All > User Administration > Users in your ServiceNow instance.
2. Click New.
3. Fill in the required fields, including:
   • Name: A descriptive name (e.g., "Unito Integration User")
   • User ID: A unique username
   • Email: A dedicated email address for the service account (e.g., unito-integration@yourcompany.com)
4. Ensure that Active is checked and Password needs reset and Locked out are unchecked.
5. Click Submit if this is a new user or Update if you're editing an existing user..

Managing roles, tables and records

Your service account needs to be able to create and edit records in order to connect to Unito and create flows with ServiceNow. So ensure the account has the correct role to access the tables you need access to and that those tables can be edited.

Configure table access

From System Definition, select Tables. Then, click the Application Access tab and ensure the following are checked:

• Can create
• Can read
• Can update
• Allow configuration

Then, click Update.

Assign roles and permissions

1. Next, navigate to the Roles tab under User Administration and click Edit.
2. Roles: From User Administration, select the Roles related list. Then, from the list of roles, click itil , incident_manager or an equivalent in your ServiceNow instance that provides your service account with CRUD access to the tables and records you want to sync.
3. Assign role: Under Related Links, click Users and then edit to seethe Collection list. Now, look for the service account that you just created and add them to the users list.
   
4. Save: Click Save to apply the changes.

Once this process is complete, you're ready to go. You can log in to Unito with your service account and create a flow.

Important Considerations

• Security: Granting admin privileges should be done cautiously. Ensure the person managing the service account understands the potential impact of their actions.
• Password Management: Create a strong password for the service account and store it securely.
• Test the Connection: Before using the service account for syncing, ensure that it can successfully authenticate with Unito and access the necessary ServiceNow data.
• Monitor Activity: Regularly review the service account's activity log to ensure it's functioning as expected and hasn't been compromised.
• Limit Permissions: Follow the principle of least privilege and only grant the service account the minimum permissions required for Unito to function.