Självstudie: Konfigurera en Azure DevOps-kontakt i Azure SRE Agent

I den här självstudien ansluter du din agent till Azure DevOps så att den kan komma åt lagringsplatser, wikis och dokumentation under undersökningar. Välj OAuth för automatisk tokenhantering eller PAT för tjänstkontoscenarier. När du är klar med den här självstudien har din agent autentiserat åtkomst till en Azure DevOps-organisation och kan läsa lagringsplatser, skapa arbetsobjekt och korrelera kodändringar med incidenter.

Uppskattad tid: 5 minuter

I den här handledningen kommer du att:

Förutsättningar

• En agent som skapats i Azure SRE-agentportalen
• Ett Microsoft Entra-ID-konto med åtkomst till din Azure DevOps-organisation
• SRE-agentadministratör eller standardanvändarroll på agenten

Navigera till kontakter

Öppna sidan anslutningar där du kan lägga till och hantera agentens externa anslutningar.

1. Öppna din agent i Azure SRE-agentportalen.
2. Expandera Builder i det vänstra sidofältet.
3. Välj Anslutningar.

Anslutningslistan visar alla befintliga anslutningar för din agent.

Lägga till en Azure DevOps OAuth-anslutning

Välj anslutningstypen Azure DevOps OAuth i guiden.

1. Välj Lägg till anslutning i verktygsfältet.
2. I Lägg till en kontakt väljer du Azure DevOps OAuth-kontakt.
3. Klicka på Nästa.

Konfigurera anslutaren

Installationsformuläret har tre fält: namn, organisation och autentiseringsmetod.

Namn

Ange ett namn för den här anslutningen. Namnet måste:

• Börja med en bokstav
• Innehåller endast bokstäver, siffror och bindestreck
• Vara 4–64 tecken långt

Exempel: ado-contoso eller my-org-connector

Organisation

Ange ditt Azure DevOps-organisationsnamn, som är delen efter dev.azure.com/ i url:en.

Om din URL till exempel är https://dev.azure.com/contoso anger du contoso.

Organisationsnamnet måste:

• Börja med en bokstav eller siffra
• Innehåller endast bokstäver, siffror och bindestreck
• Slutar inte med ett bindestreck
• Vara mellan 1 och 50 tecken långt
• Var unik bland dina befintliga Azure DevOps OAuth-anslutningsappar

Om namnet är ogiltigt visas ett infogat fel under fältet och knappen Nästa inaktiveras tills du korrigerar det. Efter autentisering verifierar agenten också att din token har åtkomst till den angivna organisationen.

Autentiseringsmetod

Välj hur din agent autentiserar till Azure DevOps:

Logga in med användarkonto (OAuth)

Om du väljer Användarkonto slutför du OAuth-autentiseringen med dina autentiseringsuppgifter för Microsoft Entra-ID.

1. Välj Logga in på Azure DevOps.
2. Dialogrutan Auktorisera Azure DevOps-medgivande visas med en lista över de behörigheter som din agent behöver:
   • Läs- och skrivåtkomst till lagringsplatser och projekt
   • Agera för den inloggade användarens räkning
3. Välj Auktorisera för att bevilja åtkomst.
4. När du lyckas ser du Ansluten till Azure DevOps med en grön bockmarkering.

Checkpoint: Kortet Ansluten till Azure DevOps visas med en grön bockmarkering. Om du ser ett fel i stället kontrollerar du att ditt Microsoft Entra-ID-konto har åtkomst till den angivna organisationen.

Använda hanterad identitet (alternativ)

Om du väljer Hanterad identitet konfigurerar du den identitet som agenten använder för obevakad autentisering.

1. Välj en hanterad identitet i listrutan (systemtilldelad eller användartilldelad).
2. Om din Azure DevOps-organisation finns i en annan Microsoft Entra ID-klientorganisation konfigurerar du FIC-fälten (Federated Identity Credential) för autentisering mellan klientorganisationer.
3. Gå vidare till granskningssteget.

Hanterad identitet fungerar bra för produktionsagenter som behöver beständig, obevakad åtkomst utan användarinteraktion. Agenten autentiserar med hjälp av autentiseringsuppgifterna för den hanterade identiteten direkt, utan att användaren behöver logga in.

Granska och lägg till

Bekräfta anslutningsinformationen och skapa anslutningsappen.

1. Välj Nästa för att gå vidare till granskningssteget.
2. Kontrollera anslutningsinformationen:
   • Namn: ditt valda namn
   • Organisation: Din Azure DevOps-organisation
   • Typ: Azure DevOps OAuth
3. Välj Lägg till anslutning för att skapa anslutningen.

Anslutningen visas nu i listan över anslutningsappar med indikeringen Ansluten status.

Verifiera åtkomst

Testa att din agent kan komma åt dina Azure DevOps-lagringsplatser.

Fråga din agent:

What repositories are available in my Azure DevOps organization?

Eller för en specifik kontroll:

Show me recent commits in the payment-service repository.

Alternativ: Konfigurera med PAT-autentisering

Om ditt team använder personliga åtkomsttoken (PAT) i stället för OAuth använder du dokumentationsanslutningsappen för Azure DevOps.

1. När du lägger till en anslutning väljer du Dokumentationsanslutning (Azure DevOps) i stället för Azure DevOps OAuth-anslutning.
2. Klicka på Nästa.
3. Ange ett namn och din Azure DevOps-URL (lagringsplats eller wiki-URL).
4. Under Autentiseringsmetod väljer du Personlig åtkomsttoken (PAT).
5. Ange din Azure DevOps PAT i det säkra inmatningsfältet.
6. Välj Nästa för att granska och välj sedan Lägg till.

Din PAT lagras på ett säkert sätt och du kan inte hämta den när du har sparat den. Kontaktdonet kontrollerar anslutningen innan konfigurationen sparas. Om PAT saknar det nödvändiga vso.code omfånget, misslyckas skapandet av anslutningen med ett tydligt felmeddelande.

Följande URL-format accepteras:

• https://dev.azure.com/{org}/{project}/_git/{repo}
• https://{org}.visualstudio.com/{project}/_git/{repo}
• Wikiadresser: https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki}

Redigera eller ta bort en kontakt

Du kan ändra eller ta bort befintliga anslutningar från anslutningslistan.

Redigera

1. I listan över kontakter väljer du menyn ⋮ (fler åtgärder) för kontaktens rad.
2. Välj Redigera anslutning.
3. Redigeringsdialogrutan öppnas med dina aktuella inställningar. Ändra organisationen, autentisera om eller ändra den hanterade identiteten.
4. Välj Spara.

Delete

Så här tar du bort en enda kontakt:

1. Välj ⋮ på kontaktörens rad och välj sedan Ta bort kontaktören.
2. Bekräfta borttagningen.

Så här tar du bort flera kontakter på en gång:

1. Välj kontakter med kryssrutorna i gridrutorna.
2. Välj Ta bort i verktygsfältet.
3. Bekräfta i dialogrutan för borttagning.

Felsökning

Använd följande information för att lösa vanliga fel när du konfigurerar en Azure DevOps-anslutning.

Sammanfattning

I den här handledningen lärde du dig att:

• Lägg till en Azure DevOps-anslutning med hjälp av OAuth eller hanterad identitetsautentisering
• Förstå skillnaden mellan OAuth-autentisering (automatisk autentisering) och PAT-autentisering (manuellt hanterad)
• Kontrollera att din agent kan komma åt dina Azure DevOps-lagringsplatser
• Konfigurera PAT-autentisering via dokumentationsanslutningsappen
• Konfigurera flera konnektorer för olika organisationer

Nästa steg

Relaterat innehåll

• Ansluta källkod
• Kunskap om Azure DevOps-wiki
• Anslutningar