Azure DevOps

Azure DevOps integratie configureren

De Azure DevOps integratie verbindt Tidal Control met je Azure DevOps organisatie via een Personal Access Token (PAT). Het is een tweerichtings integratie:

• Azure DevOps → Tidal Control – Tidal leest periodiek je repositories en werkitems om automatische compliance- en securitytests uit te voeren (bijvoorbeeld branch-protection regels en SLA's voor het afhandelen van bugs).
• Tidal Control → Azure DevOps – Vanuit een Tidal taak of issue maak je een Azure DevOps werkitem aan (of koppel je een bestaand werkitem). Zo kan je eerste lijn in Azure DevOps blijven werken terwijl je tweede lijn in Tidal Control werkt, waarbij beide kanten synchroon blijven.

Vereisten:

• Super User rol in Tidal Control
• Een Azure DevOps organisatie met minimaal één project
• Rechten om een Personal Access Token aan te maken in Azure DevOps

Hoe de integratie werkt

Beide richtingen verlopen via één Personal Access Token. Er wordt niets verwijderd in Azure DevOps; Tidal leest alleen gegevens en maakt — alleen wanneer je daar expliciet om vraagt — werkitems aan of koppelt ze.

Richting	Wat gebeurt er
Azure DevOps → Tidal Control	Op een terugkerend schema leest Tidal repositories en werkitems en toetst deze aan de Azure DevOps compliance tests. De resultaten verschijnen in de sectie Tests.
Tidal Control → Azure DevOps	Wanneer je een externe issue toevoegt aan een taak of issue, maakt Tidal een werkitem aan in het gekozen Azure DevOps project (of koppelt een bestaand werkitem). Een statuslabel op de Tidal taak weerspiegelt vervolgens het werkitem.

Configuratie stap-voor-stap plan

Wat we gaan doen: We maken een Personal Access Token (PAT) aan in Azure DevOps en gebruiken deze om je organisatie te verbinden met Tidal Control. Een PAT is een Azure DevOps mechanisme waarmee een externe applicatie (Tidal) namens jou veilig toegang krijgt tot je Azure DevOps resources.

Configuratiestappen:

1. Maak een Personal Access Token aan
2. Voeg de integratie toe in Tidal Control

Stap 1: Maak een Personal Access Token aan

• Log in bij je Azure DevOps organisatie op https://dev.azure.com/{jouw-organisatie}
• Klik op je profielicoon (rechtsboven) → Personal access tokens
• Klik op + New Token
• Token configuratie:
  • Naam: Tidal Control Integration
  • Organisatie: selecteer de organisatie die je wilt monitoren
  • Vervaldatum: kies een geldigheidsduur volgens je securitybeleid
  • Scopes: selecteer de onderstaande scopes
• Klik op Create
• Kopieer de tokenwaarde direct — deze is niet meer zichtbaar nadat je het venster sluit

Vereiste scopes:

Scope	Toegang	Waarom we het nodig hebben
Code	Read	Repository-instellingen lezen voor de repository- en branch-protection tests (Azure DevOps → Tidal).
Work Items	Read & write	Werkitems lezen voor de bug/SLA tests (Azure DevOps → Tidal) én werkitems aanmaken wanneer je een taak of issue vanuit Tidal doorzet (Tidal → Azure DevOps).

Stap 2: Voeg de integratie toe in Tidal Control

• Ga naar Settings → Integrations in Tidal Control
• Klik onder Available Integrations op het plus-icoon naast Azure DevOps
• Vul de configuratie in:
  • Naam: een herkenbare naam, bijv. Azure DevOps Productie
  • Organization URL: je organisatie-URL in de vorm https://dev.azure.com/jouw-organisatie
  • Personal Access Token: de tokenwaarde die je in stap 1 hebt gekopieerd
• Klik op Create om de integratie op te slaan

Na het opslaan verschijnt de verbinding onder Configured Integrations.

Compliance tests (Azure DevOps → Tidal Control)

Zodra de verbinding actief is, komen de Azure DevOps tests beschikbaar in de sectie Tests. Tidal voert ze automatisch uit op een terugkerend schema en rapporteert het resultaat. Voorbeelden zijn:

• Default branch vereist pull request reviews
• Default branch vereist aangewezen reviewers
• Projecten zijn privé
• Repositories zijn actief
• Bugs met hoge prioriteit hebben een assignee
• Bugs met hoge prioriteit worden binnen 3 dagen opgelost (SLA)
• Geen enkele bug met hoge prioriteit blijft zonder recente activiteit liggen

Je kunt het Tests-overzicht filteren op de Azure DevOps integratie om ze allemaal te zien.

Taken en issues doorzetten naar Azure DevOps (Tidal Control → Azure DevOps)

Vanuit elke Tidal taak of issue kun je een Azure DevOps werkitem aanmaken — of een bestaand werkitem koppelen — en Tidal houdt de status van het werkitem synchroon in het taakoverzicht. Selecteer bij het toevoegen van een externe issue je Azure DevOps verbinding, het Project en het Issue type; de rest van de werkwijze is voor elke issue tracker gelijk.

Zie Externe issues voor de volledige aanmaken- / koppelen- / synchroniseren-werkwijze en de statuskolom in het taakoverzicht.

Verificatie

Controleer een geslaagde configuratie:

• Settings → Integrations toont Azure DevOps onder Configured Integrations
• Azure DevOps tests verschijnen in de sectie Tests en verversen zonder authenticatiefouten
• Het "Add external issue"-icoon is beschikbaar op taken en issues

Problemen oplossen

Veelvoorkomende problemen:

• Controleer of de Organization URL de vorm https://dev.azure.com/jouw-organisatie heeft
• Controleer of de PAT correct is gekopieerd (geen extra spaties) en niet is verlopen
• Controleer of de PAT de vereiste scopes heeft (Code: Read, Work Items: Read & write)
• Is het aanmaken van werkitems niet beschikbaar, controleer dan of de PAT Work Items: Read & write bevat
• Zorg dat de eigenaar van het token toegang heeft tot de gewenste Azure DevOps project(en)

Voor meer informatie over Azure DevOps Personal Access Tokens: Zie de officiële Microsoft documentatie

Kom je er niet uit?

Stuur een e-mail naar support@tidalcontrol.com, dan nemen we zo snel mogelijk contact met je op.