İçeriğe geç

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).

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 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.

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.

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_URL de ç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
Öğ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.

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_denied ile reddedilir

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

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, review ve comment (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ün CONNECT_GITHUB_REVIEW_BOT_INSTALLS içinde listelediği sunucular için izinlidir. Diğer her sunucuya needs_requester yanı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
  • 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
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)

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.

  1. 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
  2. Kişi tarayıcıda onaylar. Sağlayıcı Connect’e geri döner
  3. 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
  4. Devam et’ten sonra Connect 8 karakterlik bir kod ve bir control-center://oauth-done bağ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
  5. 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.

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
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