Set up the Microsoft Azure DevOps Boards spoke using personal access token

Integrate the ServiceNow instance and Azure DevOps Boards using basic authentication to authenticate ServiceNow requests.

시작하기 전에

• Request an Integration Hub subscription.
• Activate the Azure DevOps Boards spoke.
• Role required: admin.

이 태스크 정보

If you want to use different connections in your flow, subflows, and actions, create the child alias and select the default alias record as its parent. To configure the child alias, perform the same steps that are needed to configure the parent alias. Depending on your requirement and set up, you can choose either the parent alias or child alias in your flow, subflows, and actions.

You can also use multiple Azure DevOps accounts. In this case, you should provide the respective Password while configuring the credential record and specify the relevant Connection URL while configuring the connection record.

Obtain the personal access token

Authenticate Azure DevOps Boards by using the personal access tokens.

시작하기 전에

Role required: admin

프로시저

1. Log in to your Azure DevOps portal as an admin.
2. Navigate to User Settings > Personal access tokens.

   

3. Click New Token.
4. On the form, fill the required fields.

   

5. Click Create.

   

   The token is displayed.
6. Copy and record the value of token for later use.

Configure a connection record for Microsoft Azure DevOps Boards Spoke

Add and configure a Azure DevOps Boards connection to authenticate ServiceNow requests.

시작하기 전에

Role required: admin

프로시저

1. Navigate to All > IntegrationHub > Connections & Credentials > Credentials.
2. Select New.
3. Under What type of Credentials would you like to create?, select Basic Auth Credentials.
4. Fill the form.

   표 1. Credentials table

   Field	Details
   Name	Option to provide the name that identifies the record.
   Order	Option to provide the order in which the credentials are used. For example, enter 100.
   User name	Option to provide the user name that you enter as credential.
   Password	Option to provide the password that you enter as credential.
   Active	Option to actively use the credential record. Select the option.

5. Select Submit.
   The credentials are created.
6. Navigate to All > IntegrationHub > Connections & Credentials > Connection & Credential Aliases.
7. Search for the alias Azure_DevOps_Boards.
8. Select the alias Azure_DevOps_Boards.
9. Under the Connections tab, select New.
10. Fill the form.

    표 2. HTTP(s) Connection

    Field	Description
    Name	Option to provide a unique name of the connection.
    Active	Option to indicate that this connection is active. 주: You can keep either the connection record for the OAuth 2.0 or that for the Basic Auth active. If you want to keep both connection records active, create one of the connection records under a child alias under the Azure_DevOps_Boards connection and credential alias.
    Credential	Option to select the credential that you have created earlier.
    Domain	Option to provide the domain to which the connection belongs.
    Connection alias	Option to provide the parent connection alias. This field is automatically set to sn_azure_dev_spoke.Azure_DevOps_Boards.
    URL builder	Either manually enter the connection URL or use system to build the URL based on the inputs. Default is unchecked. If checked, the connection URL is calculated from the following fields: Mutual authentication — Check box if mutual authentication is used. Protocol — If mutual authentication is not used, enter protocol. The default is HTTPs. Protocol profile — If mutual authentication is used, enter protocol profile from sys_protocol_profile. Host Port Base path — Path of the connection string. 주: If mutual authentication is checked, connection URL is built: Protocol + :// + host:port +URL. If mutual authentication is unchecked, connection URL is built: Protocol profile + :// + host:port +URL
    Connection URL	If URL builder is unchecked, enter the connection URL into this field. 주: If mutual authentication is checked, connection URL is built: Protocol + :// + host:port +URL. If mutual authentication is unchecked, connection URL is built: Protocol profile + :// + host:port +URL
    Use MID server	Option to specify MID server.
    Connection timeout	Number of milliseconds the system waits for a successful host connection. If a successful connection does not occur during this time, the connection request times out. Leave this field empty to use the system default connection timeout value.

11. Select Submit.
12. Navigate to All > Process Automation > Workflow Studio.
13. Click the Integrations tab.
14. Under Connections, toggle and enable the Outbound connections.
15. Locate the alias for Azure_DevOps_Boards and click View Details.
    • To configure the default connection and credential alias record that is shipped along with the Azure DevOps Boards spoke, click View Details.

      

    • To manage more than one Azure DevOps Boards spoke connection records, you should create a new child alias record by clicking Add Connection. For more information about using multiple connections, see Supporting multiple connections.

    If you are configuring the spoke for the first time, click Configure. Otherwise, click Edit.

    

16. On the Configure Connection form, fill in the fields:

    Field	Description
    Connection Name	Name to uniquely identify the connection record. For example, enter Azure DevOps Boards Connection.
    Connection URL	URL of the Azure DevOps instance. For example, enter the URL in this format: https://dev.azure.com/<instance-name>.
    User name	User name to log in to your Azure DevOps instance.
    Password	Personal access token to authenticate Azure DevOps.

    

17. Click Configure Connection.

결과

The spoke connection is configured and ready to be used.