ühenduse loomine GitHub (eelvaade)

[See artikkel kuulub väljalaske-eelsete dokumentide hulka ja seda võidakse muuta.]

Dataverse'i keskkonna või lahenduse ühendamiseks GitHub, looge GitHub rakendus, salvestage rakenduse privaatvõti Azure Key Vault, looge Power Platformi GitHub ühendus ja seejärel looge ühendus lahenduse allika juhtimise kogemuse kaudu.

Lahendustele pääsete juurde Power Apps, Power Automate, Power Pages ja Copilot Studio kaudu.

NB!

• See on eelversiooni järgus funktsioon.
• Eelvaatefunktsioonid ei ole mõeldud tootmiseks ja nende funktsionaalsus võib olla piiratud. Need funktsioonid on saadaval enne ametlikku väljalaskmist, et kliendid saaksid varakult juurde pääseda ja tagasisidet anda.

Eeltingimused

• Dataverse Git integratsioon on hallatavate keskkondade funktsioon. Arendus- ja sihtkeskkonnad peavad olema lubatud hallatavate keskkondadena.
• GitHub konto, millel on ettevõtte administraatori juurdepääs.
• Key Vault ressursside loomise õigusega Azure tellimus. Key Vault peab olema Dataverse'i keskkonnaga samas Microsoft Entra rentnikus.
• Vajate Dataverse'i keskkonda, kus teil on süsteemiadministraatori turberoll.
• Kohandatud mittehallatav lahendus, mida soovite allikajuhtimisega ühendada. Looge see, kui teil seda veel pole.

GitHub rakenduse loomine

1. Avage brauseris GitHub. Valige paremas ülanurgas oma profiilipilt ja seejärel avage Sätted>Arendaja sätted.

2. Valige Uus GitHub rakendus.

   Uue GitHub rakenduse loomiseks võite minna ka otse GitHub rakenduse registreerimise lehele.

3. Sisestage lehel GitHub rakenduse loomine väljale GitHub rakenduse nimi oma GitHub rakenduse kordumatu nimi. Sisestage näiteks MyOrgGitHubIntegrationApp.

4. Täitke väli Avalehe URL . Saate kasutada oma asutuse veebisaiti või GitHub hoidla URL-i.

5. Kui te ei vaja veebihooki teatisi, tühjendage jaotises Veebihook märkeruut Aktiivne.

   

Hoidla õiguste konfigureerimine

1. Liikuge kerides jaotiseni Õigused .

2. Laiendage hoidla õigusi ja määrake sätte Sisu väärtuseks Lugemis- ja kirjutamisõigus. See õigus võimaldab rakendusel lähtekontrolli integreerimiseks lugeda ja kirjutada hoidla sisu.

   

3. Liikuge kerides allapoole ja valige Loo GitHub rakendus.

4. Kopeerige lehel GitHub rakenduse sättedkliendi ID. See väärtus on vajalik, kui registreerite rakenduse konfiguratsiooni Dataverse'is. Kliendi ID kasutab sellist vormingut nagu Iv23liBWoH6sf7xGrRe9.

5. Saate GitHub rakendusesätete lehel luua ja alla laadida privaatvõtme. Hoidke privaatvõtit hilisemas etapis Azure Key Vault.

   

GitHub rakenduse installimine sihthoidlasse

1. Valige GitHub rakendusesätete lehel vasakul paanil Installi rakendus.

2. Valige sihthoidlat omava konto või organisatsiooni kõrval käsk Installi .

   Kui sihthoidla kuulub GitHub organisatsiooni, peab ettevõtte administraator võib-olla rakenduse installi kinnitama. Administraator saab teatise taotluse läbivaatamiseks ja kinnitamiseks.

   

3. Valige, kas soovite anda rakendusele juurdepääsu kõigile hoidlatele või ainult valitud hoidlad. Parimate turbetavade saamiseks valige ainult lähtekontrolli integreerimiseks vajalikud konkreetsed hoidlad.

4. Installimise lõpuleviimiseks valige Installi .

   

Konfigureerige Azure’i võtmehoidla

1. Avage Azure portaal ja avage oma võtmehoidla ressurss. Kui teil seda pole, looge esmalt uus võtmehoidla.

2. Valige Key Vault vasakul navigeerimispaanil Klahvid.

   

3. Valige Loo/impordi.

4. Valige rippmenüüs Suvandid käsk Impordi.

5. Sisestage võtme nimi (nt demoGitHubKey) ja laadige .pem siis üles GitHub alla laaditud fail.

6. Võtme importimiseks valige Käsk Loo .

   

GitHub ühenduse loomine

Looge OAuthi ühendus isikliku GitHub konto abil. See ühendus kinnitab, et teil on häälestamise ajal administraatori juurdepääs sihthoidlale. Käitusajal tegeleb GitHub rakendus GitHub suhtlemisega, nii et üksikkasutajad ei pea GitHub ühendusi looma.

Märkus.

Dataverse'i keskkonnas virtuaalvõrgu (VNET) toe lubamisel ei saa kasutada GitHub ühendusi. Kasutage selle asemel GitHub isiklikku pääsutõendi (PAT).

1. Avage Power Apps looja portaal ja seejärel valige Ühendused.

2. Valige Uus ühendus.

3. Otsige ja valige GitHub standardkonnektor.

   

4. Logige sisse oma GitHub kontoga ja andke soovitud juurdepääs.

   

GitHub kontol, millega sisse logite, peab olema administraatori juurdepääs sihthoidlale. OAuthi ühendus kinnitab teie õigused.

Pärast ühenduse loomist avage see. Pange tähele, et ühenduse ID pärineb teie brauseri aadressiriba URL-ist. Seda väärtust on vaja Giti ühenduse konfigureerimisel.

Ühenduse ID kuvatakse URL-is ühenduse üksikasjade vaatamisel, nagu on näidatud järgmises näites:

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

OAuthi rakenduse juurdepääsu kinnitamine teie ettevõtte jaoks

Kui teie GitHub asutuses on lubatud rakendusele juurdepääsupiirangud, mis pole Microsoft, peab ettevõtte administraator kinnitama Power Apps GitHub konnektori kasutatava OAuthi rakenduse. Kontrollige oma asutuse sätteid jaotises Organisatsiooni sätted>Kolmanda osapoole juurdepääs.

Lisateavet leiate teemadest OAuthi rakenduse juurdepääsupiirangute lubamine ja OAuthi rakenduste kinnitamine teie asutuse jaoks.

Lahenduse kaudu GitHub ühendamine

1. Looge uus mittehallatav lahendus või valige olemasolev kohandatud mittehallatav lahendus.

2. Valige lehel Allika juhtelement nupp Ühenda.

3. Valige paanil Gitiga ühenduse loomineGitHub.

   

4. Sisestage eelmiste häälestustoimingute GitHub organisatsioon, hoidla, haru, Git-kaust ja ühenduseteave.

   

5. Looge GitHub rakenduse konfiguratsioon ja sisestage eelmiste häälestustoimingute GitHub rakenduse kliendi ID, Key Vault URI ja võtme nimi.

   

Key Vault rollipõhise pääsukontrolli (RBAC) konfigureerimine

1. Avage Azure portaalis oma Key Vault ressurss.

2. Valige Access control (IAM), valige Add (Lisa) ja seejärel Add role assignment (Lisa rollimäärang).

3. Otsige ja valige Key Vault Crypto User roll.

   

4. Valige Vali liikmed ja seejärel otsige andmehalduri hallatavat identiteeti, mis on seostatud teie GitHub rakenduse konfiguratsiooniga. Hallatava identiteedi nimi kasutab järgmist vormingut:

   PPMI-githubappconfigmanagedidentity-{GUID}
   

5. Valige hallatav identiteet ja seejärel valige Läbivaatus + määramine.

   

Kui hallatavat identiteeti ei kuvata, avage Dataverse'i keskkonna sätete>süsteemitööd ja otsige rakenduse GitHub konfiguratsiooni loomisega seotud tõrkeid. Registreerimine luuakse asünkroonselt ja selle kuvamine võib veidi aega võtta.

Kui rollimäärang on lõpule viidud, on Dataverse'i hallataval identiteedil õigus kasutada selles Key Vault GitHub võtit.

Kontrollige ühendust ja testige kinnitust

Avage mittehallatav lahendus alal Lahendused . Kui teil seda veel pole, looge esmalt uus lahendus. Allikajuhtimise integreerimine töötab ainult mittehallatud lahendustega.

Minge lehele Allika juhtelement ja valige Git-ühendus. Veenduge, et ühendus kuvaks pakkujana GitHub ning et organisatsiooni, hoidla, haru ja kausta üksikasjad oleksid õiged.

Lõpp-punkti voo kontrollimiseks valige Kinnita, et lükata oma lahendus ühendatud GitHub hoidlasse.

Kui kinnitamine õnnestub, on integreerimine toimiv.

Ühenduse loomine koodi abil

Kasutajaliidese asemel saate GitHub programmiliselt luua ühenduse Dataverse Web API-ga või PowerShelliga. Lisateavet leiate teemast Ühenduse loomine GitHub hoidlaga.