Register the application with the instance to use OAuth authorization.

Before you begin

Role required: admin

Procedure

  1. Navigate to All > System OAuth > Application Registry.
  2. Click New.
  3. Click Create an OAuth API endpoint for external clients.
  4. On the form, fill in the fields.
    FieldDescription
    Name A unique name that identifies the application that you require OAuth access for.
    Client ID (Read-Only) The auto-generated unique ID of the application. The instance uses the client ID when requesting an access token.
    Client Secret The shared secret string that both the instance and the client application or website use to authorize communications with one another. The instance uses the client secret when requesting an access token. Leave this field blank to have the instance auto-generate a client secret. To display existing client secrets, click the lock icon.
    Redirect URL The callback URL that the authorization server redirects to. Enter as many URLs as needed for all possible token consumers. The instance matches the URL of the incoming request to one of the redirect URLs. If no match is made, the instance uses the first redirect URL.
    Logo URL The URL that contains an image to use as the application logo. The logo appears on the approval page when the user receives a request to grant a client application access to a restricted resource on the instance.
    Application The name of the application.
    Accessible from Define the application scope. Select one of the following:
    • All application scopes
    • This application scope only
    Active Select the check box to make the application registry active.
    Refresh Token Lifespan The number of seconds that a refresh token is valid. The instance uses the lifespan value when requesting a refresh token. By default, refresh tokens expire in 100 days (8640000 seconds).
    Access Token Lifespan The number of seconds that an access token is valid. The instance uses the lifespan value when requesting an access token. By default, access tokens expire in 30 minutes (1800 seconds).
    Comments Additional information to associate with the application.
    Configure Application Registry on the ServiceNow instance
  5. Right-click on the form header, and click Save.
  6. Click Submit.