Milyen előnyökkel jár az összekapcsolás
A GitHub token segítségével történő összekapcsolása lehetővé teszi egy webhely telepítését az Ön egyik adattárából: végezzen push műveletet az ágra, és a webhely frissül. Azt is lehetővé teszi számunkra, hogy közzétegyünk a GitHub Pages szolgáltatásban az Ön fiókjában, amennyiben azt választja ki egy webhely tárhelyeként.
Ha az Ön adattárai egy szervezethez tartoznak, használja inkább a Zinn® GitHub alkalmazást — lásd: A Zinn® GitHub alkalmazás telepítése. A token egyetlen személyhez tartozik, és érvényét veszti, amikor az illető távozik.
Mielőtt elkezdené
Egy GitHub-fiók, amely hozzáféréssel rendelkezik a telepíteni kívánt adattárakhoz. Ha ezek egy szervezethez tartoznak, előfordulhat, hogy a tulajdonosnak engedélyeznie kell a részletes jogosultságú tokeneket (fine-grained tokens) a szervezet számára.
1. A kulcs létrehozása a GitHub felületén
A GitHub felületén kattintson a profilképére, majd a Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token menüpontra. Nevezze el, és válassza ki a lejáratot. A Repository access alatt válassza az Only select repositories lehetőséget, és jelölje ki azokat, amelyeket telepít — a lehető legszűkebb működő hozzáférést biztosítva.
A Repository permissions alatt adjon Read and write jogosultságot az alábbiakhoz:
- Contents
- Pages
- Administration
Kattintson a Generate token gombra, és másolja ki a tokent — a GitHub csak egyszer jeleníti meg.
2. Csatlakoztatás itt
Nyissa meg az Integrations menüpontot az irányítópultján, és válassza a Connect an account lehetőséget. Válassza a Code hosting csoportot és a GitHub fiókot, töltse ki az API token mezőt, majd kattintson a Connect account gombra.
Mielőtt bármit elmentenénk, teszteljük a beillesztett adatot. A nem működő kulcsokat soha nem tároljuk, a visszajelzés pedig megadja, hogy mi volt a hiba. A működő kulcsot titkosítva tároljuk a titkos kulcsok tárolójában (secrets vault) — soha nem az adatbázisunkban —, és többé soha nem jelenítjük meg, még Önnek sem.
Mi történik ezután
- A webhely közvetlenül az ezen a fiókon lévő adattárból telepíthető: válassza ki azt a
webhely adattár-kapcsolatánál, jelölje ki az adattárat és az ágat, és a push művelet elindítja a telepítést.
- Minden más ág saját előnézetet kaphat, így ellenőrizheti a módosítást, mielőtt az elérné az
éles webhelyet.
- A Git-alapú statikus tárhelyszolgáltatók, mint például a Render és az Azure Static Web Apps, ezt a kapcsolatot használják
a webhely kódjának forrásaként.
Ha nem sikerül a kapcsolódás
Egy adattár nem jelenik meg. A token adattár-hozzáférése nem tartalmazza azt. Módosítsa a tokent a GitHub felületén, és adja hozzá az adattárat.
Működött, majd leállt. A részletes jogosultságú tokenek az Ön által kiválasztott napon lejárnak. Hozzon létre egy újat, és csatlakoztassa; a GitHub e-mailt küld Önnek a token lejárata előtt.
A rendszer szerint a kulcs el lett utasítva. Szinte mindig a három ok egyike: egy szóköz vagy egy sortörés lett kimásolva vele együtt, a kulcs lejárt, vagy a kulcsot visszavonták, illetve újragenerálták a másolás után. Hozzon létre egy új kulcsot, és illessze be újra.
Csatlakozik, de később valami meghiúsul. A kulcs hitelesítése sikeres, de hiányzik egy olyan jogosultság, amelyre a művelethez szükség van. Hozzon létre egy új kulcsot a fent felsorolt jogosultságokkal, majd bontsa le a régi kapcsolatot, és csatlakoztassa az új kulcsot.
Kapcsolat bontása
Nyissa meg az Integrations menüpontot, keresse meg a fiókot, és kattintson a Disconnect gombra. Ez azonnal törli a tárolt kulcsot. Minden olyan folyamat, amely ezt használta, leáll a következő műveleténél, és az attól függő képernyők ezt jelzik is ahelyett, hogy észrevétlenül hibásan működnének.
A kapcsolat bontása nem vonja vissza azt, ami már megtörtént — a fiókjában általunk módosított rekordok, telepítések vagy beállítások úgy maradnak, ahogy vannak. Ha úgy véli, hogy maga a kulcs kiszivároghatott, vonja vissza azt a szolgáltatónál is; a kapcsolat bontása a mi másolatunkat távolítja el, nem az övékét.