Povežite svoj GitHub račun s tokenom kako bi se vaše web-lokacije mogle postavljati iz spremišta

Što vam povezivanje omogućuje

Povezivanje servisa GitHub pomoću tokena omogućuje implementaciju web-mjesta iz jednog od vaših repozitorija: pošaljite promjene u granu i web-mjesto će se ažurirati. Također nam omogućuje objavljivanje na servisu GitHub Pages na vašem računu kada odaberete taj servis kao pružatelja hostiranja web-mjesta.

Ako vaši repozitoriji pripadaju organizaciji, umjesto toga odaberite aplikaciju Zinn® GitHub — pogledajte odjeljak Instalacija aplikacije Zinn® GitHub. Token pripada jednoj osobi i prestaje funkcionirati kada ta osoba napusti organizaciju.

Prije nego što počnete

Potreban vam je račun na servisu GitHub s pristupom repozitorijima koje želite implementirati. Ako oni pripadaju organizaciji, vlasnik će možda trebati odobriti detaljne tokene (fine-grained tokens) za nju.

1. Izrada ključa na servisu GitHub

Na servisu GitHub kliknite svoju profilnu sliku, a zatim Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Dajte mu naziv i odaberite datum isteka. Pod stavkom Repository access odaberite Only select repositories i odaberite one koje implementirate — s najmanjim potrebnim opsegom pristupa.

Pod stavkom Repository permissions dodijelite dopuštenje Read and write za:

• Contents
• Pages
• Administration

Pritisnite Generate token i kopirajte ga — servis GitHub prikazat će ga samo jednom.

2. Povezivanje ovdje

Otvorite odjeljak Integrations na svojoj upravljačkoj ploči i odaberite Connect an account. Odaberite Code hosting kao grupu i GitHub kao račun, unesite podatke u polje API token i pritisnite Connect account.

Testiramo uneseni sadržaj prije nego što se bilo što spremi. Ključ koji ne radi nikada se ne pohranjuje, a poruka o pogrešci navodi što s njim nije u redu. Ključ koji radi čuva se šifriran u našem trezoru tajni (secrets vault) — nikada u našoj bazi podataka — i nikada se više ne prikazuje, čak ni vama.

Što se događa sljedeće

• Web-mjesto se može implementirati izravno iz repozitorija na ovom računu: odaberite ga u postavkama

povezivanja repozitorija web-mjesta, odaberite repozitorij i granu, a slanje promjena pokreće implementaciju.

• Svaka druga grana može dobiti vlastiti pregled, što vam omogućuje provjeru promjene prije nego što ona dospije na

aktivno (live) web-mjesto.

• Statički poslužitelji temeljeni na Gitu, kao što su Render i Azure Static Web Apps, koriste ovu vezu kao

izvor koda web-mjesta.

Ako se povezivanje ne ostvari

Repozitorij se ne prikazuje. Pristup tokena repozitoriju ne obuhvaća taj repozitorij. Uredite token na servisu GitHub i dodajte repozitorij.

Povezivanje je radilo, a zatim je prestalo raditi. Detaljni tokeni istječu na datum koji ste odabrali. Izradite novi token i povežite ga; servis GitHub poslat će vam e-poruku prije isteka tokena.

Prikazuje se poruka da je ključ odbijen. Gotovo uvijek je u pitanju jedno od sljedećeg: s ključem je kopiran razmak ili prijelom retka, ključ je istekao ili je ključ opozvan odnosno ponovno generiran nakon što ste ga kopirali. Izradite novi ključ i ponovno ga zalijepite.

Povezivanje uspijeva, ali kasnije dolazi do pogreške u nekoj radnji. Ključ se uspješno autentificira, ali nema dopuštenje koje je potrebno za tu radnju. Izradite novi ključ s gore navedenim dopuštenjima, a zatim prekinite staru vezu i povežite se pomoću novog ključa.

Prekid veze

Otvorite odjeljak Integrations, pronađite račun i pritisnite Disconnect. Time se odmah briše pohranjeni ključ. Sve što ga je koristilo prestat će raditi prilikom sljedeće radnje, a zasloni koji su o njemu ovisili prikazat će obavijest umjesto da tiho zakažu.

Prekid veze ne poništava ono što je već učinjeno — zapisnici, implementacije ili postavke koje smo izmijenili na vašem računu ostaju kakvi jesu. Ako smatrate da je sam ključ možda kompromitiran, opozovite ga i kod davatelja usluge; prekidom veze uklanja se naša kopija, a ne njihova.