Bir Connect sunucusu çalıştırma
Control Center Connect, kendi uygulamalarını kaydetmemiş sunucular için sağlayıcı oturum açmalarını (GitHub, Google Calendar, Linear, Slack) yürütür. Bu kılavuz, kendi Connect’inizi nasıl çalıştıracağınızı gösterir; böylece sağlayıcı uygulamaları, onların gizli anahtarları ve onları kullanmasına izin verilen sunucuların listesi sizde kalır.
Connect’in neyi görebildiği ve neyi göremediği Connect referansında yer alır. Bir tane çalıştırıp çalıştırmamaya karar veriyorsanız önce onu okuyun.
Önkoşullar
Bölüm başlığı “Önkoşullar”- Connect için TLS’i sonlandıran bir proxy arkasında,
https://connect.example.comgibi genel bir HTTPS adresi. Düzhttpyalnızca loopback’te kabul edilir - Docker ya da ek ortam değişkenleriyle yeniden başlatabileceğiniz bir
cc_server - Hizmet vermek istediğiniz her sağlayıcıda uygulama kaydetme izni
- Onu kullanacak sunucular ve sahiplerinin erişilebilir olması: her birinin, Connect’in izin listesine eklediğiniz bir kurulum kimliği vardır
1. Adım: Adresi seçin
Bölüm başlığı “1. Adım: Adresi seçin”URL’yi şimdi seçin ve koruyun. CONNECT_PUBLIC_URL, Connect’in yaptığı her şeyin
parçasıdır: istek imzaları, mühürlü kimlik bilgileri, sağlayıcı yönlendirme
URL’leri ve her sunucunun kurulum kimliği ona bağlıdır. Onu daha sonra
değiştirmek, yönlendirmeleri yeniden kaydetmek ve herkesin yeniden oturum açması
demektir.
2. Adım: Sağlayıcı uygulamalarını kaydedin
Bölüm başlığı “2. Adım: Sağlayıcı uygulamalarını kaydedin”Yalnızca hizmet vermek istediğiniz sağlayıcıları kaydedin. Değişkenleri eksik bir
sağlayıcı Connect’in yapılandırmasının dışında bırakılır ve sunucular onu
kullanılamaz olarak görür. Aşağıdaki <base>, sizin CONNECT_PUBLIC_URL
değerinizdir.
| Sağlayıcı | Kaydedin | Saklayın |
|---|---|---|
| GitHub Uygulaması | Callback URL <base>/oauth/github/callback. Redirect on update açıkken Setup URL <base>/oauth/github/setup. Request user authorization (OAuth) during installation’ı kapalı bırakın: açıkken GitHub setup URL’yi yok sayar. Expire user authorization tokens’ı açık tutun |
App id, slug, client id, client secret, özel anahtar |
Yönlendirme URI’si <base>/oauth/google/callback olan Web application türünde bir OAuth istemcisi ve etkinleştirilmiş Google Calendar API |
Client id, client secret | |
| Linear | Callback URL’leri <base>/oauth/linear/callback ve <base>/oauth/linear_app/callback olan bir OAuth uygulaması |
Yalnızca client id |
| Slack | Redirect URL’leri <base>/oauth/slack_oidc/callback ve <base>/oauth/slack/callback. <base>/v1/hooks/slack/events adresinde Event Subscriptions (app_mention, message.*, assistant_thread_*, app_uninstalled, tokens_revoked). <base>/v1/hooks/slack/commands adresinde slash komutları. Token rotation açık |
App id, client id, client secret, signing secret |
GitHub App’e şu depo izinlerini verin: Metadata okuma, Contents okuma ve yazma, Pull requests okuma ve yazma, Issues okuma ve yazma, Checks, Actions ve Commit statuses okuma. Ekip inceleme istekleri için kuruluş Members okuma iznini ekleyin. Webhook’lar kapalı kalabilir: sunucular yoklama yapar.
Connect, GitHub App’in özel anahtarına ihtiyaç duyar (App’in ayarlarında Generate a private key). Connect, bir depoyu kapsayan kurulumu bulan (depo için yoksa sahibin kurulumunu) App isteklerini imzalar ve tek bir depo için kurulum token’ı üretir; bunu yalnızca soran kişinin kendi oturum açması o depoya erişimi kanıtladıktan sonra yapar.
Her sunucu, Connect’inizdeki App’in botunu paylaşır. Bot, bunların herhangi biri için okuyabilir, yorum yazabilir, etiketleyebilir ve tepki verebilir. Bot olarak pull request incelemesine yalnızca CONNECT_GITHUB_REVIEW_BOT_INSTALLS içinde listelediğiniz sunucular izinlidir (kurulum kimlikleri, virgülle ayrılmış); diğer her sunucu incelemeleri incelemecinin kendi token’ı üzerinden yayımlar. Push asla bot olarak yapılmaz. Kendi sunucunuzun bot olarak inceleme yapmasını istiyorsanız kurulum kimliğini oraya ekleyin ve yeniden başlatın. Anahtar dosyasını mühür anahtarı gibi gizli tutun. Linear’ın gizli anahtara ihtiyacı yoktur: Connect kodu sunucuya geri verir, sunucu da değişimi kendisi tamamlar.
3. Adım: Kurulum kimliklerini toplayın
Bölüm başlığı “3. Adım: Kurulum kimliklerini toplayın”Connect yalnızca izin listesindeki sunuculara yanıt verir. Her sunucuda onu Connect’inize yönlendirin, ardından kurulum kimliğini okuyun:
- Ayarlar → Sunucu → Tek oturum açma bölümüne gidin, Control Center Connect kartını açın ve Özel bir Connect sunucusu kullan’ı seçin
- URL’nizi girip kaydedin. Kart, sunucunun Kurulum kimliği’ni gösterir
Sunucunun ana makinesindeki bir terminalden aynısı şöyledir:
cc_server connect enable --url https://connect.example.comcc_server connect statusstatus kurulum kimliğini yazdırır. 5. adım tamamlanana kadar install_blocked
gösterir; bu beklenen bir durumdur.
Bir kurulum kimliği Connect adresi başına türetilir; dolayısıyla aynı sunucunun konuştuğu her Connect için farklı bir kimliği vardır. Kimlik yalnızca sahibi anahtarı değiştirdiğinde değişir.
4. Adım: Bir mühür anahtarı oluşturun
Bölüm başlığı “4. Adım: Bir mühür anahtarı oluşturun”Connect, geri verdiği her kimlik bilgisini bir mühür anahtarıyla şifreler. Bir tane oluşturun ve gizli bir dosya olarak saklayın:
docker run --rm ghcr.io/samuelalev/cc-connect:latest \ cc-connect-config seal-key > seal_keyschmod 600 seal_keysMühür anahtarını kaybetmek herkesin oturumunu kapatır: onsuz hiçbir mühür açılamaz.
5. Adım: Kapsayıcıyı başlatın
Bölüm başlığı “5. Adım: Kapsayıcıyı başlatın”Her sürüm ghcr.io/samuelalev/cc-connect imajını derleme kaynağı bilgisiyle
(build provenance) yayımlar. Üretimde bir sürüm etiketi sabitleyin.
docker run -d --name cc-connect -p 8790:8790 \ -e CONNECT_PUBLIC_URL=https://connect.example.com \ -e CONNECT_ALLOWED_INSTALLS=<install id>,<install id> \ -e CONNECT_SEAL_KEYS_FILE=/run/secrets/seal_keys \ -v "$PWD/seal_keys:/run/secrets/seal_keys:ro" \ -e CONNECT_GITHUB_APP_ID=123456 \ -e CONNECT_GITHUB_APP_SLUG=acme-control-center \ -e CONNECT_GITHUB_CLIENT_ID=Iv23li0123456789abcd \ -e CONNECT_GITHUB_CLIENT_SECRET_FILE=/run/secrets/github \ -v "$PWD/github_secret:/run/secrets/github:ro" \ -e CONNECT_GITHUB_APP_PRIVATE_KEY_FILE=/run/secrets/github_key \ -v "$PWD/github_app_key.pem:/run/secrets/github_key:ro" \ -v cc-connect-data:/data \ ghcr.io/samuelalev/cc-connect:latestTers proxy’nizi 8790 portuna yönlendirin ve CONNECT_TRUST_PROXY değerini, Connect’in önündeki proxy sayısına ayarlayın; böylece adres başına sınır her istemcinin adresini görür. İmaj ayrıcalıksız bir kullanıcı olarak çalışır, durumunu /data biriminde tutar ve yerleşik bir sağlık denetimine sahiptir (/healthz adresini yoklayan cc-connect --healthcheck; süreç yanıt verir). /readyz ayrıca durum ve bağlama depolarının yanıt verdiğini ve kullanılıyorsa Redis’in hâlâ maxmemory-policy noeviction ile çalıştığını denetler; bir orkestratörün hazır olma denetimini oraya yöneltin.
Oturum açma onay sayfası, yalnızca kendi sayfasından gelen bir form gönderisini kabul eden Connect’e geri döner: Sec-Fetch-Site gönderildiyse same-origin olmalı ve Origin gönderildiyse CONNECT_PUBLIC_URL’ın kökeni olmalıdır; ikisi de gönderilmeyen bir gönderi reddedilir. Bu yüzden proxy her iki başlığı da değiştirmeden iletmeli ve CONNECT_PUBLIC_URL, insanların tarayıcılarının gerçekten kullandığı adres olmalıdır. Bu sayfada devam etmek her zaman “This link has expired” gösteriyorsa ve günlük oauth.done_refused olayını origin ya da no_origin nedeniyle yazıyorsa, bu ikisinden biri yanlıştır.
Yapılandırması açık, güvensiz ya da yarım olduğunda Connect başlamayı reddeder
(çıkış kodu 78) ve hangi değişkenin yanlış olduğunu yazdırır. Eksik bir izin
listesi, loopback dışında bir http adresi, bozuk bir mühür anahtarı ya da hem
NAME hem NAME_FILE ayarlanmış olması onu durdurur.
Kontrol noktası: her sunucuda Connect kartı Çalışıyor yazar ve Her oturum
açmanın çalıştığı yer, kaydettiğiniz her sağlayıcı için Connect gösterir.
cc_server connect status, Health: ok ve aynı hatları yazdırır.
cc_server içinde Connect çalıştırma
Bölüm başlığı “cc_server içinde Connect çalıştırma”Bir sunucu ayrı bir kapsayıcı yerine Connect’i kendisi barındırabilir. Bağlanan hizmet, imajın çalıştırdığının aynısıdır.
CONNECT_*değişkenlerini 5. adımdaki gibi sunucunun.envdosyasına koyun.CONNECT_SENTRY_DSNdahil bir Connect gizli anahtarı sunucunun ortamında dışa aktarılmışsa sunucu başlamayı reddederCC_SERVER_CONNECT_HOST=onekleyin- Sunucuyu yeniden başlatın. Günlüğü
embedded Connect at <url>yazdırır
CC_SERVER_CONNECT_HOST=onCONNECT_ALLOWED_INSTALLS=<install id>CONNECT_SEAL_KEYS=<output of cc-connect-config seal-key>CONNECT_GITHUB_APP_ID=123456CONNECT_GITHUB_APP_SLUG=acme-control-centerCONNECT_GITHUB_CLIENT_ID=Iv23li0123456789abcdCONNECT_GITHUB_CLIENT_SECRET=<secret>CONNECT_GITHUB_APP_PRIVATE_KEY_FILE=/etc/cc/github_app_key.pemConnect bundan sonra <server>/connect adresinde sunulur:
CONNECT_PUBLIC_URLvarsayılan olarak sunucunun genel URL kökeni artı/connectolur. Bir proxy arkasında onu açıkça ayarlayın. Yolu tam olarak/connectolmalı ve loopback değilse HTTPS olmalıdır- Bağlanan hizmete yalnızca
CONNECT_*değişkenleri ulaşır; bu yüzden sunucunun kendi sağlayıcı uygulamalarını asla ödünç almaz CONNECT_ALLOWED_INSTALLS, barındıran sunucunun kendisi de dahil olmak üzere hâlâ zorunludur- Yanlış yapılandırılmış bir yerleştirme, açık bir aracı sunmak yerine sunucunun açılmasını durdurur
- Demo sunucusu onu asla bağlamaz
Sağlayıcı yönlendirmelerini https://<server>/connect adresine göre kaydedin,
ardından sunucuları (barındıran dahil) 3. adımdaki gibi o URL’ye yönlendirin.
Yapılandırma referansı
Bölüm başlığı “Yapılandırma referansı”Her ayar bir ortam değişkenidir. Herhangi bir gizli anahtar bunun yerine bağlanmış
bir dosyadan gelebilir: NAME yerine NAME_FILE ayarlayın. Connect dosyayı en
fazla 30 saniyede bir yeniden okur ve son geçerli değeri korur. Çift olarak
işaretlenen gizli anahtarlar, bir değişiklik sırasında NAME_PREVIOUS (ya da
NAME_PREVIOUS_FILE) de kabul eder.
Adres ve erişim
Bölüm başlığı “Adres ve erişim”| Değişken | Varsayılan | Anlamı |
|---|---|---|
CONNECT_PUBLIC_URL |
zorunlu | Kanonik genel URL. HTTPS ya da yalnızca loopback’te http. Bir yol, yerleştirme anlamına gelir. Sorgu ya da parça yok |
CONNECT_ALLOWED_INSTALLS |
zorunlu | Virgülle ayrılmış kurulum kimlikleri. * yalnızca CONNECT_SIGNED_CONFIG_FILE ile birlikte kabul edilir |
CONNECT_DENY_INSTALLS |
İzin verilmiş olsalar bile reddedilen kurulum kimlikleri | |
CONNECT_GITHUB_ALLOWED_OWNERS |
Sayısal GitHub sahip kimlikleri. Ayarlandığında depo token’ları yalnızca onlara ait depolar için üretilir. Kişilerin oturum açmasını sınırlamaz: bu Connect’i kullanmasına izin verilen biri yine kendi App kullanıcı token’ını alır. Yalnızca tek bir kuruluşa hizmet etmek için App’i yalnızca ona özel tutun | |
CONNECT_GITHUB_REVIEW_BOT_INSTALLS |
Bot olarak pull request inceleyebilecek kurulum kimlikleri. Varsayılan olarak boş; * reddedilir ve her kimliğin ayrıca izin verilmiş olması gerekir |
|
CONNECT_HOST, CONNECT_PORT |
0.0.0.0, 8790 |
Bağlanma adresi ve port |
CONNECT_TRUST_PROXY |
0 |
X-Forwarded-For içindeki güvenilir proxy atlamaları (0 ile 8 arası). Yalnızca adres başına sınırlar, oturum açma sayfasının ağ ipucu ve günlüğe yazılan adres için kullanılır. Bir proxy arkasında 0, her istemciyi proxy sayar ve günlük bunu bir kez söyler |
Sağlayıcı hatları
Bölüm başlığı “Sağlayıcı hatları”| Değişken | Varsayılan | Anlamı |
|---|---|---|
CONNECT_GITHUB_APP_ID, CONNECT_GITHUB_APP_SLUG, CONNECT_GITHUB_CLIENT_ID |
GitHub App | |
CONNECT_GITHUB_CLIENT_SECRET |
Gizli anahtar, çift | |
CONNECT_GITHUB_APP_PRIVATE_KEY |
Gizli anahtar. App’in özel anahtarı (PEM) | |
CONNECT_GOOGLE_CLIENT_ID, CONNECT_GOOGLE_CLIENT_SECRET |
Google istemcisi. Gizli anahtar çifttir | |
CONNECT_LINEAR_CLIENT_ID |
Linear uygulaması. Gizli anahtar yok | |
CONNECT_SLACK_APP_ID, CONNECT_SLACK_CLIENT_ID |
Slack uygulaması | |
CONNECT_SLACK_CLIENT_SECRET, CONNECT_SLACK_SIGNING_SECRET |
Gizli anahtarlar, çift | |
CONNECT_KLIPY_APP_KEY |
Klipy GIF arama anahtarı. Gizli anahtar, çift | |
CONNECT_KLIPY_MODE |
proxy |
proxy anahtarı Connect’te tutar; key onu sunuculara verir |
CONNECT_<LANE>_SECRET_GENERATION |
1 |
GitHub, Google ve Slack: yeni mühürlere kaydedilen kuşak |
CONNECT_<LANE>_MIN_SEAL_GENERATION |
1 |
GitHub, Google ve Slack: daha eski mühürler yeniden oturum açmalıdır |
CONNECT_<LANE>_ACCEPTS_NEW |
true |
Her hat: false, mevcut oturumlar yenilenmeye devam ederken yeni oturum açmaları durdurur |
Mühürler, durum ve depolama
Bölüm başlığı “Mühürler, durum ve depolama”| Değişken | Varsayılan | Anlamı |
|---|---|---|
CONNECT_SEAL_BACKEND |
local |
local ya da gcp-kms |
CONNECT_SEAL_KEYS |
Gizli anahtar, local için zorunlu. En yenisi önce olmak üzere virgülle ayrılmış kid:key girdileri; eski girdiler şifre çözmeye devam eder |
|
CONNECT_KMS_KEY |
projects/…/locations/…/keyRings/…/cryptoKeys/…, gcp-kms için zorunlu |
|
CONNECT_STATE |
memory |
Tek örnek için memory, birkaç örnek için redis. Dolu bir bellek deposu, canlı bir girdiyi unutmak yerine yeni oturum açmaları ve istekleri reddeder |
CONNECT_REDIS_URL |
Gizli anahtar. redis:// ya da rediss://. Redis 6.2 veya sonrası, maxmemory-policy noeviction ile; ikisi de başlangıçta denetlenir |
|
CONNECT_REDIS_CA_FILE |
rediss:// için CA paketi |
|
CONNECT_BINDINGS |
file |
Slack ekibi bağlamalarının durduğu yer: file ya da firestore |
CONNECT_DATA_DIR |
data (imajda /data) |
bindings.json dosyasını tutar. Bir Connect tarafından kilitlenir: aynı dizindeki ikinci bir Connect başlamaz |
CONNECT_FIRESTORE_PROJECT, CONNECT_FIRESTORE_DATABASE |
(default) veritabanı |
CONNECT_BINDINGS=firestore için. Firestore yanıt vermezse Connect başlamaz |
Yapılandırma, günlükler ve sınırlar
Bölüm başlığı “Yapılandırma, günlükler ve sınırlar”| Değişken | Varsayılan | Anlamı |
|---|---|---|
CONNECT_SIGNED_CONFIG_FILE |
Çevrimdışı imzalanmış, olduğu gibi sunulan bir yapılandırma. Control Center’ın barındırdığı Connect bunu kullanır | |
CONNECT_CONFIG_PUBLIC_KEYS |
İmzalı yapılandırmanın doğrulanması gereken anahtarlar | |
CONNECT_CONFIG_EPOCH |
1 |
Kendi barındırdığınız bir Connect’in ürettiği yapılandırmanın dönemi |
CONNECT_LOG_HMAC_KEY |
süreç başına rastgele | Gizli anahtar. Kurulum kimliklerinin yerini alan etiketlerin yeniden başlatmalar ve örnekler arasında sabit kalması için ayarlayın |
CONNECT_SENTRY_DSN |
Gizli anahtar. Hata satırlarının bildirildiği bir https Sentry DSN’i: hata türü, yığın çerçeveleri, rota ve istek kimliği; asla bir ileti, gövde ya da üstbilgi değil | |
CONNECT_SENTRY_ENVIRONMENT |
self-hosted |
Sentry ortamı |
CONNECT_VERSION, CONNECT_IMAGE_DIGEST |
/v1/version tarafından bildirilir |
|
CONNECT_RATE_INSTALL_PER_MINUTE |
600 |
Kurulum başına istek |
CONNECT_RATE_IP_PER_MINUTE |
300 |
Adres başına istek (bir IPv6 adresi /64 başına sayılır) |
CONNECT_RATE_GLOBAL_PER_SECOND |
500 |
Tüm örnek için istek |
CONNECT_RATE_SLACK_HOOK_IP_PER_MINUTE |
600 |
Adres başına Slack olay ve komut teslimleri, diğer isteklerden ayrı sayılır |
CONNECT_RATE_SLACK_HOOK_GLOBAL_PER_SECOND |
100 |
Tüm örnek için Slack olay ve komut teslimleri |
CONNECT_RATE_SLACK_TEAM_PER_MINUTE |
600 |
Ekip başına Slack olayı |
CONNECT_RATE_KLIPY_PER_MINUTE |
120 |
Kurulum başına GIF araması |
CONNECT_RATE_KLIPY_IP_PER_MINUTE |
240 |
Adres başına GIF araması, sunucular arasında |
CONNECT_RATE_LOGINS_IP_PER_10_MINUTES |
60 |
Adres başına başlatılan oturum açmalar |
CONNECT_RATE_GITHUB_TOKENS_ACCOUNT_PER_HOUR |
30 |
Bir sunucuda GitHub hesabı başına verilen GitHub token’ları (oturum açmalar, yenilemeler, depo token’ları) |
CONNECT_RATE_GITHUB_TOKENS_ACCOUNT_CEILING_PER_HOUR |
4 × yukarıdaki (120) |
Aynı, tüm sunucular genelinde GitHub hesabı başına |
CONNECT_RATE_GITHUB_TOKENS_IP_PER_HOUR |
600 |
Adres başına verilen GitHub token’ları |
CONNECT_RATE_GITHUB_EXCHANGE_CEILING_PER_HOUR |
500 |
Tüm uygulama için yeni GitHub oturum açmaları |
CONNECT_RATE_GITHUB_APP_MINTS_INSTALL_PER_HOUR |
120 |
Sunucu başına bot token’ları |
CONNECT_RATE_GITHUB_APP_MINTS_ACCOUNT_PER_HOUR |
240 |
Soran GitHub hesabı başına bot token’ları, sunucular arasında |
CONNECT_RATE_GITHUB_APP_CEILING_PER_HOUR |
3000 |
Tüm uygulama için bot token’ları |
CONNECT_RATE_GITHUB_TOKEN_CEILING_PER_HOUR |
1500 |
Tüm uygulama için yenilemeler ve depo token’ları. Yeni oturum açmaların kendi sınırı yukarıdadır |
CONNECT_GITHUB_TOKEN_CAP_WARN |
10 |
Connect’in uyarı yazmadan önce bir GitHub hesabının tutabileceği canlı depo token’ları |
CONNECT_RATE_RETIRE_IP_PER_HOUR |
10 |
Adres başına emekli edilen kurulum kimlikleri (IPv6 için /48 başına) |
Bir sınırı aşan bir çağrı rate_limited ile yanıtlanır. Sunucular daha sonra yeniden dener ve bunun için asla kimseyi oturumdan çıkarmaz.
Birden fazla örnek çalıştırma
Bölüm başlığı “Birden fazla örnek çalıştırma”CONNECT_STATE=memory ile tek bir örnek çoğu kuruluş için yeterlidir. Tek bir
adresin arkasındaki birkaç örnek, bir örnekte başlayan bir oturum açmanın başka
birinde bitebilmesi, her örneğin aynı Slack bağlamalarını ve emekli edilmiş kurulum kimliklerini görmesi için CONNECT_STATE=redis ile birlikte CONNECT_BINDINGS=firestore gerektirir. Paylaşılan bir CONNECT_DATA_DIR çalışmaz: ilk Connect onu kilitler. Kurulum, adres ve örnek başına istek sınırları örnek başınadır; oturum açmalar, GitHub token’ları, bot token’ları, adres başına GIF aramaları, emekliliklerle Slack ekipleri üzerindeki sınırlar ise durum deposu üzerinden paylaşılır.
Bir sağlayıcı gizli anahtarını değiştirme
Bölüm başlığı “Bir sağlayıcı gizli anahtarını değiştirme”Kimsenin oturumu kapanmaz:
- Sağlayıcıda yeni gizli anahtarı oluşturun ve eskisini saklayın
- Eski değeri
NAME_PREVIOUS’a taşıyın, yenisiniNAME’e koyun veCONNECT_<LANE>_SECRET_GENERATIONdeğerini artırın. Bağlanmış dosyalar 30 saniye içinde alınır - Oturum açmaların yenilenmesini bekleyin, ardından sağlayıcıdaki eski gizli
anahtarı silin ve
NAME_PREVIOUS’u kaldırın
Bir mühür anahtarını değiştirmek için CONNECT_SEAL_KEYS içine en başa yeni bir
cc-connect-config seal-key girdisi koyun ve eski girdiyi, onun mühürleri
yenilenene kadar tutun.
Bir uygulamayı değiştirme
Bölüm başlığı “Bir uygulamayı değiştirme”Sunucular, Connect’inizi ilk kullandıklarında onun duyurduğu uygulama ve istemci kimliklerini hatırlar. Bir uygulamayı değiştirirseniz her sunucunun Connect kartı Connect’in uygulamaları değişti gösterir ve Connect üzerinden oturum açmalar, sunucunun sahibi Yeni uygulamalara güven’e basana kadar duraklar. Geçiş yapmadan önce sunucu sahiplerine haber verin; böylece istemin sizden geldiğini bilirler.
Bir sunucuyu engelleme
Bölüm başlığı “Bir sunucuyu engelleme”Kurulum kimliğini CONNECT_DENY_INSTALLS’a ekleyin ve yeniden başlatın. Sahibi
“Connect bu sunucunun kurulum kimliğini engelledi. Connect sunucunu işleten kişiyle iletişime geç.” mesajını görür ve oradaki her Connect oturum açması durur.
Bir sunucu, sahibi anahtarını değiştirdiğinde kendi eski kurulum kimliğini de emekli eder. Kimliğin kendisine ait olduğunu, bu Connect’in onun için oluşturduğu tek bir kimlik bilgisi mührüyle kanıtlar; bu yüzden yalnızca birini oturum açtırmış bir sunucu bir kimliği emekli edebilir. Connect emekli kimlikleri kalıcı olarak tutar; böylece eski anahtar ve onun için yapılmış her mühür çalışmayı durdurur ve eski kimliğe bağlı Slack çalışma alanlarını serbest bırakır. Daha önce verilmiş token’lar kendiliğinden sona erer: bir kişinin token’ları 8 saat içinde, bir botunkiler 1 saat içinde. Connect en fazla 100.000 emekli kimlik tutar; bunun ötesinde bir değiştirme reddedilir ve günlük bunu hata düzeyinde yazar.
Sorun giderme
Bölüm başlığı “Sorun giderme”Bir sunucu Connect’in onu engellediğini söylüyor
Bölüm başlığı “Bir sunucu Connect’in onu engellediğini söylüyor”Kurulum kimliği CONNECT_ALLOWED_INSTALLS içinde değil,
CONNECT_DENY_INSTALLS içinde ya da bir anahtar değiştirmesiyle emekli edilmiş. Kimlik, sahibi anahtarı değiştirdiğinde değişir;
yenisini isteyin.
Tek bir sağlayıcıya yapılan her oturum açma başarısız oluyor
Bölüm başlığı “Tek bir sağlayıcıya yapılan her oturum açma başarısız oluyor”Değişkenlerinden biri eksik olabilir, bu yüzden Connect o hattı dışarıda bıraktı. Başlangıç günlüğünü ve yukarıdaki tabloları kontrol edin. GitHub için app id, slug, client id, client secret ve özel anahtarın beşi de gerekir; Google için hem client id hem de gizli anahtar gerekir.
Oturum açmalar bir yönlendirme uyuşmazlığıyla başarısız oluyor
Bölüm başlığı “Oturum açmalar bir yönlendirme uyuşmazlığıyla başarısız oluyor”Sağlayıcıda kayıtlı yönlendirme CONNECT_PUBLIC_URL ile birebir eşleşmiyor.
Şemayı, ana makineyi, portu ve yerleştirilmiş bir Connect için /connect yolunu
karşılaştırın.
Herkes yeniden oturum açmak zorunda kaldı
Bölüm başlığı “Herkes yeniden oturum açmak zorunda kaldı”Mühür anahtarı değişti ya da kayboldu, bir sunucu anahtarını değiştirdi ya da bir sunucunun verileri başka bir makineye geri yüklendi. Mühürlü bir kimlik bilgisi yalnızca onu oluşturan kurulum ve Connect için açılır.