Skip to Content

BMC Helix ITSM Prerequisites

Introduction

To use the BMC Helix ITSM connector with OAuth 2.0 authentication, the BMC SaaS Operations team must have set up an OAuth 2.0 application and provided you with the values you will need for generating a refresh token and bearer token.

Note

These instructions require the use of a third-party tool such as Postman.

Obtain a Custom API URL

To obtain a refresh token and bearer token, you must use an API Manager Custom API URL. For information on configuring a Custom API and obtaining its URL, see these resources:

Obtain Tokens

Follow these steps to obtain the refresh token and bearer token:

  1. Obtain these values from the BMC SaaS Operations team:

    • Callback URL
    • Auth URL
    • Access Token URL
    • Client ID
    • Client Secret

  2. In Postman open a new request.

  3. Click the Authorization tab, and use the Type menu to select OAuth 2.0.

  4. In the Configure New Token section, configure these fields:

    Field Description
    Token Name Enter a name for the token.
    Grant Type From the menu, select Authorization Code.
    Callback URL Enter the Custom API URL (provided by the BMC SaaS Operations team).
    Auth URL Enter the BMC Helix auth URL (provided by the BMC SaaS Operations team) in this format: <Host URL>/rsso/oauth2/authorize.
    Access Token URL Enter the BMC Helix access token URL (provided by the BMC SaaS Operations team) in this format: <Host URL>/rsso/oauth2/token.
    Client ID Enter your client ID (provided by the BMC SaaS Operations team).
    Client Secret Enter your client secret (provided by the BMC SaaS Operations team).
    Scope Leave this field empty.
    State Leave this field empty.
    Client Authentication From the menu, select Send as Basic Auth header.

  5. Click Get New Access Token.

  6. In the BMC Helix single sign-on login dialog, enter the credentials that BMC has provided.

  7. Retain the refresh_token, bearer_token, and expires_in values returned in the response as they are to be used during connection configuration.

    Important

    Contact the BMC SaaS Operations team to extend the expiration time of the bearer token.