Azure DevOps – Git-integrering med tjänstens huvudnamn (förhandsversion)

Den här artikeln innehåller en stegvis guide om hur du konfigurerar ett huvudnamn för tjänsten för att integrera Microsoft Fabric med Azure DevOps. Med den här integreringen kan Fabric-användaren utföra git-åtgärder med hjälp av tjänstens huvudnamn. Information om hur du automatiserar Git-integrering med hjälp av API:er med tjänstens huvudnamn finns i Automatisera Git-integrering med hjälp av API:er

Förutsättningar

Om du vill registrera en applikation med din Microsoft Entra-klient och använda den för att integrera din Fabric-arbetsyta med Git måste du ha:

• Minst behörigheter för molnprogramadministratör .
• En Fabric-arbetsyta med administratörsbehörigheter.

Steg 1: Registrera ett program med Microsoft Entra-ID

Registrera ditt program med Microsoft Entra-ID och skapa en hemlighet genom att följa anvisningarna i Registrera din app. Bekräfta att organisationens principer tillåter skapande av klienthemligheter och deras användning för tokenförvärv. Se till att spara hemligheten, det krävs i ett senare steg.

Om ditt program finns i en klientorganisation som inte är samma som hemmet för din Azure DevOps-instans läser du Överväganden för flera klienter.

För mer information, se Program- och tjänstehuvudobjekt i Microsoft Entra ID och Säkerhetsbästa praxis för programegenskaper i Microsoft Entra ID.

Ett exempel på registrering av en applikation och skapande av tjänstens principal finns i Registrera en Microsoft Entra-app och skapa ett huvudnamn för tjänsten.

Steg 2: Tilldela serviceprincipal till en DevOps-organisation

När vi har skapat vårt program och tjänstens huvudnamn måste vi lägga till det i vår Azure DevOps-organisation för att bevilja åtkomst till resurser.

1. Logga in på din Azure DevOps-organisation
2. Bläddra till Organisationsinställningar –> Användare –> Lägg till användare
3. Välj för att lägga till tjänsthuvudnamn

4. Gå till relevanta Azure DevOps-projektinställningar – >Teams
5. Lägga till tjänstens huvudnamn i relevant team

Steg 3: Skapa en anslutning för Azure DevOps-källkontroll

Sedan skapar vi källkontrollanslutningen för Azure DevOps. Följande information krävs för att slutföra det här steget.

Hämta klient-ID

Följ dessa steg för att hämta hyrd ID:t.

1. Gå till Azure-portalen och logga in med dina autentiseringsuppgifter.
2. Gå till Microsoft Entra ID (Azure Active Directory)
3. I avsnittet "Översikt" visas ditt "hyresgäst-ID".

Andra sätt att hämta klientorganisations-ID finns i Så här hittar du ditt Microsoft Entra-klient-ID.

Hämta tjänstens huvudnamns-ID

Använd följande steg för att hämta tjänstens huvudnamns-ID.

1. Gå till Azure-portalen och logga in med dina autentiseringsuppgifter.
2. Gå till Microsoft Entra ID (Azure Active Directory)
3. Till vänster väljer du Appregistreringar
4. Navigera till appen och välj fliken Översikt
5. Använd Program-ID (klient) för Tjänstprincip-ID

Skapa källkontrollanslutningen

Använd följande information och steg för att skapa källkontrollanslutningen.

1. Från en arbetsyta väljer du inställningar för arbetsyta
2. Välj Git-integrering
3. Välj Azure DevOps
4. Klicka på Lägg till konto
5. Under Visningsnamn anger du ett namn.
6. Ange Azure DevOps-URL.
7. Under Autentiseringsmetod väljer du Tjänstens huvudnamn.
8. Fyll i de andra detaljerna (hyresgäst-ID, tjänstehuvud-ID, tjänstehuvudnyckel) med hjälp av informationen ovan.

9. När du har lagt till anslutningen måste du klicka på Anslut och slutföra git-anslutningsinformationen. Mer information finns i Ansluta till en arbetsyta

Överväganden för flera klienter vid skapande av tjänstens huvudnamn

För att få åtkomst till resurser som skyddas av en Microsoft Entra-klientorganisation måste ditt program ha en säkerhetsprincip. När du skapar din applikation skapas serviceprincipalen automatiskt i den klientorganisation där applikationen finns.

Om applikationens klientorganisation skiljer sig från hemklientorganisationen för din Azure DevOps-instans måste du skapa tjänsthuvudkontot i Azure DevOps-klientorganisationen. Tänk på följande scenarier när du registrerar din app i steg 1 och se exemplen.

Du kan skapa tjänstens huvudnamn i Azure DevOps-klientorganisationen med något av exemplen. I följande exempel visas hur du gör detta med Azure CLI och PowerShell. Båda exemplen förutsätter att ditt program finns i klient A och att Azure DevOps finns i klient B.

az login --tenant <your-tenant-id> # where --tenant is the tenant ID of Azure DevOps tenant (tenant B)

az ad sp create --id <app id> # where --id <app id> is the client ID of the application in tenant A

Connect-MgGraph -TenantId "<Tenant B ID>" -Scopes "Application.ReadWrite.All", "Directory.ReadWrite.All" # Where -TenantID is the tenant ID of Azure DevOps tenant (tenant B)


New-MgServicePrincipal -AppId "00001111-aaaa-2222-bbbb-3333cccc4444" # Where -AppID is the client ID of the application in tenant A

Mer information finns i How and why applications are added to Microsoft Entra ID and Tenancy in Microsoft Entra ID (Hur och varför program läggs till i Microsoft Entra ID och Tenancy i Microsoft Entra ID).

Bilaga: Redigera anslutningsinformation för tjänstehuvudkonto

När du behöver uppdatera informationen om tjänstens huvudnamn, till exempel uppdatera tjänstens huvudnyckel, använder du följande instruktioner: )

1. I Infrastrukturinställningar navigerar du till Hantera anslutningar och gatewayer. Leta upp den molnanslutning som du skapade tidigare.
2. Redigera anslutningen med de uppdaterade inställningarna.

3. När du har redigerat anslutningen klickar du på Spara.

Relaterat innehåll

• Automatisera Git-integrering med hjälp av API:er
• Förstå Git-integreringsprocessen
• Hantera Git-grenar
• Metodtips för Git-integrering