Integrate your ServiceNow instance with the SumTotal application host so the SumTotal spoke can perform actions on the SumTotal server.

Before you begin

  • Request Integration Hub subscription
  • Activate the SumTotal spoke plugin
  • Ensure that the SumTotal configuration template is selected in the SumTotal alias page
  • Role required: admin

About this task

This task enables you to set up a connection and credential record so that your ServiceNow instance can integrate with the SumTotal host. The connection and credential alias record is a form that contains the SumTotal spoke configuration template and the connection and credential details to connect to the SumTotal host.

Set up SumTotal spoke connection and credential record

Integrate your ServiceNow instance with the SumTotal host by setting up the connection and credential record.

Before you begin

  • Role required: admin

About this task

The image provides the flow of creating a connection and credential record.

Flow to set up SumTotal connection and credential record.

Procedure

  1. Log in to the SumTotal host.
  2. Navigate to ADMINISTRATION > System > Configuration > Technical Configuration > OAuth Configuration > .
  3. On the OAUTH CLIENTS page, click +Add.Add button to add OAuth client in SumTotal.
  4. In the EDIT page, enter the details.SumTotal OAuth client setup page.
    Table 1. SumTotal OAuth client setup form
    FieldDescription
    Client Name Custom name of the OAuth client.
    Client Id Unique ID of the OAuth client. You need it when setting up the connection and credential record in the ServiceNow instance.
    Tip: To copy the ID, click COPY.
    Client Secret Client secret to set up the connection and credential record in the ServiceNow instance.
    Tip: To copy the ID, click COPY.
    Allowed Grant Types Select Client Credentials.
    Settings Select Enabled.
    Access Token Lifetime (minutes) The duration of the access token.
    Scopes Select allapis.
    Redirect URI URL of the location after the app is successfully authorized and granted an access token.
  5. Click Submit.
    The SumTotal OAuth client is created.
  6. Log in to your ServiceNow instance.
  7. Navigate to All > Process Automation > Flow Designer.
  8. Click Connections.
  9. To search for the SumTotal connections record, enter SumTotal.Search SumTotal connection record in Flow Designer.
  10. In the SumTotal connection card, click View Details.
  11. On the Connections page, click Configure.Configure button to configure connection and credential.
  12. In the Configure Connection form, fill the details.
    Table 2. Configure connection form
    FieldDescription
    Connection Name Name of the connection.
    Note: The name is read-only.
    Connection URL URL to connect to the SumTotal host.
    OAuth Entity Name Custom name of the OAuth entity.
    OAuth Client ID Client ID generated and copied from the SumTotal host.
    OAuth Client Secret Client secret generated and copied from the SumTotal host.
    OAuth Token URL URL to the token to access the SumTotal host. URL should be entered in the format https://{site-url}/apisecurity/connect/token.

    Configure the SumTotal connection record.

  13. Click Configure and Get OAuth Token.

    The spoke is configured and ready to be used.