Rujukan Control Center Connect
Control Center Connect menjalankan log masuk pembekal untuk pelayan yang belum mendaftarkan apl mereka sendiri. Sebuah
pelayan sama ada menggunakan Connect yang dihoskan oleh Control Center, atau Connect yang dijalankan oleh sebuah organisasi
(Jalankan pelayan Connect), atau tiada. Pilihannya terdapat dalam
Tetapan → Pelayan → Daftar masuk tunggal → Control Center Connect, arahan cc_server connect, atau CC_CONNECT_URL. Sebuah
ruang kerja mengikutnya melainkan pentadbir memilih sesuatu yang lain untuk ruang kerja itu di bawah Tetapan → Ruang kerja → Integrasi (Pilihan setiap ruang kerja).
Setiap pembekal ialah satu lorong. Di bawah Gunakan aplikasi saya sendiri (atau sebelum sesiapa memilih), lorong berjalan pada apl pelayan apabila apl itu dikonfigurasikan sepenuhnya, jika tidak ia tidak tersedia. Dengan Connect Control Center atau Connect tersuai, Connect menjalankan setiap lorong yang dilayaninya: apl pelayan kekal disimpan tetapi tidak digunakan untuk log masuk, automasi pelayan atau status yang dilaporkan pelayan. Ruang kerja yang memilih pilihannya sendiri menjalankan setiap lorong mengikut pilihan itu sebaliknya.
| Lorong | Apl sendiri memerlukan | Melalui Connect |
|---|---|---|
github |
ID apl, kunci peribadi, ID klien dan rahsia klien | Orang log masuk ke GitHub App kongsi |
google |
ID klien dan rahsia klien | Orang menyambungkan Google Calendar |
linear |
ID klien | Orang log masuk ke Linear |
linear_app |
ID klien | Pentadbir ruang kerja menyambungkan aktor apl Linear |
slack |
Sambungan apl Slack sendiri bagi ruang kerja | Pentadbir ruang kerja menyambungkan Slack ke apl Slack kongsi |
klipy |
KLIPY_APP_KEY |
Carian GIF, diproksikan oleh Connect |
Apl sendiri yang hanya dikonfigurasikan sebahagian menjadikan lorongnya ralat, tidak sekali-kali jatuh kembali kepada Connect secara senyap. Ruang kerja pada Gunakan aplikasi saya sendiri tidak sekali-kali melalui apl pelayan atau mana-mana Connect, untuk mana-mana pembekal. Menukar pilihan Connect pelayan tidak mengeluarkan sesiapa daripada ruang kerja yang membuat pilihannya sendiri.
Apa yang Connect lihat dan tidak pernah lihat
Bahagian bertajuk “Apa yang Connect lihat dan tidak pernah lihat”| Connect melihat | Connect tidak pernah melihat |
|---|---|
| ID pemasangan pelayan dan tandatangan permintaan | Kod sumber, kandungan repo, diff atau teks pull request |
| Akaun pembekal yang log masuk, semasa log masuk | Tiket, transkrip atau apa-apa dalam pangkalan data ruang kerja |
| Ruang kerja mana yang dimiliki oleh sesuatu kelayakan, sebagai id legap di dalam pemeteraian | Rahsia apl sendiri pelayan: ia tidak pernah meninggalkan pelayan |
| Repo yang diberi token GitHub satu-repo | Token muat semula dalam keadaan tersimpan: ia hanya wujud di dalam pemeteraian yang pelayan simpan |
| Pasukan Slack yang terikat kepada pelayan | Rahsia Linear: pelayan menukar kod Linear sendiri |
| Istilah carian GIF, apabila ia memproksikan Klipy | Kata laluan, kunci pemasangan atau kunci pembekal model |
| Rujukan peristiwa Slack (pasukan, saluran, ID mesej) dan teks perintah slash | Teks mesej Slack: Connect membuangnya sebaik diterima, dan pelayan membaca mesej dari Slack sendiri |
Connect menyimpan log masuk yang tertangguh, nonce dan cache selama paling lama 10 minit, dan kaunter penggunaan setiap jam selama paling lama dua jam. Token GitHub satu-repositori yang dicetak sebagai seseorang kekal direkodkan, dimeterai kepada log masuk yang memintanya, sehingga tamat tempoh (paling lama 8 jam), supaya Connect boleh mengeluarkannya semula dan membatalkannya apabila diputuskan. Satu-satunya rekod jangka panjangnya ialah ikatan Slack (setiap pasukan Slack terikat kepada pelayan mana) dan ID pemasangan yang telah ditarik balik. Ralat membawa kod, tidak sekali-kali respons pembekal. Log hanya merekodkan ID pemasangan sebagai hash berkunci, dan token GitHub hanya sebagai hashed_token yang ditunjukkan log audit organisasi GitHub untuknya, supaya pemilik organisasi boleh memadankan kedua-duanya.
| Mod | Tetapan | Kelakuan |
|---|---|---|
| Tidak ditetapkan | Pelayan baharu | Tiada lorong menggunakan Connect. Onboarding meminta pemilik pelayan memilih |
hosted |
Gunakan aplikasi Control Center | https://connect.usectrl.dev, dengan konfigurasi yang ditandatangani secara luar talian. Apl pelayan tidak digunakan |
custom |
Gunakan pelayan Connect tersuai | Connect pada URL HTTPS (http hanya pada loopback), dipercayai pada penggunaan pertama. Apl pelayan tidak digunakan |
off |
Gunakan aplikasi saya sendiri | Tiada lorong menggunakan Connect. Hanya apl sendiri yang boleh mendaftar masuk orang |
CC_CONNECT_URL dalam persekitaran atau .env pelayan mengunci pilihan itu: hosted, off, atau URL Connect. Tetapan
kemudian memaparkan kunci dan tidak dapat menukarnya.
Binaan ini tidak menyertakan kunci konfigurasi hosted, jadi mod hosted melaporkan hosted_unprovisioned dan tidak melayani
mana-mana lorong. Apl sendiri dan Connect tersuai tetap berfungsi.
Connect yang dihoskan berjalan dalam satu bekas. Kunci pemeteraian dan kunci peribadi GitHub App kongsi ialah pembolehubah persekitaran di sana, bukan kunci dalam vault yang hanya menandatangani atau menyahsulit, seperti yang disyorkan GitHub untuk kunci peribadi App. Itu ialah jurang yang diketahui dalam persediaan semasa.
Sebuah pelayan membaca konfigurasi Connect paling kerap setiap 10 minit dan menunggu paling lama 5 saat bagi setiap panggilan. Apabila Connect tidak dapat dihubungi, konfigurasi baik terakhir kekal digunakan dan Tetapan menandainya sebagai lapuk.
Pilihan setiap ruang kerja
Bahagian bertajuk “Pilihan setiap ruang kerja”Tetapan → Ruang kerja → Integrasi → Control Center Connect mengatasi pilihan pelayan untuk satu ruang kerja. Setiap ahli melihatnya dan tempat setiap log masuk berjalan; hanya pentadbir ruang kerja boleh mengubahnya.
| Pilihan | Gelagat |
|---|---|
| Sama seperti pelayan ini | Lalai. Ruang kerja berjalan pada apa sahaja yang dipilih pemilik pelayan; pilihan itu menamakannya |
| Gunakan aplikasi Control Center | Connect yang dihoskan oleh Control Center, tanpa mengira apa yang digunakan pelayan |
| Gunakan aplikasi saya sendiri | Hanya apl ruang kerja: GitHub App, klien Google, aplikasi Linear, kunci Klipy dan apl Slack. Pembekal tanpa satu pun dimatikan di sini; medan separa ialah ralat persediaan |
| Gunakan pelayan Connect tersuai | Connect pada alamat HTTPS yang dinamakan oleh ruang kerja. Alamat pada rangkaian persendirian atau tempatan ditolak |
- Mana-mana pilihan selain Sama seperti pelayan ini menyimpan log masuk GitHub dan Linear setiap orang dalam slot milik ruang kerja itu sendiri, jadi ia tidak sekali-kali bercampur dengan yang digunakan di seluruh pelayan
- Menukar meminta pengesahan dahulu: semua orang dalam ruang kerja log masuk semula ke GitHub, Linear dan Google Calendar melalui apl baharu
- Sambungan apl Slack sendiri ruang kerja berfungsi di bawah setiap pilihan; Tambah Control Center ke Slack mengikut pilihan itu
CC_CONNECT_URLjuga mengunci ruang kerja daripada Connect sendiri: mereka boleh mengikut pelayan atau menggunakan apl sendiri- Connect tersuai sesebuah ruang kerja dipercayai pada penggunaan pertama untuk ruang kerja itu sahaja: Percayai aplikasi baharu di sana tidak sekali-kali mengubah apa yang dipercayai oleh pelayan atau ruang kerja lain
Identiti pemasangan
Bahagian bertajuk “Identiti pemasangan”| Item | Maksud |
|---|---|
| Kunci pemasangan | Benih 32 bait dalam fail rahsia pelayan (connect_install_key), berasingan daripada kunci pasangan peranti |
| Kunci setiap-Connect | Kunci Ed25519 yang diperoleh daripada benih dan alamat Connect. Setiap permintaan ke Connect ditandatangani dengannya (RFC 9421) |
| ID pemasangan | 26 aksara yang diperoleh daripada kunci awam itu. Dipaparkan dalam Tetapan dan oleh cc_server connect status |
Pelayan yang sama mempunyai ID pemasangan yang berbeza bagi setiap alamat Connect. ID itu hanya berubah apabila kuncinya diputar.
Pemeteraian kelayakan
Bahagian bertajuk “Pemeteraian kelayakan”Log masuk melalui Connect memulangkan pemeteraian kelayakan: blob tersulit yang hanya boleh dibuka oleh Connect yang mencipta. Ia terikat kepada pembekal, alamat Connect, ID pemasangan, ruang kerja, akaun pembekal, apl dan generasi rahsia.
- Pelayan menyimpan pemeteraian dan ID pemasangan ia dicipta untuknya. Token akses kekal dalam memori
- Untuk menyegarkan, pelayan menghantar pemeteraian kembali dan menerima token akses baharu serta pemeteraian baharu
- Pemeteraian yang ID pemasangan atau alamat Connectnya tidak lagi sepadan akan dibuang apabila dibaca seterusnya, dan pemiliknya log masuk semula. Ini berlaku selepas putaran kunci, apabila bertukar kepada Connect lain, atau apabila direktori data dipulihkan ke pelayan yang berbeza
- Pemeteraian yang tidak dapat dibuka oleh Connect ditolak dengan
access_denied
Pemasangan GitHub
Bahagian bertajuk “Pemasangan GitHub”Pemasangan GitHub App kongsi boleh digunakan dari setiap pelayan. Connect tidak menyimpan rekod tentang pelayan mana boleh menggunakannya.
- Pasang GitHub App dalam Tetapan → Ruang kerja → Integrasi membuka halaman pemasangan app di GitHub. Pelayan membina pautan daripada nama app dalam konfigurasi Connect
- Token satu-repositori memerlukan app dipasang pada pemilik repositori dan akses pengguna yang log masuk kepada repositori itu. Ia token milik orang itu sendiri, dihadkan kepada peranannya, tidak lebih
- Sesebuah organisasi mengehadkan Control Center di GitHub: dengan membuang pemasangan, menyempitkan repositorinya, atau membuang orang itu
- Bagi panggilan yang hanya orang boleh buat, seperti menyenaraikan pemasangan mereka, Connect menghantar kepada pelayan token pengguna App peribadi orang itu, bukan token satu-repositori. Log masuk pada pelayan bermakna mempercayai pelayan itu dengan token tersebut
- Sebuah organisasi yang menguatkuasakan senarai benarkan IP GitHub tidak boleh menggunakan Connect yang dihoskan, kerana alamatnya tidak tetap. Ia mendaftarkan GitHub App sendiri, pada pelayannya atau pada Connect yang dijalankannya
- Putuskan hanya membatalkan log masuk itu: Connect membelanjakan token penyegarnya sekali dan memadam apa yang dikembalikannya, memadam token penggunanya dan token satu-repositori yang Connect cetak untuknya. Salinan pemeteraiannya yang disimpan di mana-mana berhenti berfungsi. Log masuk orang pada pelayan dan ruang kerja lain terus berfungsi. Untuk membuang Control Center daripada akaun GitHub sepenuhnya, batalkannya di GitHub di bawah Settings → Applications → Authorized GitHub Apps → Revoke
Bot yang dikongsi
Bahagian bertajuk “Bot yang dikongsi”Token yang dicetak sebagai bot App (as: app) menunjukkan bot yang sama di GitHub untuk setiap pelayan yang menggunakan Connect yang sama: GitHub tidak dapat membezakan pelayan-pelayan itu.
- Setiap pelayan boleh membenarkan bot membaca dan mengulas:
read,reviewdancomment(komen, label, penerima tugas dan reaksi pada isu dan pull request) - Menyemak pull request sebagai bot (
bot, yang menulis pull request) hanya dibenarkan untuk pelayan yang disenaraikan oleh pengendali Connect dalamCONNECT_GITHUB_REVIEW_BOT_INSTALLS. Setiap pelayan lain dijawabneeds_requesterdan menyiarkan semakan menggunakan token peribadi orang yang bertanggungjawab, yang GitHub hadkan kepada orang itu: semakan muncul di bawah nama mereka. Ini meliputi penyiaran semakan AI, komen semakan dan permintaan penyemak - Menolak, mencipta cawangan dan membuka pull request (
write) tidak sekali-kali dicetak sebagai bot yang dikongsi. Ia sentiasa menggunakan log masuk pemohon sendiri - Meluluskan pull request tidak pernah diautomasikan, pada mana-mana token
- Pelayan atau ruang kerja dengan GitHub App sendiri mengekalkan bot untuk semua ini, termasuk semakan
Perkara yang patut diketahui oleh pemilik dan ahli organisasi
Bahagian bertajuk “Perkara yang patut diketahui oleh pemilik dan ahli organisasi”- Pelayan tempat seseorang log masuk memegang token pengguna App mereka: sehingga 8 jam bagi setiap token, diperbaharui sehingga mereka memutuskan sambungan. Ia boleh bertindak sebagai mereka pada setiap repositori tempat App kongsi dipasang yang boleh mereka capai. Connect boleh memutuskan pelayan selama-lamanya (pemasangan yang ditarik balik atau ditolak), tetapi token yang telah dikeluarkan kekal sah sehingga tamat tempoh
- Memasang GitHub App kongsi pada sebuah organisasi memberi persetujuan untuk setiap pelayan Control Center tempat mana-mana ahli log masuk, bukan untuk satu pelayan sahaja
- Bot itu dikongsi, seperti di atas: sebuah organisasi tidak dapat memberitahu di GitHub pelayan mana yang bertindak sebagai bot
- Organisasi yang mahukan sempadannya sendiri mendaftarkan GitHub App sendiri dan menjalankan Connect sendiri (Jalankan pelayan Connect), atau mengkonfigurasikan App pada pelayannya sendiri
Kepercayaan konfigurasi
Bahagian bertajuk “Kepercayaan konfigurasi”| Connect | Cara pelayan mempercayai konfigurasinya |
|---|---|
| Hosted | Mengesahkan tandatangan Ed25519 berbanding kunci yang disusun dalam binaan. Menolak epoch yang lebih rendah daripada epoch tertinggi yang pernah dilihatnya (rollback) |
| Custom | Mengunci ID app GitHub dan ID klien, ID klien Google dan Linear, serta ID app dan klien Slack pada penggunaan pertama. Perubahan menjeda log masuk Connect (pins_changed) sehingga pemilik pelayan menekan Percayai aplikasi baharu |
Operasi
Bahagian bertajuk “Operasi”Tetapan Connect pelayan hanya untuk pemilik pelayan.
| Operasi | Fungsinya |
|---|---|
connect.status |
Mod, URL, kunci, ID pemasangan, kesihatan, epoch konfigurasi dan sumber setiap lorong |
connect.configure |
Menetapkan hosted, custom (dengan url) atau off |
connect.test |
Mengambil semula konfigurasi dan melaporkan kesihatan |
connect.confirmPins |
Menerima pengecam yang berubah bagi Connect tersuai |
connect.rotateKey |
Menjana kunci pemasangan baharu dan ID pemasangan baharu (force menggantikannya walaupun Connect tidak dapat membatalkan kunci lama); lihat Putar kunci pemasangan |
Pilihan sesebuah ruang kerja mempunyai operasinya sendiri, setiap satu menamakan ruang kerja itu:
| Operasi | Siapa | Lakukan |
|---|---|---|
workspaceConnect.status |
Mana-mana ahli | Pilihan, apa yang ia selesaikan, kesihatan dan sumber setiap pembekal. ID pemasangan dan pin tertunggu untuk pentadbir sahaja |
workspaceConnect.set |
Pentadbir ruang kerja | Menetapkan inherit, hosted, custom (dengan url) atau own |
workspaceConnect.test |
Pentadbir ruang kerja | Mengambil semula konfigurasi Connect ruang kerja dan melaporkan kesihatan |
workspaceConnect.confirmPins |
Pentadbir ruang kerja | Menerima pengecam yang berubah bagi Connect tersuai ruang kerja |
Log masuk sendiri menggunakan oauth.lanes, oauth.begin, oauth.status, oauth.complete, oauth.connections dan
oauth.disconnect. Orang itu sentiasa pemanggil yang telah log masuk.
Log masuk melalui Connect
Bahagian bertajuk “Log masuk melalui Connect”- Pelayan meminta Connect memulakan lorong dan menerima URL kebenaran pembekal, yang disemaknya sebelum dipaparkan. GitHub sentiasa memaparkan pemilih akaunnya
- Orang itu meluluskan dalam pelayar. Pembekal menghantar pelayar kembali ke Connect
- Connect memaparkan apa yang boleh dilakukan oleh pelayan yang memulakan log masuk itu sebagai orang tersebut, dan untuk berapa lama. Connect tidak dapat mengenal pasti siapa yang menjalankan pelayan itu, jadi halaman itu meminta orang tersebut meneruskan hanya jika mereka sendiri yang memulakan log masuk, dan menutupnya jika seseorang menghantar pautan itu kepada mereka. Apabila pelayar berada pada rangkaian lain daripada yang log masuk itu dimulakan, halaman itu menyatakannya: itu normal bagi pelayan yang dihoskan atau peranti lain, dan juga rupa penipuan (phishing). Batal menamatkan log masuk: kod pembekal tidak sekali-kali digunakan. Setiap halaman menjawab sekali sahaja; jawapan yang tidak datang daripada halaman yang baru ditunjukkan Connect ditolak
- Selepas Teruskan, Connect memaparkan kod 8 aksara dan pautan
control-center://oauth-done. Sesiapa yang mendapat kod itu mendapat akses yang baru diluluskan, jadi ia hanya dihantar ke tempat log masuk itu dimulakan - Orang itu menaip kod ke dalam apl, atau mengikut pautan. Pelayan mengklaim log masuk dengan kod itu bersama bukti miliknya tentang permintaan tersebut
Log masuk tamat tempoh selepas 10 minit. Lima kod salah akan menamatkannya. Pautan yang tidak dimulakan oleh apl ini
akan ditolak dengan Log masuk tidak dimulakan di sini. Connect mengehadkan berapa banyak log masuk yang boleh dimulakan oleh satu alamat rangkaian, dan seberapa kerap token GitHub dikeluarkan: bagi setiap orang dan pelayan, bagi setiap orang merentas pelayan, bagi setiap alamat, serta bagi keseluruhan app. Log masuk baharu mempunyai bajet sendiri, jadi ia tidak sekali-kali menahan pembaharuan yang diperlukan orang lain. Melebihi had, panggilan ditolak dengan rate_limited, dan pelayan mencuba semula kemudian tanpa mengeluarkan sesiapa daripada log masuk. Log masuk yang melebihi had orang itu dibatalkan di GitHub dan ditolak.
Putar kunci pemasangan
Bahagian bertajuk “Putar kunci pemasangan”Hanya pemilik pelayan boleh memutar kunci, dengan Putar kunci pada kad Control Center Connect dalam Tetapan → Pelayan → Daftar masuk tunggal. Tiada arahan untuknya. Pemutaran:
- Mengeluarkan semua orang daripada setiap lorong yang berjalan melalui Connect. Bagi setiap pelayan Connect yang kunci lama digunakan dengannya, pelayan membatalkan log masuk GitHub dan Slack yang dipegangnya dari sana (log masuk Google tiada apa untuk dibatalkan dan akan tamat sendiri)
- Menarik balik ID pemasangan lama di setiap pelayan Connect tersebut, ditandatangani dengan kunci lama dan dibuktikan dengan satu pemeteraian kelayakan yang dipegang pelayan daripada Connect itu. Selepas itu Connect menolak setiap permintaan yang dibuat dengan kunci lama, jadi pemeteraian atau salinan kunci lama yang diambil dari pelayan ini tidak berguna, dan ruang kerja Slack yang terikat kepada ID lama dilepaskan supaya ia boleh menyambung semula. Token yang telah dikeluarkan kekal sah sehingga tamat tempoh (sejam bagi token bot, lapan jam bagi token seseorang). Pelayan Connect yang tidak mempunyai pemeteraian daripadanya tiada apa untuk ditarik balik dan dilangkau
- Kemudian memberi pelayan kunci pemasangan baharu dan ID pemasangan baharu
- Jika pelayan Connect tidak dapat dihubungi, atau enggan menarik balik ID lama, ia berhenti sebelum menukar kunci dan memaparkan Connect tidak dapat membatalkan kunci lama. Jana semula juga menukar kunci tanpa mengira; ID lama kemudian kekal boleh digunakan di Connect itu sehingga tokennya tamat tempoh, paling lama 8 jam bagi GitHub
- Membiarkan log masuk melalui apl pelayan sendiri tidak terjejas
- Memerlukan ID pemasangan baharu ditambah ke senarai benar Connect tersuai
Kod status
Bahagian bertajuk “Kod status”| Kod | Maksud |
|---|---|
hosted_unprovisioned |
Binaan ini tiada kunci konfigurasi hosted |
signature |
Konfigurasi hosted gagal pemeriksaan tandatangannya |
rollback |
Connect menghidangkan konfigurasi yang lebih lama daripada yang telah dilihat pelayan |
unreachable |
Pelayan tidak dapat menghubungi Connect |
install_blocked |
Connect tidak membenarkan ID pemasangan ini, atau ia telah ditarik balik |
pins_changed |
Connect tersuai mengumumkan pengecam apl yang berbeza |
protocol |
Connect menjawab dalam bentuk yang tidak difahami pelayan ini |