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.
Before you begin
- Request an Integration Hub subscription.
- Activate the Azure DevOps Boards spoke.
- Role required: admin.
About this task
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.
Before you begin
Role required: admin
Procedure
Log in to your Azure DevOps portal as an admin.
Navigate to User Settings > Personal access tokens.
Generate personal access token.
Click New Token.
On the form, fill the required fields.
Create personal access token.
- Click Create.
Copy the personal access token.
The token is displayed.
- 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.
Before you begin
Role required: admin
Procedure
Navigate to All > IntegrationHub > Connections & Credentials > Credentials.
Select New.
Under What type of Credentials would you like to create?, select Basic Auth Credentials.
Fill the form.
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. Select Submit.
The credentials are created.
Navigate to All > IntegrationHub > Connections & Credentials > Connection & Credential Aliases.
Search for the alias Azure_DevOps_Boards.
Select the alias Azure_DevOps_Boards.
Under the Connections tab, select New.
Fill the form.
| Field | Description |
|---|---|
| Name | Option to provide a unique name of the connection. |
| Active | Option to indicate that this connection is active.Note: 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. Note: 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.Note: 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. |
Select Submit.
Navigate to All > Process Automation > Workflow Studio.
Click the Integrations tab.
Under Connections, toggle and enable the Outbound connections.
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.
Connection for Azure DevOps Board spoke
- 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](support-multiple-connections.md).
If you are configuring the spoke for the first time, click **Configure**. Otherwise, click **Edit**.
First-time connection configuration
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.
Configure a connection for Azure DevOps Boards spoke.
- Click Configure Connection.
Result
The spoke connection is configured and ready to be used.