Povezivanje s GitHub (pretpregled)

[Ovaj je članak iz dokumentacije predizdanja i podložan je promjenama.]

Da biste povezali okruženje ili rješenje za Dataverse s programom GitHub, stvorite aplikaciju GitHub, pohranite privatni ključ aplikacije u Azure Key Vault, stvorite vezu dodatka Power Platform GitHub, a zatim se povežite iz okruženja kontrole izvora u svom rješenju.

Rješenjima možete pristupiti s Power Apps, Power Automate, Power Pages i Copilot Studio.

Važno

  • Ovo je značajka pretpregleda.
  • Značajke pretpregleda nisu namijenjene u proizvodne svrhe i mogu imati ograničene funkcije. Te su značajke dostupne prije službenog izdavanja da bi se klijentima omogućio prijevremeni pristup i slanje povratnih informacija.

Preduvjeti

  • Integracija Dataverse Gita je značajka upravljanih okruženja. Razvojna i ciljna okruženja moraju biti omogućena kao upravljana okruženja.
  • Račun GitHub s administratorskim pristupom tvrtke ili ustanove.
  • Pretplata Azure s dozvolom za stvaranje Key Vault resursa. Podaci Key Vault moraju biti u istom klijentu Microsoft Entra kao i okruženje Dataverse.
  • Potrebno vam je okruženje Dataverse u kojem imate sigurnosnu ulogu administratora sustava.
  • Prilagođeno neupravljano rješenje koje želite povezati s izvornom kontrolom. Ako ga još nemate, stvorite ga.

Stvaranje GitHub aplikacije

  1. Otvorite GitHub u pregledniku. U gornjem desnom kutu odaberite svoju profilnu sliku, a zatim idite na Postavke Postavke za razvojne>inženjere.

  2. Odaberite Nova GitHub aplikacija.

    Možete i izravno otići na stranicu GitHub registracije aplikacije da biste stvorili novu GitHub aplikaciju.

  3. Na stranici Stvaranje GitHub unesite jedinstveni naziv za aplikaciju GitHub u polje GitHub Naziv aplikacije. Primjerice, unesite MyOrgGitHubIntegrationApp.

  4. Ispunite polje URL početne stranice. Možete koristiti web-mjesto tvrtke ili ustanove ili URL GitHub spremišta.

  5. Ako vam nisu potrebne obavijesti o web-dojavi, poništite potvrdni okvir Aktivno u odjeljku Webhook .

    Snimka zaslona stranice GitHub stvori aplikaciju s poljem GitHub naziva aplikacije.

Konfiguriranje dozvola za spremište

  1. Pomaknite se prema dolje do odjeljka Dozvole.

  2. Proširite dozvole spremišta, a zatim postavite Sadržaj naČitanje i pisanje. Ta dozvola aplikaciji omogućuje čitanje i pisanje sadržaja spremišta za integraciju kontrole izvora.

    Snimka zaslona s dozvolama spremišta za GitHub aplikacije.

  3. Pomaknite se prema dolje i odaberite Stvori GitHub aplikaciju.

  4. Na stranici GitHub postavke aplikacije kopirajte ID klijenta. Ta vam je vrijednost potrebna kada registrirate konfiguraciju aplikacije u aplikaciji Dataverse. ID klijenta koristi oblik kao što je Iv23liBWoH6sf7xGrRe9.

  5. Generirajte i preuzmite privatni ključ sa stranice GitHub aplikacije. Privatni ključ pohranite u Azure Key Vault kasnijem koraku.

    Snimka zaslona stranice GitHub aplikacije s mogućnošću generiranja privatnog ključa.

Instalacija aplikacije GitHub na ciljno spremište

  1. Na stranici GitHub aplikacije odaberite Instaliraj aplikaciju u lijevom oknu.

  2. Pokraj računa ili tvrtke ili ustanove koji je vlasnik ciljnog spremišta odaberite Instaliraj.

    Ako ciljno spremište pripada tvrtki ili ustanovi GitHub, administrator tvrtke ili ustanove možda će morati odobriti instalaciju aplikacije. Administrator prima obavijest da bi pregledao i odobrio zahtjev.

    Snimka zaslona stranice GitHub instalaciju aplikacije.

  3. Odaberite želite li aplikaciji omogućiti pristup svim spremištima ili Samo odaberite spremišta. Da biste postigli najbolje prakse za sigurnost, odaberite samo specifična spremišta potrebna za integraciju kontrole izvora.

  4. Odaberite Instaliraj da biste dovršili instalaciju.

    Snimka zaslona odabira spremišta za pristup GitHub aplikaciji.

Konfiguriranje značajke Azure Key Vault

  1. Otvorite Azure i idite na resurs sefa ključa. Ako ga nemate, najprije stvorite novi sef ključeva.

  2. U Key Vault u lijevom navigacijskom oknu odaberite Tipke.

    Snimka zaslona navigacijske Azure Key Vault tipke.

  3. Odaberite Generiranje/uvoz.

  4. Na padajućem izborniku Mogućnosti odaberite Uvoz.

  5. Unesite naziv ključa, npr. demoGitHubKey, a zatim prenesite .pem datoteku koju ste preuzeli s GitHub.

  6. Odaberite Stvori da biste uvezli ključ.

    Snimka zaslona uvoza ključa u Azure Key Vault.

Stvaranje GitHub veze

Stvorite OAuth vezu pomoću osobnog računa GitHub račun. Ova veza provjerava imate li administratorski pristup ciljnom spremištu tijekom postavljanja. Prilikom izvođenja aplikacija GitHub upravlja komunikacijom s GitHub, pa pojedinačni korisnici ne moraju stvarati GitHub veze.

Napomena

Ne možete koristiti veze GitHub kada omogućite podršku za virtualnu mrežu (VNET) za okruženje Dataverse. Umjesto toga koristite GitHub osobni pristupni token (PAT).

  1. Idite na Power Apps za stvaranje web-mjesta, a zatim odaberite Veze.

  2. Odaberite Nova veza.

  3. Potražite i odaberite standardni GitHub poveznik.

    Snimka zaslona stvaranja nove GitHub u Power Apps.

  4. Prijavite se pomoću svog GitHub i odobrite zatraženi pristup.

    Snimka zaslona GitHub upita za prijavu za Power Apps vezu.

Račun GitHub pomoću koji se prijavljujete mora imati administratorski pristup ciljnom spremištu. OAuth veza provjerava vaše dozvole.

Kada stvorite vezu, otvorite je. Obratite pozornost na ID veze s URL-a u adresnoj traci preglednika. Ta vam je vrijednost potrebna kada konfigurirate Git vezu.

ID veze prikazuje se u URL-u kada prikažete pojedinosti o vezi, kao što je prikazano u sljedećem primjeru:

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

Snimka zaslona stranice Power Apps GitHub pojedinosti o vezi s ID-jem veze u URL-u.

Odobravanje pristupa aplikaciji OAuth za tvrtku ili ustanovu

Ako u tvrtki GitHub ili ustanovi nisu Microsoft pristup aplikacijama, administrator tvrtke ili ustanove mora odobriti aplikaciju OAuth koju koristi Power Apps GitHub poveznik. Provjerite postavke tvrtke ili ustanove u odjeljku Postavke tvrtke ili ustanove>Pristup treće strane.

Snimka zaslona GitHub s postavkama pristupa aplikacijama drugih proizvođača.

Dodatne informacije potražite u članku Omogućivanje ograničenja pristupa aplikacijama OAuth i Odobravanje aplikacija OAuth za tvrtku ili ustanovu.

Povezivanje s GitHub iz rješenja

  1. Stvorite novo neupravljano rješenje ili odaberite postojeće prilagođeno neupravljano rješenje.

  2. Na stranici Kontrola izvora odaberite Poveži.

  3. U oknu Povezivanje s Gitom odaberite GitHub.

    Snimka zaslona okna Povezivanje s Gitom s mogućnostima Azure DevOps i GitHub servisa.

  4. Unesite podatke GitHub tvrtke ili ustanove, spremišta, ogranka, mape Git i informacija o vezi iz prethodnih koraka postavljanja.

    Snimka zaslona GitHub pojedinosti o vezi u oknu Povezivanje sa servisom Git.

  5. Stvorite konfiguraciju GitHub aplikacije i unesite ID klijenta GitHub aplikacije sustava Windows, Key Vault URI i naziv ključa iz prethodnih koraka postavljanja.

    Snimka zaslona GitHub pojedinosti o konfiguraciji aplikacije u oknu Povezivanje sa servisom Git.

Konfiguriranje Key Vault pristupa utemeljene na ulogama (RBAC)

  1. Na Azure portalu za korisnike otvorite Key Vault resursa.

  2. Odaberite Kontrola pristupa (IAM), odaberite Dodaj, a zatim Dodaj dodjelu uloga.

  3. Potražite i odaberite ulogu Key Vault Crypto User.

    Snimka zaslona odabira uloge Key Vault Crypto User u Azure dodjeli uloga.

  4. Odaberite Odabir članova, a zatim potražite upravljani identitet Dataverse povezan s konfiguracijom GitHub aplikacije. Naziv upravljanog identiteta koristi sljedeći oblik:

    PPMI-githubappconfigmanagedidentity-{GUID}

  5. Odaberite upravljani identitet, a zatim Odaberite Pregled + dodijeli.

    Snimka zaslona odabira upravljanog identiteta Dataverse za dodjelu Key Vault uloga.

Ako se upravljani identitet ne prikazuje, otvorite postavke okruženja Dataverse Zadaci sustava i provjerite ima li pogrešaka povezanih s GitHub stvaranja konfiguracije > aplikacije. Registracija se stvara asinkrono i može potrajati nekoliko trenutaka.

Kada dodjela uloga završi, upravljani identitet Dataverse ima dozvolu za korištenje ključa GitHub u ovoj Key Vault.

Provjera veze i testiranje izvršavanja

Otvorite neupravljano rješenje iz područja Rješenja. Ako ga još nemate, najprije stvorite novo rješenje. Integracija kontrole izvora funkcionira samo s neupravljanim rješenjima.

Idite na stranicu s kontrolom izvora i odaberite Git veza. Provjerite prikazuje li se GitHub kao davatelj usluga te jesu li pojedinosti o spremištu, ogranku i mapi ispravne.

Da biste provjerili protok od kraja do kraja, odaberite Potvrdi da biste svoje rješenje proslijedili u GitHub spremište.

Ako izvršavanje uspije, integracija je operativna.

Povezivanje pomoću koda

Dataverse Web API ili PowerShell možete koristiti za programsko povezivanje GitHub povezivanje umjesto korištenja korisničkog sučelja. Dodatne informacije potražite u članku Povezivanje s GitHub spremišta.

  • Last updated on