Vzpostavljanje povezave s GitHub (predogled)

[Ta članek je del predizdajne dokumentacije in se lahko spremeni.]

Če želite povezati okolje ali rešitev Dataverse s storitvijo GitHub, ustvarite aplikacijo GitHub, shranite zasebni ključ aplikacije v Azure Key Vault, ustvarite povezavo za Power Platform GitHub in nato vzpostavite povezavo iz izkušnje nadzora vira v svoji rešitvi.

S predogledom integracije GitHub lahko vzpostavite v izkušnji z rešitvami na spletnem mestu https://make.preview.powerapps.com, https://make.preview.powerautomate.comhttps://copilotstudio.preview.microsoft.com, ali https://make.preview.powerpages.microsoft.com.

Pomembno

  • To je funkcija predogleda.
  • Poskusne funkcije niso za komercialno uporabo, njihovo delovanje je lahko omejeno. Te funkcije so na voljo še pred uradno izdajo, da lahko stranke predčasno dostopajo do njih in posredujejo povratne informacije.

Zahteve

  • Integracija z Dataverse Git je značilnost upravljanih okolij. Razvojna in ciljna okolja morajo biti omogočena kot upravljana okolja.
  • Račun GitHub s skrbniškim dostopom organizacije.
  • Naročnina Azure z dovoljenjem za ustvarjanje Key Vault virov. Podatki Key Vault morajo biti v istem Microsoft Entra kot okolje Dataverse.
  • Potrebujete okolje Dataverse, kjer imate varnostno vlogo skrbnika sistema.
  • Neupravljana rešitev po meri, ki jo želite povezati s kontrolnikom vira. Ustvarite ga, če ga še nimate.

Ustvarjanje GitHub aplikacijo

  1. Odprite GitHub v brskalniku. Izberite svojo sliko profila v zgornjem desnem kotu in nato odprite nastavitve za>razvijalce.

  2. Izberite Nova GitHub aplikacije.

    Če želite ustvariti novo aplikacijo, se GitHub neposredno na stran za registracijo GitHub aplikacije.

  3. Na strani GitHub programa vnesite enolično ime za program GitHub v polje GitHub Ime programa. Vnesite MyOrgGitHubIntegrationAppna primer .

  4. Izpolnite polje URL domače strani. Uporabite lahko spletno mesto organizacije ali URL GitHub skladišča.

  5. Če ne potrebujete obvestil webhook, počistite potrditveno polje Aktivno v razdelku Webhook .

    Posnetek zaslona strani GitHub programa z imenom GitHub programa.

Konfiguracija dovoljenj skladišča

  1. Pomaknite se navzdol do razdelka Dovoljenja.

  2. Razširite dovoljenja skladišča in nato nastavite Vsebino naBranje in pisanje. To dovoljenje aplikaciji omogoča branje in pisanje vsebine skladišča za integracijo kontrolnika vira.

    Posnetek zaslona z dovoljenji skladišča za GitHub aplikacijo.

  3. Pomaknite se navzdol in izberite GitHub aplikacijo.

  4. Na strani GitHub aplikacij kopirajteID odjemalca. To vrednost potrebujete, ko registrirate konfiguracijo programa v storitvi Dataverse. ID odjemalca uporablja obliko zapisa, kot je Iv23liBWoH6sf7xGrRe9.

  5. Ustvarite in prenesite zasebni ključ na strani z GitHub aplikacij. Zasebni ključ shranite v Azure Key Vault koraku.

    Posnetek zaslona strani GitHub aplikacije z možnostjo »Ustvari zasebni ključ«.

Namestitev GitHub v ciljno skladišče

  1. Na GitHub nastavitve aplikacije v levem podoknu izberite Namesti aplikacijo.

  2. Izberite Namesti zraven računa ali organizacije, ki je lastnik ciljnega skladišča.

    Če ciljno skladišče pripada organizaciji GitHub, mora skrbnik organizacije morda odobriti namestitev programa. Skrbnik prejme obvestilo za pregled in odobritev zahteve.

    Posnetek zaslona strani GitHub namestitev aplikacije.

  3. Izberite, ali želite aplikaciji dodeliti dostop do vseh skladišč ali Samo izberite skladišča. Za najboljše varnostne prakse izberite le določene skladišča, ki jih potrebujete za integracijo nadzora virov.

  4. Izberite Namesti, da dokončate namestitev.

    Posnetek zaslona, na katerem je prikazano izbiranje skladišč za GitHub dostop do aplikacije.

Konfiguriraj storitev Azure Key Vault

  1. Odprite Azure in pojdite na vir shrambe ključev. Če je nimate, najprej ustvarite novo shrambo ključev.

  2. V podoknu Key Vault izberite Tipke v levem podoknu za krmarjenje.

    Posnetek zaslona elementa Azure Key Vault tipk.

  3. Izberite možnost Ustvari/uvozi.

  4. Na spustnem seznamu Možnosti izberite Uvozi.

  5. Vnesite ime ključa, na primer , demoGitHubKeyin nato prenesite datoteko.pem, ki ste jo prenesli iz GitHub.

  6. Izberite Ustvari, da uvozite ključ.

    Posnetek zaslona uvoza ključa v Azure Key Vault.

Opomba

Ko povežete naslednja okolja Dataverse s GitHub, vam ni treba ponoviti prejšnjih korakov GitHub in Azure Key Vault nastavitev. Isto aplikacijo lahko znova GitHub v več skladiščih in isto konfiguracijo Azure Key Vault v več okoljih.

Ustvarjanje GitHub povezave

Ustvarite povezavo OAuth z osebnim računom GitHub računom. Ta povezava preveri, ali imate med namestitvijo skrbniški dostop do ciljnega skladišča. Med izvajanjem aplikacija GitHub komunikacijo s GitHub, zato posameznim uporabnikom ni treba ustvarjati GitHub povezav.

Opomba

Lahko pa namesto povezave uporabite GitHub za osebni dostop (PAT) GitHub povezavo. Pat uporabite, ko je podpora za navidezno omrežje (VNET) omogočena za okolje Dataverse ali ko GitHub ni mogoče ustvariti povezav.

  1. Odprite Power Apps predogled in nato izberite Povezave.

  2. Izberite Nova povezava.

  3. Poiščite in izberite GitHub povezovalnik.

    Posnetek zaslona ustvarjanja nove povezave GitHub v Power Apps.

  4. Vpišite se s svojim GitHub računom in odobrite zahtevani dostop.

    Posnetek zaslona poziva GitHub za vpis za Power Apps povezavo.

Račun GitHub, s katerega se vpišete, mora imeti skrbniški dostop do ciljnega skladišča. Povezava OAuth preveri vaša dovoljenja.

Ko ustvarite povezavo, jo odprite. Zabeležite si ID povezave iz URL-ja v naslovni vrstici brskalnika. To vrednost potrebujete, ko konfigurirate povezavo Git.

ID povezave se prikaže v URL-ju, ko si ogledate podrobnosti povezave, kot je prikazano v tem primeru:

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

Posnetek zaslona strani s Power Apps GitHub povezave, ki prikazuje ID povezave v URL-ju.

Odobritev dostopa do aplikacije OAuth za organizacijo

Če so GitHub vaši organizaciji omogočene omejitve Microsoft dostop do aplikacij, mora skrbnik organizacije odobriti aplikacijo OAuth, ki jo uporablja Power Apps GitHub povezovalnik. Nastavitve organizacije preverite na strani Nastavitve organizacije Dostop>tretjih oseb.

Posnetek zaslona GitHub dostopa do aplikacij drugih ponudnikov v organizaciji.

Če želite več informacij, glejte Omogočanje omejitev dostopa do aplikacije OAuth in Odobritev aplikacij OAuth za organizacijo.

Vzpostavljanje povezave GitHub povezavo iz rešitve

  1. Odprite Power Apps predogleda in ustvarite novo neupravljano rešitev ali izberite obstoječo neupravljano rešitev po meri.

  2. Na strani Kontrolnik vira izberite Poveži.

  3. V podoknu Vzpostavi povezavo z Git izberite GitHub.

    Posnetek zaslona podokna »Poveži z Gitom« z Azure DevOps in GitHub ponudnika.

  4. V prejšnjih GitHub, vnesite informacije o organizaciji, skladišču, veji, mapi Git in povezavi.

    Posnetek zaslona GitHub povezave v podoknu »Vzpostavi povezavo z Gitom«.

  5. Ustvarite konfiguracijo GitHub in vnesite ID GitHub aplikacije, URI Key Vault in ime ključa iz prejšnjih korakov nastavitve.

    Posnetek zaslona, GitHub podrobnosti o konfiguraciji aplikacije v podoknu »Vzpostavi povezavo z Gitom«.

Konfiguracija Key Vault dostopa, ki temelji na vlogah (RBAC)

  1. V Azure pojdite na svoj Key Vault vir.

  2. Izberite Nadzor dostopa (IAM), izberite Dodaj in nato Dodaj dodelitev vloge.

  3. Poiščite in izberite vlogo Key Vault Crypto User.

    Posnetek zaslona izbire vloge Key Vault kriptografije v Azure vloge.

  4. Izberite Izberi člane in nato poiščite upravljano identiteto Dataverse, povezano s konfiguracijo GitHub aplikacijo. Ime upravljane identitete uporablja to obliko zapisa:

    PPMI-githubappconfigmanagedidentity-{GUID}

  5. Izberite upravljano identiteto in nato izberite Pregled + dodeli.

    Posnetek zaslona izbire upravljane identitete Dataverse za Key Vault vloge.

Če se upravljana identiteta ne prikaže, odprite nastavitve okolja Dataverse > Sistemske posle in preverite, ali je prišlo do napak, povezanih GitHub ustvarjanjem konfiguracije aplikacije. Registracija je ustvarjena asinhrono in lahko traja nekaj trenutkov.

Ko je dodelitev vloge dokončana, ima upravljana identiteta Dataverse dovoljenje za uporabo GitHub v tem Key Vault.

Preverite povezavo in preskusite uveljavitev

Odprite neupravljano rešitev v območju Rešitve . Če je še nimate, najprej ustvarite novo rešitev. Integracija nadzora vira deluje le z neupravljanih rešitvami.

Pojdite na stran Kontrolnik vira in izberite Povezava za Git. Preverite, ali je povezava GitHub kot ponudnik in ali so podrobnosti organizacije, skladišča, veje in mape pravilne.

Če želite preveriti tok od konca do konca, izberite Uveljavi, da potisnete rešitev v povezano GitHub skladišče.

Če je uveljavitev uspešna, integracija deluje.

Povezovanje s kodo

S spletnim API-jem Dataverse web ali PowerShell lahko programsko GitHub in ne z uporabniškim vmesnikom. Če želite več informacij, glejte Vzpostavljanje povezave s GitHub skladiščem.

  • Last updated on