Ansluta till GitHub (förhandsversion)

[Denna artikel är en förhandsversion av dokumentationen och kan komma att ändras.]

Om du vill ansluta en Dataverse-miljö eller lösning till GitHub skapar du en GitHub app, lagrar appens privata nyckel i Azure Key Vault, skapar en Power Platform-GitHub-anslutning och ansluter sedan från källkontrollmiljön i din lösning.

Du kan komma åt lösningar från Power Apps, Power Automate, Power Pages och Copilot Studio.

Important

• Det här är en förhandsgranskningsfunktion.
• Förhandsgranskningsfunktioner ska inte användas i produktion, och funktionerna kan vara begränsade. Dessa funktioner är tillgängliga före en officiell release så att kunderna kan få tidig tillgång och ge feedback.

Förutsättningar

• Dataverse Git-integrering är en funktion i hanterade miljöer. Utvecklings- och målmiljöer måste vara aktiverade som hanterade miljöer.
• Ett GitHub konto med organisationsadministratörsåtkomst.
• En Azure-prenumeration med behörighet att skapa Key Vault resurser. Key Vault måste finnas i samma Microsoft Entra klientorganisation som Dataverse-miljön.
• Du behöver en Dataverse-miljö där du har säkerhetsrollen Systemadministratör.
• En anpassad ohanterad lösning som du vill ansluta till källkontrollen. Skapa en om du inte har någon ännu.

Skapa en GitHub app

1. Öppna GitHub i webbläsaren. Välj din profilbild i det övre högra hörnet och gå sedan till Inställningar>Utvecklarinställningar.

2. Välj Ny GitHub app.

   Du kan också gå direkt till GitHub appregistreringssidan för att skapa en ny GitHub App.

3. På sidan Skapa GitHub app anger du ett unikt namn för din GitHub-app i fältet GitHub Appnamn. Ange till exempel MyOrgGitHubIntegrationApp.

4. Fyll i fältet Url för startsida . Du kan använda organisationens webbplats eller url:en för GitHub lagringsplats.

5. Om du inte behöver webhook-meddelanden avmarkerar du kryssrutan Aktiv i avsnittet Webhook .

   

Konfigurera lagringsplatsbehörigheter

1. Rulla ned till avsnittet Behörigheter .

2. Expandera Behörigheter för lagringsplats och ange sedan Innehåll till Läs och skriv. Med den här behörigheten kan appen läsa och skriva lagringsplatsinnehåll för källkontrollintegrering.

   

3. Rulla nedåt och välj Skapa GitHub app.

4. På sidan GitHub Appinställningar kopierar du klient-ID:t. Du behöver det här värdet när du registrerar appkonfigurationen i Dataverse. Klient-ID använder ett format som Iv23liBWoH6sf7xGrRe9.

5. Generera och ladda ned en privat nyckel från sidan GitHub appinställningar. Lagra den privata nyckeln i Azure Key Vault i ett senare steg.

   

Installera GitHub-appen på mållagringsplatsen

1. På sidan GitHub appinställningar väljer du Installera app i det vänstra fönstret.

2. Välj Installera bredvid det konto eller den organisation som äger mållagringsplatsen.

   Om mållagringsplatsen tillhör en GitHub organisation kan organisationsadministratören behöva godkänna appinstallationen. Administratören får ett meddelande om att granska och godkänna begäran.

   

3. Välj om du vill ge appen åtkomst till Alla lagringsplatser eller Välj endast lagringsplatser. För metodtips för säkerhet väljer du endast de specifika lagringsplatser som behövs för källkontrollintegrering.

4. Välj Installera för att slutföra installationen.

   

Konfigurera Azure Key Vault

1. Öppna Azure-portalen och gå till nyckelvalvsresursen. Om du inte har något skapar du ett nytt nyckelvalv först.

2. I fönstret Key Vault väljer du Nycklar i det vänstra navigeringsfönstret.

   

3. Välj Generera/Importera.

4. I listrutan Alternativ väljer du Importera.

5. Ange ett namn på nyckeln, till exempel demoGitHubKey, och ladda sedan upp .pem filen som du laddade ned från GitHub.

6. Välj Skapa för att importera nyckeln.

   

Skapa en GitHub anslutning

Skapa en OAuth-anslutning med ditt personliga GitHub konto. Den här anslutningen verifierar att du har administratörsåtkomst till mållagringsplatsen under installationen. Vid körning hanterar GitHub-appen kommunikationen med GitHub, så enskilda användare behöver inte skapa GitHub-anslutningar.

Note

Du kan inte använda GitHub anslutningar när du aktiverar stöd för virtuellt nätverk (VNET) för Dataverse-miljön. Använd en GitHub personlig åtkomsttoken (PAT) i stället.

1. Gå till Power Apps maker-portalen och välj sedan Anslutningar.

2. Välj Ny anslutning.

3. Sök efter och välj standardanslutningsprogrammet GitHub.

   

4. Logga in med ditt GitHub-konto och bevilja den begärda åtkomsten.

   

Det GitHub konto som du loggar in med måste ha administratörsåtkomst till mållagringsplatsen. OAuth-anslutningen verifierar dina behörigheter.

När du har skapat anslutningen öppnar du den. Observera anslutnings-ID:t från URL:en i webbläsarens adressfält. Du behöver det här värdet när du konfigurerar Git-anslutningen.

Anslutnings-ID:t visas i URL:en när du visar anslutningsinformationen, enligt följande exempel:

https://make.powerapps.com/.../connections/shared_github/{connectionId}/details

Godkänna OAuth-appåtkomst för din organisation

Om din GitHub organisation har icke-Microsoft programåtkomstbegränsningar aktiverade måste en organisationsadministratör godkänna den OAuth-app som används av Power Apps GitHub-anslutningsappen. Kontrollera organisationens inställningar i Organisationsinställningar>Åtkomst från tredje part.

Mer information finns i Aktivera åtkomstbegränsningar för OAuth-appar och Godkänna OAuth-appar för din organisation.

Ansluta till GitHub från en lösning

1. Skapa en ny ohanterad lösning eller välj en befintlig anpassad ohanterad lösning.

2. På sidan Källkontroll väljer du Anslut.

3. I fönstret Anslut till Git väljer du GitHub.

   

4. Ange GitHub organisation, lagringsplats, gren, Git-mapp och anslutningsinformation från föregående installationssteg.

   

5. Skapa en GitHub appkonfiguration och ange GitHub appklient-ID, Key Vault URI och nyckelnamn från föregående installationssteg.

   

Konfigurera Key Vault rollbaserad åtkomstkontroll (RBAC)

1. Gå till nyckelvalvsresursen i Azure-portalen.

2. Välj Åtkomstkontroll (IAM), välj Lägg till och välj sedan Lägg till rolltilldelning.

3. Sök efter och välj rollen Key Vault Crypto User.

   

4. Välj Välj medlemmar och sök sedan efter den Dataverse-hanterade identitet som är associerad med din GitHub appkonfiguration. Namnet på den hanterade identiteten använder följande format:

   PPMI-githubappconfigmanagedidentity-{GUID}
   

5. Välj den hanterade identiteten och välj sedan Granska + tilldela.

   

Om den hanterade identiteten inte visas går du till Dataverse-miljöinställningar >Systemjobb och söker efter fel som rör skapande av GitHub appkonfiguration. Registreringen skapas asynkront och kan ta en stund att visas.

När rolltilldelningen är klar har den Dataverse-hanterade identiteten behörighet att använda GitHub-nyckeln i det här Key Vault-valvet.

Kontrollera anslutningen och gör en testincheckning

Öppna en ohanterad lösning från området Lösningar . Om du inte har någon ännu skapar du en ny lösning först. Integrering med källkontroll fungerar endast med ohanterade lösningar.

Gå till sidan Källkontroll och välj Git-anslutning. Kontrollera att anslutningen visar GitHub som provider och att informationen om organisation, lagringsplats, gren och mapp är korrekt.

Om du vill verifiera flödet från slutpunkt till slutpunkt väljer du Checka in för att skicka lösningen till den anslutna GitHub lagringsplatsen.

Om incheckningen lyckas fungerar integreringen.

Anslut med hjälp av kod

Du kan använda Dataverse Web API eller PowerShell för att ansluta till GitHub programmatiskt i stället för att använda användargränssnittet. Mer information finns i Ansluta till en GitHub lagringsplats.