Control Center Connect referansı
Control Center Connect, kendi uygulamalarını kaydetmemiş sunucular için sağlayıcı
oturum açmalarını yürütür. Bir sunucu ya Control Center’ın barındırdığı Connect’i,
ya kuruluşunun çalıştırdığı bir Connect’i
(Bir Connect sunucusu çalıştırma)
kullanır ya da hiçbirini kullanmaz. Seçim Ayarlar → Sunucu → Tek oturum açma →
Control Center Connect, cc_server connect ya da CC_CONNECT_URL üzerinden
yapılır. Bir çalışma alanı, yöneticisi Ayarlar → Çalışma alanı → Entegrasyonlar altında başka bir seçim yapmadıkça bu seçimi izler (Çalışma alanı başına seçim).
Hatlar
Bölüm başlığı “Hatlar”Kendi uygulamalarımı kullan altında (ya da biri seçilmeden önce) bir hat, sunucunun kendi uygulaması tam olarak yapılandırılmışsa onda çalışır, değilse kullanılamaz. Control Center Connect ya da özel bir Connect ile Connect, sunduğu her hattı çalıştırır: sunucunun kendi uygulamaları kayıtlı kalır ama kullanılmaz; bu, oturum açmalar, sunucu otomasyonu ya da sunucunun bildirdiği durum için geçerlidir. Kendi seçimini yapan bir çalışma alanı, her hattı o seçime göre çalıştırır.
| Hat | Kendi uygulamanın ihtiyaçları | Connect üzerinden |
|---|---|---|
github |
Uygulama id, özel anahtar, istemci id ve istemci gizli anahtarı | Kişiler paylaşılan GitHub App’e oturum açar |
google |
İstemci id ve istemci gizli anahtarı | Kişiler Google Calendar’ı bağlar |
linear |
İstemci id | Kişiler Linear’a oturum açar |
linear_app |
İstemci id | Bir çalışma alanı yöneticisi Linear’ın uygulama aktörünü bağlar |
slack |
Bir çalışma alanının kendi Slack uygulaması bağlantısı | Bir çalışma alanı yöneticisi Slack’i paylaşılan Slack uygulamasına bağlar |
klipy |
KLIPY_APP_KEY |
Connect’in proxy üzerinden sunduğu GIF araması |
Yalnızca kısmen yapılandırılmış bir kendi uygulama, hattını bir hataya dönüştürür; asla Connect’e sessizce geri dönmez. Kendi uygulamalarımı kullan seçeneğindeki bir çalışma alanı, hiçbir sağlayıcı için sunucunun uygulamalarından ya da herhangi bir Connect’ten geçmez. Sunucunun Connect seçimini değiştirmek, kendi seçimini yapmış bir çalışma alanındaki kimseyi oturumdan çıkarmaz.
Connect’in gördükleri ve asla görmedikleri
Bölüm başlığı “Connect’in gördükleri ve asla görmedikleri”| Connect’in gördükleri | Connect’in asla görmedikleri |
|---|---|
| Sunucunun kurulum kimliği ve istek imzaları | Kaynak kodu, depo içerikleri, diff’ler ya da pull request metni |
| Oturum açma sırasında, oturum açan sağlayıcı hesabı | Biletler, transkriptler ya da bir çalışma alanı veritabanındaki herhangi bir şey |
| Bir kimlik bilgisinin hangi çalışma alanına ait olduğu, mührün içinde opak bir kimlik olarak | Sunucunun kendi uygulama sırları: onlar sunucudan hiçbir zaman çıkmaz |
| Tek depoluk bir GitHub token’ının üretildiği depo | Bekleyen yenileme token’ları: yalnızca sunucunun tuttuğu mühürlerin içinde bulunurlar |
| Sunucuya bağlanmış Slack ekibi | Linear gizli anahtarları: sunucu Linear’ın kodunu kendisi değiştirir |
| Klipy için proxy görevi gördüğünde GIF arama terimleri | Parolalar, eşleştirme anahtarları ya da model sağlayıcı anahtarları |
| Slack olay başvuruları (ekip, kanal, ileti kimliği) ve slash komutu metni | Slack ileti metni: Connect onu gelir gelmez atar ve sunucu iletiyi Slack’ten kendisi okur |
Connect, hazırlanan oturum açmaları, nonce’ları ve önbellekleri en fazla 10 dakika,
saatlik kullanım sayaçlarını en fazla iki saat tutar. Bir kişi olarak üretilen tek
depoluk bir GitHub token’ı, onu isteyen oturum açmaya mühürlenmiş olarak, süresi
dolana kadar (en fazla 8 saat) kayıtlı kalır; böylece Connect onu yeniden verebilir ve
bağlantı kesildiğinde iptal edebilir. Kalıcı tek kayıtları Slack bağlamalarıdır (her Slack
ekibinin hangi sunucuya bağlı olduğu) ve emekli edilmiş kurulum kimlikleridir. Hatalar
sağlayıcının yanıtını değil, bir kodu taşır. Günlükler kurulum kimliklerini yalnızca
anahtarlı karmalar olarak, bir GitHub token’ını ise yalnızca GitHub’ın kuruluş denetim
günlüğünün ona gösterdiği hashed_token olarak kaydeder; böylece bir kuruluş sahibi
ikisini eşleştirebilir.
Modlar
Bölüm başlığı “Modlar”| Mod | Ayar | Davranış |
|---|---|---|
| Ayarsız | Yeni sunucu | Hiçbir hat Connect kullanmaz. İlk kurulum sunucu sahibinden seçim yapmasını ister |
hosted |
Control Center’ın uygulamalarını kullan | Çevrimdışı imzalanmış bir yapılandırmayla https://connect.usectrl.dev. Sunucunun kendi uygulamaları kullanılmaz |
custom |
Özel bir Connect sunucusu kullan | İlk kullanımda güvenilen, bir HTTPS URL’sindeki (yalnızca loopback’te http) bir Connect. Sunucunun kendi uygulamaları kullanılmaz |
off |
Kendi uygulamalarımı kullan | Hiçbir hat Connect kullanmaz. Kişileri yalnızca kendi uygulamalar oturum açtırır |
Sunucunun ortamındaki ya da .env dosyasındaki CC_CONNECT_URL seçimi kilitler:
hosted, off ya da bir Connect URL’si. Ayarlar bu durumda kilidi gösterir ve onu
değiştiremez.
Bu derleme hiçbir barındırılan yapılandırma anahtarı içermez; bu yüzden barındırılan
mod hosted_unprovisioned bildirir ve hiçbir hatta hizmet vermez. Kendi
uygulamalar ve özel bir Connect çalışır.
Barındırılan Connect tek bir konteynerde çalışır. Mühür anahtarı ve paylaşılan GitHub App’in özel anahtarı orada ortam değişkenleridir; GitHub’ın bir App’in özel anahtarı için önerdiği gibi yalnızca imzalayan ya da çözen bir kasadaki anahtarlar değildir. Bu, mevcut kurulumun bilinen bir açığıdır.
Bir sunucu Connect’in yapılandırmasını en fazla 10 dakikada bir okur ve her çağrı için en fazla 5 saniye bekler. Connect’e ulaşılamadığında son geçerli yapılandırma kullanılmaya devam eder ve Ayarlar onu eskimiş olarak işaretler.
Çalışma alanı başına seçim
Bölüm başlığı “Çalışma alanı başına seçim”Ayarlar → Çalışma alanı → Entegrasyonlar → Control Center Connect, bir çalışma alanı için sunucunun seçimini geçersiz kılar. Her üye seçimi ve her oturum açmanın nerede çalıştığını görür; yalnızca bir çalışma alanı yöneticisi değiştirebilir.
| Seçim | Davranış |
|---|---|
| Bu sunucuyla aynı | Varsayılan. Çalışma alanı sunucu sahibinin seçtiği her şeyi izler; seçenek bunun ne olduğunu adlandırır |
| Control Center’ın uygulamalarını kullan | Sunucunun ne kullandığından bağımsız olarak Control Center’ın barındırdığı Connect |
| Kendi uygulamalarımı kullan | Yalnızca çalışma alanının kendi uygulamaları: GitHub App’i, Google istemcisi, Linear uygulaması, Klipy anahtarı ve Slack uygulaması. Kendi uygulaması olmayan bir sağlayıcı burada kapalıdır; kısmen yapılandırılmış olan bir kurulum hatasıdır |
| Özel bir Connect sunucusu kullan | Çalışma alanının adını verdiği bir HTTPS adresindeki Connect. Özel veya yerel ağdaki adresler reddedilir |
- Bu sunucuyla aynı dışındaki her seçim, her kişinin GitHub ve Linear oturum açmalarını çalışma alanına ait kendi bölmesinde tutar; böylece sunucu genelindekilerle karışmazlar
- Değişiklik önce sorar: çalışma alanındaki herkes GitHub, Linear ve Google Calendar’a yeni uygulamalar üzerinden yeniden oturum açar
- Çalışma alanının kendi Slack uygulaması bağlantısı her seçimde çalışır; Control Center’ı Slack çalışma alanına ekle seçimi izler
CC_CONNECT_URLde çalışma alanlarını kendi Connect’lerinden kilitler: sunucuyu izleyebilir ya da kendi uygulamalarını kullanabilirler- Bir çalışma alanının özel Connect’ine yalnızca o çalışma alanı için ilk kullanımda güvenilir: orada Yeni uygulamalara güven sunucunun ya da başka bir çalışma alanının güvendiklerini asla değiştirmez
Kurulum kimliği
Bölüm başlığı “Kurulum kimliği”| Öğe | Ne olduğu |
|---|---|
| Kurulum anahtarı | Sunucunun gizli anahtarlar dosyasında (connect_install_key), cihaz eşleştirme anahtarlarından ayrı 32 baytlık bir tohum |
| Connect başına anahtar | Tohumdan ve Connect’in adresinden türetilen bir Ed25519 anahtarı. Connect’e giden her istek onunla imzalanır (RFC 9421) |
| Kurulum kimliği | O açık anahtardan türetilen 26 karakter. Ayarlar’da ve cc_server connect status tarafından gösterilir |
Aynı sunucunun her Connect adresi için farklı bir kurulum kimliği vardır. Kimlik yalnızca anahtar değiştirildiğinde değişir.
Mühürlü kimlik bilgileri
Bölüm başlığı “Mühürlü kimlik bilgileri”Connect üzerinden yapılan bir oturum açma bir kimlik bilgisi mührü döndürür: yalnızca onu oluşturan Connect’in açabildiği şifrelenmiş bir veri bloğu. Mühür sağlayıcıya, Connect adresine, kurulum kimliğine, çalışma alanına, sağlayıcı hesabına, uygulamaya ve gizli anahtar kuşağına bağlıdır.
- Sunucu mührü ve onun mühürlendiği kurulum kimliğini saklar. Erişim token’ları bellekte kalır
- Yenilemek için sunucu mührü geri gönderir ve yeni bir erişim token’ı ile yeni bir mühür alır
- Kurulum kimliği ya da Connect adresi artık eşleşmeyen bir mühür bir sonraki okunuşunda silinir ve o kişi yeniden oturum açar. Bu, bir anahtar değişikliğinden, başka bir Connect’e geçişten ya da farklı bir sunucuya geri yüklenen bir veri dizininden sonra olur
- Connect’in açamadığı bir mühür
access_deniedile reddedilir
GitHub kurulumları
Bölüm başlığı “GitHub kurulumları”Paylaşılan GitHub App’in bir kurulumu her sunucudan kullanılabilir. Connect, hangi sunucunun onu kullanabileceğine dair bir kayıt tutmaz.
- Ayarlar → Çalışma alanı → Entegrasyonlar içindeki GitHub uygulamasını yükle, uygulamanın GitHub’daki kurulum sayfasını açar. Sunucu bağlantıyı, Connect yapılandırmasındaki uygulama adından oluşturur
- Tek depoluk bir belirteç, uygulamanın depo sahibine kurulmuş olmasını ve oturum açan kişinin depoya erişimini gerektirir. Bu, o kişinin kendi belirtecidir; rolüyle sınırlıdır, asla daha fazlası değildir
- Bir kuruluş Control Center’ı GitHub’da sınırlandırır: kurulumu kaldırarak, depolarını daraltarak ya da kişiyi çıkararak
- Kurulumlarını listelemek gibi yalnızca kişinin yapabileceği çağrılar için Connect, sunucuya tek depoluk bir token yerine kişinin kendi App kullanıcı token’ını verir. Bir sunucuda oturum açmak, o sunucuya bu token’ı emanet etmek demektir
- GitHub IP izin listesi uygulayan bir kuruluş, adresleri sabit olmadığı için barındırılan Connect’i kullanamaz. Bunun yerine kendi GitHub App’ini kaydeder: kendi sunucularında ya da çalıştırdığı bir Connect’te
- Bağlantıyı kes yalnızca o oturum açmayı iptal eder: Connect yenileme token’ını bir kez harcar ve dönen şeyi siler, kullanıcı token’ını ve Connect’in onun için ürettiği tek depoluk token’ları siler. Bir mühürün herhangi bir yerdeki kopyası çalışmayı durdurur. Kişinin diğer sunucularda ve çalışma alanlarında yaptığı oturum açmalar çalışmaya devam eder. Control Center’ı bir GitHub hesabından tamamen kaldırmak için GitHub’da Ayarlar → Uygulamalar → Yetkili GitHub Apps → İptal et yolunu izleyin
Paylaşılan bot
Bölüm başlığı “Paylaşılan bot”App’in botu olarak üretilen token’lar (as: app), aynı Connect’i kullanan her sunucu için
GitHub’da aynı botu gösterir: GitHub bu sunucuları birbirinden ayırt edemez.
- Her sunucu botun okumasına ve yorum yapmasına izin verebilir:
read,reviewvecomment(sorunlarda ve pull request’lerde yorumlar, etiketler, atananlar ve tepkiler) - Botun adına bir pull request’i incelemek (
bot, pull request yazar), yalnızca Connect operatörününCONNECT_GITHUB_REVIEW_BOT_INSTALLSiçinde listelediği sunucular için izinlidir. Diğer her sunucuyaneeds_requesteryanıtı verilir ve inceleme, hesap verebilir kişinin kendi token’ıyla yayımlanır; GitHub bunu o kişiyle sınırlar: inceleme, kişinin adıyla görünür. Bu, yapay zekâ incelemesi yayımlamayı, inceleme yorumlarını ve inceleyici isteklerini kapsar - Push etmek, dal oluşturmak ve pull request açmak (
write) paylaşılan bot olarak asla üretilmez. Her zaman isteyenin kendi oturum açmasını kullanır - Bir pull request’i onaylamak, hangi token ile olursa olsun, asla otomatikleştirilmez
- Kendi GitHub App’i olan bir sunucu ya da çalışma alanı bunların tümünü, incelemeler dahil, bot üzerinde tutar
Kuruluş sahipleri ve üyelerin bilmesi gerekenler
Bölüm başlığı “Kuruluş sahipleri ve üyelerin bilmesi gerekenler”- Birinin oturum açtığı bir sunucu, onun App kullanıcı token’ını tutar: token başına en fazla 8 saat, bağlantıyı kesene kadar yenilenir. Ulaşabildiği ve paylaşılan App’in kurulu olduğu her depoda onun adına hareket edebilir. Connect bir sunucuyu kalıcı olarak kesebilir (emekli edilmiş ya da reddedilmiş bir kurulum), ama daha önce verilmiş bir token süresi dolana kadar geçerli kalır
- Paylaşılan GitHub App’i bir kuruluşa kurmak, herhangi bir üyenin oturum açtığı her Control Center sunucusu için onay verir; tek bir sunucu için değil
- Bot, yukarıda belirtildiği gibi paylaşılandır: bir kuruluş GitHub’da hangi sunucunun botu kullandığını ayırt edemez
- Kendi sınırını isteyen bir kuruluş kendi GitHub App’ini kaydeder ve kendi Connect’ini çalıştırır (Bir Connect sunucusu çalıştırma) ya da App’i kendi sunucularında yapılandırır
Yapılandırma güveni
Bölüm başlığı “Yapılandırma güveni”| Connect | Sunucu yapılandırmasına nasıl güvenir |
|---|---|
| Barındırılan | Derlemeye gömülü anahtarlara karşı bir Ed25519 imzasını doğrular. Gördüğü en yüksek dönemden daha düşük bir dönemi reddeder (rollback) |
| Özel | İlk kullanımda GitHub uygulama id’sini ve istemci id’sini, Google ve Linear istemci id’lerini ve Slack uygulama ve istemci id’lerini sabitler. Bir değişiklik, sunucu sahibi Yeni uygulamalara güven’e basana kadar Connect oturum açmalarını duraklatır (pins_changed) |
İşlemler
Bölüm başlığı “İşlemler”Sunucunun Connect ayarları yalnızca sunucu sahibine açıktır.
| İşlem | Ne yapar |
|---|---|
connect.status |
Mod, URL, kilit, kurulum kimliği, sağlık, yapılandırma dönemi ve her hattın kaynağı |
connect.configure |
hosted, custom (url ile) ya da off ayarlar |
connect.test |
Yapılandırmayı yeniden getirir ve sağlığı bildirir |
connect.confirmPins |
Özel bir Connect’in değişmiş tanımlayıcılarını kabul eder |
connect.rotateKey |
Yeni bir kurulum anahtarı ve yeni bir kurulum kimliği üretir (force, eski kimliği bir Connect emekli edemese bile onu değiştirir); bkz. Kurulum anahtarını değiştirme |
Bir çalışma alanının kendi seçimi kendi işlemlerine sahiptir; her biri çalışma alanını adlandırır:
| İşlem | Kim | Ne yapar |
|---|---|---|
workspaceConnect.status |
Herhangi bir üye | Seçim, neye çözüldüğü, sağlık ve her sağlayıcının kaynağı. Kurulum id’si ve bekleyen sabitlemeler yalnızca yöneticiler için |
workspaceConnect.set |
Çalışma alanı yöneticisi | inherit, hosted, custom (url ile) ya da own ayarlar |
workspaceConnect.test |
Çalışma alanı yöneticisi | Çalışma alanının Connect yapılandırmasını yeniden getirir ve sağlığı bildirir |
workspaceConnect.confirmPins |
Çalışma alanı yöneticisi | Çalışma alanının özel Connect’inin değişmiş tanımlayıcılarını kabul eder |
Oturum açmaların kendileri oauth.lanes, oauth.begin, oauth.status,
oauth.complete, oauth.connections ve oauth.disconnect kullanır. Kişi her
zaman oturum açmış çağırandır.
Connect üzerinden oturum açma
Bölüm başlığı “Connect üzerinden oturum açma”- Sunucu Connect’ten hattı başlatmasını ister ve sağlayıcının yetkilendirme URL’sini alır; onu göstermeden önce denetler. GitHub her zaman hesap seçicisini gösterir
- Kişi tarayıcıda onaylar. Sağlayıcı Connect’e geri döner
- Connect, oturum açmayı başlatan sunucunun kişi olarak neler yapabileceğini ve bunu ne kadar süreyle yapabileceğini gösterir. Connect bu sunucuyu kimin çalıştırdığını bilemez; bu yüzden sayfa, kişiden yalnızca oturum açmayı kendisi başlattıysa devam etmesini ister, bir başkası ona bağlantıyı gönderdiyse kapatmasını ister. Tarayıcı, oturum açmanın başlatıldığı ağdan farklı bir ağdaysa sayfa bunu söyler: bu barındırılan bir sunucu ya da başka bir cihaz için normaldir ve aynı zamanda oltalamanın göründüğü şekildir. İptal oturum açmayı sonlandırır: sağlayıcının kodu asla kullanılmaz. Her sayfa bir kez yanıtlanır; Connect’in az önce gösterdiği sayfadan gelmeyen bir yanıt reddedilir
- Devam et’ten sonra Connect 8 karakterlik bir kod ve bir
control-center://oauth-donebağlantısı gösterir. Kodu alan herkes az önce onaylanan erişimi alır; bu yüzden kod yalnızca oturum açmanın başlatıldığı yere gitmelidir - Kişi kodu uygulamaya yazar ya da bağlantıyı izler. Sunucu oturum açmayı kodla ve isteğin kendine ait kanıtıyla talep eder
Bir oturum açma 10 dakika sonra sona erer. Beş yanlış kod onu sonlandırır. Bu
uygulamanın başlatmadığı bir bağlantı Oturum açma burada başlatılmadı ile
reddedilir. Connect, bir ağ adresinin başlatabileceği oturum açma sayısını ve GitHub
token’larının kişi ve sunucu başına, kişi başına sunucular arasında, adres başına ve tüm
uygulama için ne sıklıkla verilebileceğini sınırlar. Yeni oturum açmaların kendi bütçeleri
vardır; bu yüzden başkalarının ihtiyaç duyduğu yenilemeleri asla geciktirmezler. Bir sınırı
aşan bir çağrı rate_limited ile reddedilir ve sunucu oturum kapatmadan daha sonra yeniden
dener. Kişinin sınırını aşan bir oturum açma GitHub’da geri alınır ve reddedilir.
Kurulum anahtarını değiştirme
Bölüm başlığı “Kurulum anahtarını değiştirme”Connect kartındaki Anahtarı yalnızca sunucu sahibi değiştirebilir; Ayarlar → Sunucu → Tek oturum açma altındaki Control Center Connect kartında Anahtarı değiştir ile. Bunun için bir komut yoktur. Değiştirme:
- Connect üzerinden çalışan her hatta herkesin oturumunu kapatır. Eski anahtarın kullanıldığı her Connect sunucusu için sunucu, oradan tuttuğu GitHub ve Slack oturum açmalarını iptal eder (bir Google oturum açmasının iptal edilecek bir şeyi yoktur ve kendiliğinden sona erer)
- Bu Connect sunucularının her birinde eski kurulum kimliğini emekli eder; bunu eski anahtarla imzalar ve sunucunun o Connect’ten tuttuğu bir kimlik bilgisi mührüyle kanıtlar. Bundan sonra Connect eski anahtarla yapılan her isteği reddeder; böylece bu sunucudan alınmış bir mühür ya da eski anahtarın bir kopyası işe yaramaz ve eski kimliğe bağlı Slack çalışma alanları serbest kalır, yeniden bağlanabilirler. Daha önce verilmiş token’lar süresi dolana kadar geçerli kalır (bot token’ı için bir saat, bir kişinin token’ı için sekiz saat). Bu sunucunun hiçbir mührünü tutmadığı bir Connect sunucusunun emekli edilecek bir şeyi yoktur ve atlanır
- Ardından sunucuya yeni bir kurulum anahtarı ve yeni bir kurulum kimliği verir
- Bir Connect sunucusuna ulaşılamazsa ya da eski kimliği emekli etmeyi reddederse, anahtarları değiştirmeden durur ve Connect eski anahtarı kaldıramadı mesajını gösterir. Yine de yenile anahtarları her durumda değiştirir; bu durumda eski kurulum kimliği, token’ları süresi dolana kadar o Connect’te kullanılabilir kalır; GitHub için en fazla 8 saat
- Sunucunun kendi uygulamaları üzerinden yapılan oturum açmalara dokunmaz
- Yeni kurulum kimliğinin özel bir Connect’in izin listesine eklenmesini gerektirir
Durum kodları
Bölüm başlığı “Durum kodları”| Kod | Anlamı |
|---|---|
hosted_unprovisioned |
Bu derlemenin barındırılan yapılandırma anahtarı yok |
signature |
Barındırılan yapılandırma imza denetiminden geçemedi |
rollback |
Connect, sunucunun daha önce gördüğünden daha eski bir yapılandırma sundu |
unreachable |
Sunucu Connect’e ulaşamıyor |
install_blocked |
Connect bu kurulum kimliğine izin vermiyor veya kimlik emekli edilmiş |
pins_changed |
Özel bir Connect farklı uygulama tanımlayıcıları duyurdu |
protocol |
Connect bu sunucunun anlamadığı bir biçimde yanıt verdi |