Manfaat menyambungkannya untuk anda
Menyambungkan GitHub dengan token membolehkan laman diatur kedudukan daripada salah satu repositori anda: tolak ke cawangan dan laman akan dikemas kini. Ia juga membolehkan kami menerbitkan ke GitHub Pages pada akaun anda di mana anda memilihnya sebagai hos laman.
Jika repositori anda milik sesebuah organisasi, utamakan aplikasi Zinn® GitHub — lihat Pasang aplikasi Zinn® GitHub. Sesuatu token adalah milik seorang individu dan berhenti berfungsi apabila mereka keluar.
Sebelum anda bermula
Akaun GitHub dengan akses kepada repositori yang ingin anda atur kedudukan. Jika ia milik sesebuah organisasi, pemilik mungkin perlu meluluskan token butiran terperinci (fine-grained) untuknya.
1. Cipta kunci di GitHub
Di GitHub, klik gambar profil anda, kemudian Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Berikan nama dan pilih tarikh tamat tempoh. Di bawah Repository access pilih Only select repositories dan pilih repositori yang anda atur kedudukan — akses paling terhad yang berfungsi.
Di bawah Repository permissions berikan Read and write untuk:
- Contents
- Pages
- Administration
Tekan Generate token dan salinnya — GitHub memaparkannya sekali sahaja.
2. Sambungkannya di sini
Buka Integrations dalam papan pemuka anda dan pilih Connect an account. Pilih Code hosting sebagai kumpulan dan GitHub sebagai akaun, isi API token, dan tekan Connect account.
Kami menguji apa yang anda tampal sebelum apa-apa disimpan. Kunci yang tidak berfungsi tidak akan disimpan, dan jawapan akan menyatakan apa yang tidak kena dengannya. Kunci yang berfungsi disimpan secara disulitkan dalam peti rahsia kami — tidak sekali-kali dalam pangkalan data kami — dan tidak akan dipaparkan lagi, termasuk kepada anda.
Apa yang berlaku seterusnya
- Sesuatu laman boleh diatur kedudukan terus daripada repositori pada akaun ini: pilih ia pada
sambungan repositori laman, pilih repositori serta cawangan, dan tindakan menolak akan mengatur kedudukan.
- Setiap cawangan lain boleh mendapatkan pratontonnya sendiri, membolehkan anda menyemak perubahan sebelum ia sampai ke
laman langsung.
- Hos statik binaan Git seperti Render dan Azure Static Web Apps menggunakan sambungan ini sebagai
sumber kod laman.
Jika ia tidak bersambung
Repositori tidak muncul. Akses repositori token tidak menyertakannya. Edit token di GitHub dan tambah repositori tersebut.
Ia berfungsi dan kemudian berhenti. Token butiran terperinci tamat tempoh pada tarikh yang anda pilih. Jana yang baharu dan sambungkannya; GitHub menghantar e-mel kepada anda sebelum token tamat tempoh.
Ia menyatakan kunci telah ditolak. Hampir selalu disebabkan oleh salah satu daripada tiga perkara: ruang atau pemutus baris yang disalin bersamanya, kunci yang telah tamat tempoh, atau kunci yang telah dibatalkan atau dijana semula selepas anda menyalinnya. Cipta yang baharu dan tampalkannya semula.
Ia bersambung, tetapi berlaku kegagalan kemudiannya. Kunci berjaya disahkan tetapi tiada kebenaran yang diperlukan oleh tindakan tersebut. Cipta kunci baharu dengan kebenaran yang disenaraikan di atas, kemudian putuskan sambungan lama dan sambungkan kunci baharu.
Memutuskan sambungan
Buka Integrations, cari akaun dan tekan Disconnect. Ini akan memadamkan kunci yang disimpan serta-merta. Apa-apa sahaja yang menggunakannya akan berhenti pada tindakan seterusnya, dan skrin yang bergantung padanya akan memaklumkannya dan bukannya gagal secara senyap.
Memutuskan sambungan tidak membatalkan apa yang telah dilakukan — rekod, pelaksanaan atur kedudukan atau tetapan yang kami ubah pada akaun anda kekal seperti sedia ada. Jika anda berpendapat kunci itu sendiri mungkin telah bocor, batalkannya juga di pihak vendor; memutuskan sambungan memadamkan salinan kami, bukan salinan mereka.