Apa yang sambungan tersebut lakukan untuk anda
Memasang apl Zinn® GitHub membolehkan tapak dibina daripada repositori anda — dan papan projek selari dengan GitHub — tanpa menyerahkan token peribadi kepada kami. Kami hanya menyimpan nombor pemasangan apl tersebut, yang tidak berguna secara sendirinya, dan menjana token yang bertahan selama sejam setiap kali kami memerlukannya. Ini adalah pilihan yang lebih baik untuk organisasi, kerana ia bukan milik mana-mana individu dan tidak berhenti berfungsi apabila seseorang meninggalkan organisasi tersebut.
Sebelum anda bermula
Akaun GitHub, atau hak pemilik pada organisasi tempat anda mahu memasang apl tersebut. Organisasi yang melarang apl pihak ketiga memerlukan pemilik untuk membenarkannya; jika itu tidak mungkin, gunakan token berbutir halus sebagai gantinya (Sambungkan akaun GitHub anda).
1. Cipta kekunci di GitHub
Tiada kekunci yang perlu dicipta. Pasang apl Zinn® GitHub pada akaun peribadi anda atau organisasi anda, dan pilih sama ada semua repositori atau hanya repositori yang anda mahu kami lancarkan.
Kemudian cari nombor pemasangan:
- Akaun peribadi — Tetapan → Aplikasi → Apl GitHub Dipasang, dan Konfigurasikan di sebelah apl Zinn®.
- Organisasi — Organisasi anda → Tetapan → Apl GitHub, dan Konfigurasikan di sebelah apl Zinn®.
Nombor di hujung bar alamat pada halaman tersebut — contohnya github.com/settings/installations/12345678 — ialah nombor pemasangan.
2. Sambungkannya di sini
Apl tersebut dipilih di tempat ia digunakan dan bukannya pada skrin Integrasi:
- Pada sambungan repositori tapak, pilih GitHub (pemasangan apl).
- Pada pautan GitHub papan projek, pilih Apl Zinn® GitHub.
Tampal Nombor pemasangan dan teruskan. Kami menyemak pemasangan sebelum menyimpan apa-apa; nombor yang tidak dapat kami hubungi tidak akan disimpan sama sekali.
Apa yang berlaku seterusnya
- Repositori yang anda berikan akses kepada apl akan muncul untuk tapak melancarkannya, dan tindakan tolak melancarkannya.
- Setiap tindakan yang kami ambil akan muncul dalam log audit pemasangan pada GitHub di bawah nama apl, bukan nama anda.
- Untuk memberi kami lebih banyak repositori, ubah akses repositori apl pada halaman Konfigurasikan yang sama — tiada apa-apa yang perlu disambungkan semula.
Jika ia tidak bersambung
Repositori hilang. Pemasangan hanya merangkumi repositori yang anda pilih. Buka Konfigurasikan dan tambahnya.
Nombor ditolak. Semak sama ada ia adalah nombor pemasangan daripada bar alamat, bukannya ID apl itu sendiri, dan sama ada apl itu masih dipasang — apl yang dinyahpasang tiada pemasangan.
Ia menyatakan kekunci ditolak. Hampir selalu disebabkan oleh salah satu daripada tiga perkara: ruang atau tanda baris baharu disalin bersamanya, kekunci yang telah tamat tempoh, atau kekunci yang telah ditarik balik atau dijana semula selepas anda menyalinnya. Cipta yang baharu dan tampal semula.
Ia bersambung, tetapi sesuatu gagal kemudian. Kekunci disahkan tetapi tidak mempunyai kebenaran yang diperlukan oleh tindakan tersebut. Cipta kekunci baharu dengan kebenaran yang disenaraikan di atas, kemudian putuskan sambungan lama dan sambungkan kekunci baharu.
Memutuskan sambungan
Buka Integrasi, cari akaun dan tekan Putuskan sambungan. Tindakan itu memadamkan kekunci yang disimpan serta-merta. Apa-apa sahaja yang menggunakannya akan berhenti pada tindakan seterusnya, dan skrin yang bergantung padanya akan memaklumkannya daripada gagal secara senyap.
Memutuskan sambungan tidak membatalkan apa yang telah dilakukan — rekod, pelancaran atau tetapan yang kami ubah pada akaun anda kekal seperti sedia ada. Jika anda berfikir kekunci itu sendiri mungkin telah bocor, tarik baliknya juga pada vendor; memutuskan sambungan mengalih keluar salinan kami, bukan salinan mereka.