Connect Azure Boards

Connect the work items of Azure DevOps with a token for work items, and its service hooks.

In short

Connect Azure Boards once for the whole organization. Boards then keep their cards in step with an Azure DevOps project through it.

Before you start

Where it lives

  1. Open your organization, then Settings › "Connections", and press "Connect a work tracker".
  2. Choose "Azure Boards". The wizard opens; each step is checked before the next one opens.
  3. Choose "Azure DevOps Services" and type the "Organization", or choose "Azure DevOps Server" and type its "Address".
  4. Press "Check this step".

Sign in

  1. Press "Open the token page". Azure DevOps opens Personal access tokens.
  2. Press New Token, choose Custom defined under Scopes, tick Work Items: Read and write, and press Create.
  3. Copy the token, paste it into "Token".
  4. Type one project name into "A project to check with", such as Payments.
  5. Press "Check this step": it signs in and reads it.

Webhook

The webhook tells {{brand}} the moment something changes in Azure DevOps, so nothing waits for the next read.

  1. Press "Make the address and secret". Copy each with "Copy address" and "Copy secret" - the secret is shown only now.
  2. In Azure DevOps, open the project, then Project settings, Service hooks, Create subscription, Web Hooks.
  3. Choose Work item created. Make the same subscription for Work item updated, deleted and restored.
  4. Paste the address as the URL. Under HTTP headers paste the line "Copy header" copied.
  5. Press Test to send a first delivery, then Finish.
  6. Back in the wizard, press "Look for a delivery". You can also go on with "Next"; deliveries show up under "Deliveries".

Check and use

  1. Press "Run the full check". Every step should say Passed; a step that failed names what to change.
  2. Under "Where will you use it?" tick Boards.
  3. Optional: under "Only these teams" tick the teams that may pick it. Leave it empty for everyone who may use those modules.
  4. Check the "Name" - boards, designs and projects show it - and press "Finish". The connection shows under "Connections" with its health.

If a step fails

Good to know

Related