ServiceNow can be used as either a Source or Target Server (subject to Licencing)
To use ServiceNow as the Source Server, select ServiceNow from the Source Server Type dropdown.
To use ServiceNow as the Target Server, select ServiceNow from the Target Server Type dropdown.
The connection details will be displayed and must be completed as follows:
By default, the authentication method is username / password. Enter the ServiceNow URL, User Name and Password. Note that this must be a user with Administrator level access to the ServiceNow application, unless specific roles have been pre-configured for Precision Bridge (contact Precision Bridge support for more information on required roles for non-admin access).
If you want to retain the login details to be reused next time the project is opened, select the Save Authentication option. After selecting this option, the username and password are stored and do not need to be entered again the next time you open the same project from the same client machine. Otherwise, you will need to re-enter them each time you open the project.
Testing the Connection
In order to check that the instance can be accessed using the credentials provided, click on the Test button on the right.
If the selected instance is reachable then a confirmation message will be displayed. If the instance is not reachable then a failure/timeout message will be displayed. Correct the Instance URL, User Name and Password, and try the test again. If the instance is still not reachable, check that you can connect using a browser with the same URL username and password.
Proxy Settings
If you are connecting through a proxy server, you must enter the proxy details as well. Click on the Proxy tab and enter the Proxy Address and Port Number. If your proxy requires username/password credentials, enter these in the fields provided.
There is also an option to save the proxy authentication (username and password) if used. To avoid needing to enter the proxy username/password each time you connect, you can use the Save Authentication option.
OAUTH2 Settings
Precision Bridge supports OAuth2 in authenticating API requests to Service Now. To use this, your Service Now instance must be configured to use OAuth2 and your Authentication Server must be configured to grant access tokens for this instance.
There are 2 OAuth options, and which one you use will depend on how OAuth2 is configured on your system. Ask your ServiceNow Administrator for more advice.
OAuth2 (Password)
If using this method, you will still need to provide your username and password. This will be passed once only to the authentication server.
You will also need to enter the OAuth2 details (see later section)
OAuth2 (Credentials)
If using this method, you do not need to provide your username and password. The Authentication Server will encode the user who is permitted access using these credentials within the token that gets passed to Service Now.
You will also need to enter the OAuth2 details (see later section)
On the OAuth2 tab, you will need to provide your Oauth2 client id and client secret.
Entering OAuth2 Details
On the OAuth2 Details tab, you will need to enter your OAUTH2 client id and client secret. Contact your ServiceNow Administrator to obtain these. They are normally stored in the application registry on ServiceNow.
If the ServiceNow server you are connecting to is also your OAuth2 Authentication Server, you do not need to provide an authentication endpoint. If another server is being used for OAuth2 authentication, provide the endpoint that should be called to obtain access tokens.
Some authentication servers (notably Microsift Identity Provider) require a scope parameter as well. If you are using a ServiceNow instance as an Authentication server, you do not normally need to provide this. Contact your ServiceNow Administrator for clarification.
If you have a proxy defined for the connection and calls to the authentication endpoint requires use of a proxy, you should check the 'Use Proxy' option.
Test the connection using the Test Button. Note that if you receive an error 'server error, access denied' this can be down to either:
- An incorrect client id
- An incorrect client secret
- An incorrect username/password/scope
- The OAuth2 server not being configured correctly.
The client id and secret will be stored only if the 'Save Authentication' option is checked.
Related Articles:
Using Precision Bridge without Service Now Admin Permissions
Procedure to Add the ServiceNow SSL certificate to the Java Runtime Environment
Problems connecting to ServiceNow
Comments
0 comments
Please sign in to leave a comment.