رفتن به محتوا

اجرای سرور Connect

Control Center Connect ورود به ارائه‌دهندگان (GitHub، Google Calendar، Linear و Slack) را برای سرورهایی اجرا می‌کند که برنامه‌های خودشان را ثبت نکرده‌اند. این راهنما نشان می‌دهد چگونه Connect خودتان را اجرا کنید، تا برنامه‌های ارائه‌دهنده، رازهای آنها و فهرست سرورهایی که اجازهٔ استفاده از آنها را دارند، نزد خودتان بماند.

آنچه Connect می‌تواند و نمی‌تواند ببیند در مرجع Connect آمده است. اگر دربارهٔ اجرای آن تصمیم می‌گیرید، ابتدا آن را بخوانید.

  • یک نشانی عمومی HTTPS برای Connect، مانند https://connect.example.com، پشت یک پروکسی که TLS را پایان می‌دهد. http ساده فقط روی loopback پذیرفته می‌شود
  • Docker، یا یک cc_server که بتوانید با متغیرهای محیطی اضافی دوباره راه‌اندازی‌اش کنید
  • اجازه برای ثبت برنامه نزد هر ارائه‌دهنده‌ای که می‌خواهید سرویس دهید
  • سرورهایی که از آن استفاده می‌کنند، با مالکانشان در دسترس: هر کدام یک شناسهٔ نصب (install id) دارد که آن را به فهرست مجاز Connect اضافه می‌کنید

همین حالا نشانی را انتخاب و نگه دارید. CONNECT_PUBLIC_URL در همه‌چیز Connect نقش دارد: امضای درخواست‌ها، مهرهای اعتبارنامه، نشانی‌های بازگشت ارائه‌دهنده و شناسهٔ نصب هر سرور همه به آن گره خورده‌اند. تغییر آن بعداً یعنی ثبت دوباره بازگشت‌ها و ورود دوبارهٔ همهٔ افراد.

گام ۲: برنامه‌های ارائه‌دهنده را ثبت کنید

بخش با عنوان “گام ۲: برنامه‌های ارائه‌دهنده را ثبت کنید”

فقط ارائه‌دهندگانی را ثبت کنید که می‌خواهید سرویس دهید. ارائه‌دهنده‌ای که متغیرهایش ناقص است از پیکربندی Connect کنار گذاشته می‌شود و سرورها آن را غیرقابل‌دسترس می‌بینند. <base> در ادامه همان CONNECT_PUBLIC_URL شماست.

ارائه‌دهنده ثبت نگه دارید
برنامهٔ GitHub Callback URL ‏<base>/oauth/github/callback. Setup URL ‏<base>/oauth/github/setup با Redirect on update روشن. Request user authorization (OAuth) during installation را خاموش بگذارید: وقتی روشن باشد، GitHub نشانی setup را نادیده می‌گیرد. Expire user authorization tokens را روشن نگه دارید App id، slug، client id، client secret، یک کلید خصوصی
Google یک OAuth client از نوع Web application با redirect URI ‏<base>/oauth/google/callback، و Google Calendar API فعال Client id، client secret
Linear یک برنامهٔ OAuth با callback URLs ‏<base>/oauth/linear/callback و <base>/oauth/linear_app/callback فقط Client id
Slack Redirect URLs ‏<base>/oauth/slack_oidc/callback و <base>/oauth/slack/callback. Event Subscriptions در ‏<base>/v1/hooks/slack/events (app_mention، message.*، assistant_thread_*، app_uninstalled، tokens_revoked). Slash commands در ‏<base>/v1/hooks/slack/commands. Token rotation روشن App id، client id، client secret، signing secret

به GitHub App این مجوزهای مخزن را بدهید: Metadata با دسترسی خواندن، Contents با خواندن و نوشتن، Pull requests با خواندن و نوشتن، Issues با خواندن و نوشتن، و Checks، Actions و Commit statuses با دسترسی خواندن. برای درخواست‌های بازبینی تیمی، Members با دسترسی خواندن را به سازمان اضافه کنید. Webhooks می‌تواند خاموش بماند: سرورها نظرسنجی می‌کنند.

Connect به کلید خصوصی GitHub App نیاز دارد (Generate a private key در تنظیمات App). این کلید درخواست‌های App را امضا می‌کند تا نصبی را پیدا کند که یک مخزن را پوشش می‌دهد (یا وقتی مخزن نصبی ندارد، نصب مالک را) و یک توکن نصبِ تک‌مخزنی صادر کند، و هر بار فقط پس از آنکه ورود خودِ شخصی که درخواست داده دسترسی به آن مخزن را ثابت کرده باشد.

هر سروری که به Connect شما وصل است، ربات App را با بقیه به اشتراک می‌گذارد. آن ربات می‌تواند برای هرکدام بخواند، نظر بگذارد، برچسب بزند و واکنش نشان دهد. بازبینی PRها به‌عنوان ربات فقط برای سرورهایی مجاز است که در CONNECT_GITHUB_REVIEW_BOT_INSTALLS فهرست کرده‌اید (شناسه‌های نصبشان، با کاما جدا)؛ هر سرور دیگری بازبینی‌هایش را با توکن خود بازبین منتشر می‌کند. push هرگز به‌عنوان ربات انجام نمی‌شود. برای اینکه سرور خودتان به‌عنوان ربات بازبینی کند، شناسهٔ نصبش را آن‌جا اضافه کنید و دوباره راه‌اندازی کنید. فایل کلید را مانند کلید مهر یک راز نگه دارید. Linear هم به رازی نیاز ندارد: Connect کد را به سرور برمی‌گرداند و سرور تبادل را خودش کامل می‌کند.

گام ۳: شناسه‌های نصب را جمع کنید

بخش با عنوان “گام ۳: شناسه‌های نصب را جمع کنید”

Connect فقط به سرورهایی پاسخ می‌دهد که در فهرست مجازش هستند. روی هر سرور، آن را به Connect خودتان متصل کنید و سپس شناسهٔ نصبش را بخوانید:

۱. به تنظیمات ← سرور ← ورود یکپارچه بروید، کارت Control Center Connect را باز کنید و استفاده از سرور Connect سفارشی را انتخاب کنید ۲. نشانی خود را وارد و ذخیره کنید. کارت Install id سرور را نشان می‌دهد

از ترمینال روی میزبان سرور، همین کار این‌گونه انجام می‌شود:

پنجرهٔ ترمینال
cc_server connect enable --url https://connect.example.com
cc_server connect status

status شناسهٔ نصب را چاپ می‌کند. تا وقتی گام ۵ انجام نشده باشد install_blocked نشان می‌دهد، که طبیعی است.

شناسهٔ نصب بر اساس نشانی هر Connect مشتق می‌شود، پس همان سرور برای هر Connect که با آن صحبت می‌کند شناسهٔ متفاوتی دارد. این شناسه فقط وقتی تغییر می‌کند که مالکش کلید را عوض کند.

Connect هر اعتبارنامه‌ای را که برمی‌گرداند با یک کلید مهر (seal key) رمزنگاری می‌کند. یکی بسازید و آن را به‌عنوان یک فایل محرمانه نگه دارید:

پنجرهٔ ترمینال
docker run --rm ghcr.io/samuelalev/cc-connect:latest \
cc-connect-config seal-key > seal_keys
chmod 600 seal_keys

از دست رفتن کلید مهر همه را خارج می‌کند: بدون آن هیچ مهری باز نمی‌شود.

گام ۵: کانتینر را راه‌اندازی کنید

بخش با عنوان “گام ۵: کانتینر را راه‌اندازی کنید”

هر نسخه، ghcr.io/samuelalev/cc-connect را همراه با سوابق ساخت (build provenance) منتشر می‌کند. در محیط عملیاتی، یک برچسب نسخهٔ مشخص را پین کنید.

پنجرهٔ ترمینال
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:latest

پروکسی معکوس خود را به پورت 8790 وصل کنید، و CONNECT_TRUST_PROXY را برابر تعداد پروکسی‌های جلوی Connect تنظیم کنید تا محدودیت هر نشانی، نشانی هر کارخواه را ببیند. ایمیج با کاربری بدون دسترسی ویژه اجرا می‌شود، وضعیتش را در volume مربوط به /data نگه می‌دارد و بررسی سلامت داخلی دارد (cc-connect --healthcheck، که /healthz را می‌سنجد: فرایند پاسخ می‌دهد). /readyz هم بررسی می‌کند که انبارهای وضعیت و اتصال‌هایش پاسخ می‌دهند و، اگر Redis استفاده می‌شود، هنوز maxmemory-policy noeviction را اجرا می‌کند؛ بررسی آمادگی یک ارکستراتور را روی آن نقطه بگذارید.

صفحهٔ رضایت ورود با یک form post پاسخ می‌دهد که Connect فقط از خود صفحه‌اش می‌پذیرد: Sec-Fetch-Site، وقتی فرستاده شود، باید same-origin باشد، و Origin، وقتی فرستاده شود، باید مبدأ CONNECT_PUBLIC_URL باشد؛ پستی که هیچ‌کدام را نداشته باشد رد می‌شود. پس پروکسی باید هر دو سرایند را دست‌نخورده عبور دهد، و CONNECT_PUBLIC_URL باید همان نشانی‌ای باشد که مرورگر مردم واقعاً به کار می‌برد. اگر ادامه دادن در آن صفحه همیشه «این پیوند منقضی شده است» را نشان می‌دهد و گزارش oauth.done_refused را با دلیل origin یا no_origin ثبت می‌کند، یکی از آن دو نادرست است.

Connect وقتی پیکربندی‌اش باز، ناامن یا نیمه‌کاره باشد از راه‌اندازی خودداری می‌کند (کد خروج 78) و متغیر اشتباه را چاپ می‌کند. فهرست مجاز خالی، نشانی http غیر از loopback، کلید مهر نامعتبر، یا تنظیم هم‌زمان NAME و NAME_FILE هر کدام آن را متوقف می‌کند.

نقطهٔ بازبینی: روی هر سرور، کارت Connect مقدار Working را نشان می‌دهد و Where each sign-in runs برای هر ارائه‌دهندهٔ ثبت‌شده، Connect را نام می‌برد. cc_server connect status خط Health: ok و همان مسیرها را چاپ می‌کند.

یک سرور می‌تواند به جای کانتینر جدا، خودش Connect را میزبانی کند. سرویس سوارشده همان سرویسی است که ایمیج اجرا می‌کند.

۱. متغیرهای CONNECT_* را در فایل .env سرور بگذارید، مانند گام ۵. سرور وقتی یک راز Connect، از جمله CONNECT_SENTRY_DSN، در محیطش صادر شده باشد راه‌اندازی نمی‌شود ۲. CC_SERVER_CONNECT_HOST=on را اضافه کنید ۳. سرور را دوباره راه‌اندازی کنید. گزارش آن embedded Connect at <url> را چاپ می‌کند

پنجرهٔ ترمینال
CC_SERVER_CONNECT_HOST=on
CONNECT_ALLOWED_INSTALLS=<install id>
CONNECT_SEAL_KEYS=<output of cc-connect-config seal-key>
CONNECT_GITHUB_APP_ID=123456
CONNECT_GITHUB_APP_SLUG=acme-control-center
CONNECT_GITHUB_CLIENT_ID=Iv23li0123456789abcd
CONNECT_GITHUB_CLIENT_SECRET=<secret>
CONNECT_GITHUB_APP_PRIVATE_KEY_FILE=/etc/cc/github_app_key.pem

Connect آنگاه در <server>/connect سرویس داده می‌شود:

  • CONNECT_PUBLIC_URL به‌طور پیش‌فرض مبدأ نشانی عمومی سرور به‌علاوهٔ /connect است. پشت پروکسی آن را صریح تنظیم کنید. مسیر باید دقیقاً /connect باشد و اگر loopback نباشد باید HTTPS باشد
  • فقط متغیرهای CONNECT_* به سرویس سوارشده می‌رسند، بنابراین هرگز برنامه‌های ارائه‌دهندهٔ خود سرور را قرض نمی‌گیرد
  • CONNECT_ALLOWED_INSTALLS همچنان لازم است، حتی برای خود سرور میزبان
  • یک سوار کردن نادرست، راه‌اندازی سرور را متوقف می‌کند، به‌جای آنکه یک واسطهٔ باز ارائه دهد
  • سرور دمو هرگز آن را سوار نمی‌کند

ریدایرکت‌های ارائه‌دهنده را مقابل https://<server>/connect ثبت کنید، و سپس سرورها (از جمله میزبان) را مانند گام ۳ به همین نشانی وصل کنید.

هر تنظیم یک متغیر محیطی است. هر رازی می‌تواند از یک فایل سوارشده بیاید: به‌جای NAME، NAME_FILE را تنظیم کنید. Connect فایل را حداکثر هر ۳۰ ثانیه دوباره می‌خواند و آخرین مقدار معتبر را نگه می‌دارد. رازهایی که با dual مشخص شده‌اند، در زمان چرخش، NAME_PREVIOUS (یا NAME_PREVIOUS_FILE) را هم می‌پذیرند.

متغیر پیش‌فرض معنی
CONNECT_PUBLIC_URL الزامی نشانی عمومی متعارف. HTTPS، یا http فقط روی loopback. مسیر به معنای سوار شدن است. بدون query یا fragment
CONNECT_ALLOWED_INSTALLS الزامی شناسه‌های نصب جداشده با کاما. * فقط همراه با CONNECT_SIGNED_CONFIG_FILE پذیرفته می‌شود
CONNECT_DENY_INSTALLS شناسه‌های نصبی که حتی وقتی مجاز باشند، رد می‌شوند
CONNECT_GITHUB_ALLOWED_OWNERS شناسه‌های عددی مالک GitHub. وقتی تنظیم شود، توکن مخزن فقط برای مخزن‌هایی صادر می‌شود که آن مالک‌ها دارند. این مقدار محدود نمی‌کند چه کسی وارد می‌شود: فردی که اجازهٔ استفاده از این Connect را دارد همچنان توکن کاربری App خودش را دریافت می‌کند. برای سرویس‌دهی فقط به یک سازمان، App را خصوصی همان سازمان نگه دارید
CONNECT_GITHUB_REVIEW_BOT_INSTALLS شناسه‌های نصبی که ممکن است ربات App درخواست‌های pull را بازبینی کند. پیش‌فرض خالی؛ * رد می‌شود و هر شناسه باید مجاز هم باشد
CONNECT_HOST، CONNECT_PORT 0.0.0.0، 8790 نشانی و پورت bind
CONNECT_TRUST_PROXY 0 تعداد گام‌های پروکسی قابل‌اعتماد در X-Forwarded-For (۰ تا ۸). فقط برای محدودیت‌های به‌ازای هر نشانی، نشانی‌ای که صفحهٔ ورود نشان می‌دهد، و نشانی ثبت‌شده به کار می‌رود. پشت یک پروکسی، 0 هر کارخواه را همان پروکسی حساب می‌کند و گزارش این را یک بار می‌گوید
متغیر پیش‌فرض معنی
CONNECT_GITHUB_APP_ID، CONNECT_GITHUB_APP_SLUG، CONNECT_GITHUB_CLIENT_ID GitHub App
CONNECT_GITHUB_CLIENT_SECRET راز، dual
CONNECT_GITHUB_APP_PRIVATE_KEY راز. کلید خصوصی App (PEM)
CONNECT_GOOGLE_CLIENT_ID، CONNECT_GOOGLE_CLIENT_SECRET کلاینت Google. راز dual است
CONNECT_LINEAR_CLIENT_ID برنامهٔ Linear. بدون راز
CONNECT_SLACK_APP_ID، CONNECT_SLACK_CLIENT_ID برنامهٔ Slack
CONNECT_SLACK_CLIENT_SECRET، CONNECT_SLACK_SIGNING_SECRET رازها، dual
CONNECT_KLIPY_APP_KEY کلید جست‌وجوی GIF در Klipy. راز، dual
CONNECT_KLIPY_MODE proxy proxy کلید را در Connect نگه می‌دارد؛ key آن را به سرورها می‌دهد
CONNECT_<LANE>_SECRET_GENERATION 1 GitHub، Google و Slack: نسلی که در مهرهای جدید ثبت می‌شود
CONNECT_<LANE>_MIN_SEAL_GENERATION 1 GitHub، Google و Slack: مهرهای قدیمی‌تر باید دوباره وارد شوند
CONNECT_<LANE>_ACCEPTS_NEW true همهٔ مسیرها: false ورودهای جدید را متوقف می‌کند، در حالی که ورودهای موجود همچنان تازه می‌شوند
متغیر پیش‌فرض معنی
CONNECT_SEAL_BACKEND local local یا gcp-kms
CONNECT_SEAL_KEYS راز، برای local لازم است. ورودی‌های kid:key جداشده با کاما، جدیدترین اول؛ ورودی‌های قدیمی‌تر همچنان رمزگشایی می‌شوند
CONNECT_KMS_KEY projects/…/locations/…/keyRings/…/cryptoKeys/…، برای gcp-kms لازم است
CONNECT_STATE memory memory برای یک نمونه، redis برای چند نمونه. یک انبار پر در حافظه، ورودها و درخواست‌های تازه را رد می‌کند تا یک ورودی زنده را فراموش نکند
CONNECT_REDIS_URL راز. redis:// یا rediss://. Redis نسخهٔ ۶٫۲ یا جدیدتر با maxmemory-policy noeviction، که هر دو هنگام راه‌اندازی بررسی می‌شوند
CONNECT_REDIS_CA_FILE بستهٔ CA برای rediss://
CONNECT_BINDINGS file محل نگهداری اتصال‌های تیم Slack: file یا firestore
CONNECT_DATA_DIR data (در ایمیج /data) شامل bindings.json. توسط یک Connect قفل می‌شود: دومی روی همان پوشه راه نمی‌افتد
CONNECT_FIRESTORE_PROJECT، CONNECT_FIRESTORE_DATABASE پایگاه‌داده (default) برای CONNECT_BINDINGS=firestore. وقتی Firestore پاسخ نمی‌دهد Connect راه نمی‌افتد

پیکربندی، گزارش‌ها و محدودیت‌ها

بخش با عنوان “پیکربندی، گزارش‌ها و محدودیت‌ها”
متغیر پیش‌فرض معنی
CONNECT_SIGNED_CONFIG_FILE پیکربندی امضاشدهٔ آفلاین که همان‌طور که هست ارائه می‌شود. Connect میزبانی‌شدهٔ Control Center از آن استفاده می‌کند
CONNECT_CONFIG_PUBLIC_KEYS کلیدهایی که پیکربندی امضاشده باید با آنها تأیید شود
CONNECT_CONFIG_EPOCH 1 epoch پیکربندی‌ای که یک Connect خودمیزبان تولید می‌کند
CONNECT_LOG_HMAC_KEY تصادفی برای هر فرایند راز. آن را تنظیم کنید تا برچسب‌هایی که جایگزین شناسه‌های نصب می‌شوند بین راه‌اندازی‌های مجدد و نمونه‌ها پایدار بمانند
CONNECT_SENTRY_DSN راز. یک DSN از نوع https برای Sentry که خطاها به آن گزارش می‌شوند: نوع خطا، فریم‌های پشته، مسیر و شناسهٔ درخواست، هرگز پیام، بدنه یا سرایند
CONNECT_SENTRY_ENVIRONMENT self-hosted محیط Sentry
CONNECT_VERSION، CONNECT_IMAGE_DIGEST توسط /v1/version گزارش می‌شود
CONNECT_RATE_INSTALL_PER_MINUTE 600 درخواست به‌ازای هر نصب
CONNECT_RATE_IP_PER_MINUTE 300 درخواست به‌ازای هر نشانی (یک نشانی IPv6 به‌ازای هر /64 شمرده می‌شود)
CONNECT_RATE_GLOBAL_PER_SECOND 500 درخواست برای کل نمونه
CONNECT_RATE_SLACK_HOOK_IP_PER_MINUTE 600 رویدادها و فرمان‌های Slack به‌ازای هر نشانی، جدا از سایر درخواست‌ها شمرده می‌شوند
CONNECT_RATE_SLACK_HOOK_GLOBAL_PER_SECOND 100 رویدادها و فرمان‌های Slack برای کل نمونه
CONNECT_RATE_SLACK_TEAM_PER_MINUTE 600 رویدادهای Slack به‌ازای هر تیم
CONNECT_RATE_KLIPY_PER_MINUTE 120 جست‌وجوی GIF به‌ازای هر نصب
CONNECT_RATE_KLIPY_IP_PER_MINUTE 240 جست‌وجوی GIF به‌ازای هر نشانی، بین همهٔ سرورها
CONNECT_RATE_LOGINS_IP_PER_10_MINUTES 60 ورودهای شروع‌شده به‌ازای هر نشانی
CONNECT_RATE_GITHUB_TOKENS_ACCOUNT_PER_HOUR 30 توکن‌های GitHub صادرشده به‌ازای هر حساب GitHub روی یک سرور (ورودها، تازه‌سازی‌ها، توکن‌های مخزن)
CONNECT_RATE_GITHUB_TOKENS_ACCOUNT_CEILING_PER_HOUR ۴ × مقدار بالا (120) همان، به‌ازای هر حساب GitHub در همهٔ سرورها
CONNECT_RATE_GITHUB_TOKENS_IP_PER_HOUR 600 توکن‌های GitHub صادرشده به‌ازای هر نشانی
CONNECT_RATE_GITHUB_EXCHANGE_CEILING_PER_HOUR 500 ورودهای جدید GitHub برای کل برنامه
CONNECT_RATE_GITHUB_APP_MINTS_INSTALL_PER_HOUR 120 توکن‌های ربات به‌ازای هر سرور
CONNECT_RATE_GITHUB_APP_MINTS_ACCOUNT_PER_HOUR 240 توکن‌های ربات به‌ازای هر حساب GitHub درخواست‌کننده، بین سرورها
CONNECT_RATE_GITHUB_APP_CEILING_PER_HOUR 3000 توکن‌های ربات برای کل برنامه
CONNECT_RATE_GITHUB_TOKEN_CEILING_PER_HOUR 1500 تازه‌سازی‌ها و توکن‌های مخزن برای کل برنامه. ورودهای جدید محدودیت جداگانهٔ خود را دارند (بالاتر)
CONNECT_GITHUB_TOKEN_CAP_WARN 10 توکن‌های مخزن زندهٔ یک حساب GitHub، پیش از آنکه Connect هشدار ثبت کند
CONNECT_RATE_RETIRE_IP_PER_HOUR 10 شناسه‌های نصب بازنشسته‌شده به‌ازای هر نشانی (برای IPv6 به‌ازای هر /48)

یک فراخوانی پس از رسیدن به یک محدودیت با rate_limited پاسخ داده می‌شود. سرورها بعداً دوباره تلاش می‌کنند و هرگز کسی را به خاطر آن خارج نمی‌کنند.

یک نمونه با CONNECT_STATE=memory برای بیشتر سازمان‌ها کافی است. چند نمونه پشت یک نشانی واحد به CONNECT_STATE=redis و CONNECT_BINDINGS=firestore نیاز دارند، تا ورودی که روی یک نمونه شروع شده بتواند روی نمونهٔ دیگر تمام شود، و هر نمونه همان اتصال‌های Slack و همان شناسه‌های نصب بازنشسته‌شده را ببیند. یک CONNECT_DATA_DIR مشترک کار نمی‌کند: اولین Connect آن را قفل می‌کند. محدودیت‌های هر نصب، هر نشانی و کل نمونه، برای هر نمونه جداگانه‌اند؛ محدودیت‌های ورودها، توکن‌های GitHub، توکن‌های ربات، جست‌وجوهای GIF به‌ازای هر نشانی، بازنشستگی‌ها و تیم‌های Slack از طریق انبار وضعیت مشترک‌اند.

هیچ‌کس خارج نمی‌شود:

۱. راز جدید را نزد ارائه‌دهنده بسازید و راز قدیمی را نگه دارید ۲. مقدار قدیمی را به NAME_PREVIOUS منتقل کنید، مقدار جدید را در NAME بگذارید، و CONNECT_<LANE>_SECRET_GENERATION را بالا ببرید. فایل‌های سوارشده ظرف ۳۰ ثانیه برداشته می‌شوند ۳. صبر کنید تا ورودها تازه شوند، سپس راز قدیمی را نزد ارائه‌دهنده حذف کنید و NAME_PREVIOUS را بردارید

برای چرخاندن یک کلید مهر، ابتدا یک ورودی جدید cc-connect-config seal-key را در ابتدای CONNECT_SEAL_KEYS بگذارید و ورودی قدیمی را تا زمانی نگه دارید که مهرهای آن تازه شده باشند.

سرورها شناسه‌های برنامه و کلاینتی را که Connect شما بار اول که استفاده شد اعلام کرده، به یاد دارند. اگر برنامه‌ای را جایگزین کنید، روی کارت Connect هر سرور Connect’s apps changed ظاهر می‌شود و ورودها از طریق Connect متوقف می‌شوند تا مالکش Trust new apps را بزند. پیش از تغییر به مالکان سرور خبر دهید، تا بدانند این درخواست از طرف شماست.

شناسهٔ نصبش را به CONNECT_DENY_INSTALLS اضافه کنید و دوباره راه‌اندازی کنید. مالکش این پیام را می‌بیند: «Connect شناسهٔ نصب این سرور را مسدود کرده است. با گردانندهٔ سرور Connect خود تماس بگیرید.» و هر ورود از طریق Connect روی آن متوقف می‌شود.

سرور شناسهٔ نصب قدیمی خودش را هم وقتی مالکش کلید را می‌چرخاند بازنشسته می‌کند. آن شناسه را با یک مهر اعتبارنامه که این Connect برایش ساخته ثابت می‌کند، پس فقط سروری که کسی را وارد کرده باشد می‌تواند شناسه را بازنشسته کند. Connect شناسه‌های بازنشسته را برای همیشه نگه می‌دارد، پس کلید قدیمی و هر مهری که برایش ساخته شده از کار می‌افتد، و اتصال‌های تیم Slack که به شناسهٔ قدیمی بسته بودند آزاد می‌شوند. توکن‌هایی که پیش‌تر صادر شده‌اند خودشان منقضی می‌شوند: برای یک شخص ظرف ۸ ساعت، برای یک ربات ظرف ۱ ساعت. Connect حداکثر ۱۰۰٬۰۰۰ شناسهٔ بازنشسته نگه می‌دارد؛ پس از آن، چرخش رد می‌شود و گزارش آن را در سطح خطا ثبت می‌کند.

یک سرور می‌گوید Connect آن را مسدود کرده است

بخش با عنوان “یک سرور می‌گوید Connect آن را مسدود کرده است”

شناسهٔ نصبش در CONNECT_ALLOWED_INSTALLS نیست، در CONNECT_DENY_INSTALLS است، یا با چرخش یک کلید بازنشسته شده است. این شناسه وقتی مالکش کلید را عوض می‌کند تغییر می‌کند؛ شناسهٔ جدید را بخواهید.

همهٔ ورودها به یک ارائه‌دهنده شکست می‌خورند

بخش با عنوان “همهٔ ورودها به یک ارائه‌دهنده شکست می‌خورند”

یکی از متغیرهایش ممکن است گم شده باشد، پس Connect آن مسیر را کنار گذاشته است. گزارش راه‌اندازی و جدول‌های بالا را بررسی کنید. GitHub هر پنج مورد app id، slug، client id، client secret و private key را لازم دارد؛ Google هم client id و هم secret را لازم دارد.

ورودها با عدم تطابق بازگشت (redirect) شکست می‌خورند

بخش با عنوان “ورودها با عدم تطابق بازگشت (redirect) شکست می‌خورند”

بازگشتی که نزد ارائه‌دهنده ثبت شده، دقیقاً با CONNECT_PUBLIC_URL تطابق ندارد. طرح، میزبان، پورت و مسیر /connect را برای Connect سوارشده مقایسه کنید.

کلید مهر تغییر کرده یا از دست رفته، یک سرور کلیدش را چرخانده، یا داده‌های یک سرور روی دستگاه دیگری بازیابی شده است. یک اعتبارنامهٔ مهروموم‌شده فقط برای نصب و Connectی باز می‌شود که آن را ساخته‌اند.