مواد پر جائیں

Connect سرور چلائیں

Control Center Connect ان سرورز کے لیے provider sign-ins (GitHub، Google Calendar، Linear اور Slack) چلاتا ہے جنہوں نے اپنی apps رجسٹر نہیں کیں۔ یہ گائیڈ دکھاتی ہے کہ اپنا Connect کیسے چلائیں، تاکہ provider apps، ان کے secrets، اور ان سرورز کی فہرست جنہیں ان کے استعمال کی اجازت ہے، سب آپ کے پاس رہیں۔

Connect کیا دیکھ سکتا ہے اور کیا نہیں، یہ Connect reference میں ہے۔ اگر آپ فیصلہ کر رہے ہیں کہ Connect چلانا ہے یا نہیں، تو پہلے اسے پڑھیں۔

  • Connect کے لیے ایک عوامی HTTPS پتہ، جیسے https://connect.example.com، جو TLS ختم کرنے والے proxy کے پیچھے ہو۔ سادہ http صرف loopback پر قبول ہوتا ہے
  • Docker، یا ایک cc_server جسے آپ اضافی environment variables کے ساتھ دوبارہ شروع کر سکیں
  • ہر اس provider کے لیے apps رجسٹر کرنے کی اجازت جسے آپ سروس دینا چاہتے ہیں
  • وہ سرورز جو اسے استعمال کریں گے، ان کے owners دستیاب ہوں: ہر سرور کا ایک install id ہوتا ہے جسے آپ Connect کی allowlist میں شامل کرتے ہیں

ابھی پتہ چنیں اور اسے محفوظ رکھیں۔ CONNECT_PUBLIC_URL Connect کے ہر کام میں شامل ہے: request signatures، sealed credentials، provider redirect URLs، اور ہر سرور کا install id، یہ سب اسی سے منسلک ہیں۔ بعد میں اسے تبدیل کرنے کا مطلب ہے redirects دوبارہ رجسٹر کرنا اور ہر شخص کو دوبارہ sign in کرانا۔

صرف وہی providers رجسٹر کریں جنہیں آپ سروس دینا چاہتے ہیں۔ جس provider کے variables نامکمل ہوں وہ Connect کی configuration سے نکال دیا جاتا ہے، اور سرورز اسے unavailable دیکھتے ہیں۔ نیچے <base> سے مراد آپ کا CONNECT_PUBLIC_URL ہے۔

Provider رجسٹریشن محفوظ رکھیں
GitHub App Callback URL ‏<base>/oauth/github/callback۔ Setup URL ‏<base>/oauth/github/setup کے ساتھ Redirect on update فعال۔ Request user authorization (OAuth) during installation غیر فعال رکھیں: فعال ہونے پر GitHub setup URL کو نظرانداز کرتا ہے۔ Expire user authorization tokens فعال رکھیں App id، slug، client id، client secret، private key
Google redirect URI ‏<base>/oauth/google/callback کے ساتھ Web application قسم کا OAuth client، اور Google Calendar API فعال Client id، client secret
Linear callback URLs ‏<base>/oauth/linear/callback اور <base>/oauth/linear_app/callback کے ساتھ OAuth application صرف 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 کو یہ repository permissions دیں: Metadata read، Contents read اور write، Pull requests read اور write، Issues read اور write، اور Checks، Actions اور Commit statuses read۔ team review requests کے لیے organization Members read شامل کریں۔ Webhooks بند رہ سکتے ہیں: سرورز polling کرتے ہیں۔

Connect کو GitHub App کی private key کی ضرورت ہے (App کی settings میں Generate a private key)۔ یہ App کی درخواستوں پر دستخط کرتا ہے جو اُس انسٹالیشن کو تلاش کرتی ہیں جو کسی repository کو کور کرتی ہے (یا، جب repository کی کوئی انسٹالیشن نہ ہو، تو owner کی انسٹالیشن)، اور ایک repository تک محدود installation token جاری کرتا ہے، ہر بار تبھی جب مانگنے والے شخص کے اپنے sign-in نے اس repository تک رسائی ثابت کی ہو۔

ہر وہ سرور جو آپ کے Connect پر ہے App کا bot شیئر کرتا ہے۔ وہ ان میں سے کسی کے لیے بھی bot کے طور پر پڑھ، تبصرہ، لیبل اور ری ایکشن کر سکتا ہے۔ bot کے طور پر pull requests کا ریویو صرف اُن سرورز کے لیے اجازت ہے جنہیں آپ CONNECT_GITHUB_REVIEW_BOT_INSTALLS میں درج کریں (ان کے install ids، کاما سے جدا)؛ باقی ہر سرور ریویو اپنے ہی ریویور کے ٹوکن سے شائع کرتا ہے۔ پش کبھی bot کے طور پر نہیں کیا جاتا۔ اپنے کسی سرور کو bot کے طور پر ریویو کرنے دینے کے لیے اس کا install id وہاں شامل کریں اور دوبارہ شروع کریں۔ key فائل کو seal key کی طرح secret رکھیں۔ Linear کو کوئی secret نہیں چاہیے: Connect code سرور کو واپس دیتا ہے، اور سرور خود exchange مکمل کرتا ہے۔

Connect صرف ان سرورز کو جواب دیتا ہے جو اس کی allowlist پر ہوں۔ ہر سرور پر، اسے اپنے Connect کی طرف اشارہ کریں، پھر اس کا install id پڑھیں:

  1. ترتیبات → سرور → سنگل سائن آن پر جائیں، Control Center Connect کارڈ کھولیں، اور اپنا Connect سرور استعمال کریں منتخب کریں
  2. اپنا URL درج کریں اور save کریں۔ کارڈ سرور کا انسٹال آئی ڈی دکھاتا ہے

سرور کے host پر terminal سے وہی کام یوں ہوتا ہے:

ٹرمنل ونڈو
cc_server connect enable --url https://connect.example.com
cc_server connect status

status install id پرنٹ کرتا ہے۔ یہ install_blocked دکھاتا ہے جب تک مرحلہ 5 مکمل نہ ہو، اور یہ متوقع ہے۔

install id ہر Connect کے پتے کے لحاظ سے اخذ ہوتا ہے، اس لیے ایک ہی سرور کا ہر اس Connect کے لیے مختلف id ہوتا ہے جس سے وہ بات کرتا ہے۔ یہ صرف اس وقت بدلتا ہے جب اس کا owner key rotate کرے۔

Connect ہر credential جو وہ واپس دیتا ہے اسے seal key سے encrypt کرتا ہے۔ ایک بنائیں اور اسے secret file کے طور پر محفوظ رکھیں:

ٹرمنل ونڈو
docker run --rm ghcr.io/samuelalev/cc-connect:latest \
cc-connect-config seal-key > seal_keys
chmod 600 seal_keys

seal key کھو دینے کا مطلب ہے سب کو sign out کرنا: اس کے بغیر کوئی seal نہیں کھولا جا سکتا۔

ہر release ghcr.io/samuelalev/cc-connect کو build provenance کے ساتھ شائع کرتا ہے۔ production میں ایک version tag pin کریں۔

ٹرمنل ونڈو
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

اپنا reverse proxy port 8790 کی طرف اشارہ کریں، اور CONNECT_TRUST_PROXY کو اُن proxies کی تعداد پر سیٹ کریں جو Connect کے سامنے ہیں، تاکہ اس کی فی پتہ حد ہر کلائنٹ کا پتہ دیکھے۔ image ایک غیر مراعات یافتہ user کے طور پر چلتی ہے، اپنی state /data volume میں رکھتی ہے، اور اس میں built-in health check ہے (cc-connect --healthcheck، جو /healthz کو probe کرتا ہے: process جواب دیتا ہے)۔ /readyz یہ بھی جانچتا ہے کہ اس کے state اور binding stores جواب دیتے ہیں، اور یہ کہ Redis، جب استعمال ہو، اب بھی maxmemory-policy noeviction پر چل رہا ہے؛ کسی orchestrator کی readiness جانچ وہیں کریں۔

sign-in consent page ایک form post کے ساتھ جواب دیتا ہے جسے Connect صرف اپنے ہی page سے قبول کرتا ہے: Sec-Fetch-Site، جب بھیجا جائے، تو same-origin ہونا چاہیے، اور Origin، جب بھیجا جائے، تو CONNECT_PUBLIC_URL کا origin ہونا چاہیے؛ جو post دونوں میں سے کسی کے بغیر ہو وہ مسترد ہوتی ہے۔ اس لیے proxy کو دونوں headers بغیر تبدیلی کے گزارنے ہوں گے، اور CONNECT_PUBLIC_URL وہ پتہ ہونا چاہیے جو لوگوں کے براؤزر واقعی استعمال کرتے ہیں۔ اگر اس page پر جاری رکھنے سے ہمیشہ “یہ لنک ختم ہو چکا ہے” دکھے، اور log میں oauth.done_refused کے ساتھ reason origin یا no_origin ہو، تو ان دونوں میں سے ایک غلط ہے۔

Connect شروع ہونے سے انکار کرتا ہے (exit code 78) جب اس کی configuration کھلی، غیر محفوظ یا نامکمل ہو، اور بتاتا ہے کہ کون سا variable غلط ہے۔ allowlist کا نہ ہونا، loopback کے علاوہ http پتہ، غلط seal key، یا NAME اور NAME_FILE دونوں کا مقرر ہونا، یہ سب اسے روک دیتے ہیں۔

Checkpoint: ہر سرور پر Connect کارڈ کام کر رہا ہے پڑھتا ہے، اور ہر سائن اِن کہاں چلتا ہے ہر اس provider کے لیے منسلک ہوں دکھاتا ہے جو آپ نے رجسٹر کیا۔ cc_server connect status ایک Health: ok اور وہی lanes پرنٹ کرتا ہے۔

سرور الگ container کے بجائے خود Connect میزبانی کر سکتا ہے۔ mount کی گئی سروس وہی ہے جو image چلاتی ہے۔

  1. CONNECT_* variables سرور کی .env فائل میں رکھیں، جیسا کہ مرحلہ 5 میں ہے۔ جب کوئی Connect secret، بشمول CONNECT_SENTRY_DSN، سرور کے environment میں export ہو تو سرور شروع ہونے سے انکار کرتا ہے
  2. CC_SERVER_CONNECT_HOST=on شامل کریں
  3. سرور دوبارہ شروع کریں۔ اس کا log 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 پیشگی طور پر سرور کے عوامی URL کا origin plus /connect ہوتا ہے۔ proxy کے پیچھے اسے واضح طور پر سیٹ کریں۔ راستہ بالکل /connect ہونا چاہیے، اور loopback نہ ہو تو HTTPS ہونا لازمی ہے
  • صرف CONNECT_* variables mount کی گئی سروس تک پہنچتے ہیں، اس لیے یہ کبھی سرور کی اپنی provider apps استعمال نہیں کرتی
  • CONNECT_ALLOWED_INSTALLS پھر بھی لازمی ہے، میزبان سرور کے لیے بھی
  • غلط mount سرور کو boot ہونے سے روک دیتا ہے، کھلا broker پیش کرنے کے بجائے
  • demo سرور اسے کبھی mount نہیں کرتا

provider redirects کو https://<server>/connect کے خلاف رجسٹر کریں، پھر سرورز (میزبان سمیت) کو مرحلہ 3 کی طرح اسی URL کی طرف اشارہ کریں۔

ہر setting ایک environment variable ہے۔ کوئی بھی secret ایک mount کی ہوئی فائل سے آ سکتا ہے: NAME کے بجائے NAME_FILE مقرر کریں۔ Connect فائل کو زیادہ سے زیادہ ہر 30 سیکنڈ بعد دوبارہ پڑھتا ہے اور آخری درست قدر رکھتا ہے۔ dual نشان والے secrets rotation کے دوران NAME_PREVIOUS (یا NAME_PREVIOUS_FILE) بھی قبول کرتے ہیں۔

Variable Default مطلب
CONNECT_PUBLIC_URL لازمی معیاری عوامی URL۔ HTTPS، یا loopback پر http۔ راستہ mount کی نشاندہی کرتا ہے۔ کوئی query یا fragment نہیں
CONNECT_ALLOWED_INSTALLS لازمی کاما سے جدا install ids۔ * صرف CONNECT_SIGNED_CONFIG_FILE کے ساتھ قبول ہے
CONNECT_DENY_INSTALLS وہ install ids جو اجازت ہونے کے باوجود مسترد ہوں
CONNECT_GITHUB_ALLOWED_OWNERS عددی GitHub owner ids۔ مقرر ہونے پر repository tokens صرف انہی owners کی repositories کے لیے جاری ہوتے ہیں۔ یہ کسی کے sign in کو محدود نہیں کرتا: اس Connect کے استعمال کی اجازت والا شخص پھر بھی اپنا App user token وصول کرتا ہے۔ صرف ایک organization کی خدمت کے لیے، App کو اسی تک نجی رکھیں
CONNECT_GITHUB_REVIEW_BOT_INSTALLS وہ install ids جو App کے bot سے pull requests کا ریویو کر سکتے ہیں۔ ڈیفالٹ میں خالی؛ * مسترد ہے، اور ہر id کو اجازت یافتہ بھی ہونا چاہیے
CONNECT_HOST، CONNECT_PORT 0.0.0.0، 8790 bind پتہ اور port
CONNECT_TRUST_PROXY 0 X-Forwarded-For میں قابلِ اعتماد proxy hops (0 تا 8)۔ صرف فی پتہ حدوں، sign-in page کے نیٹ ورک اشارے اور لاگ شدہ پتے کے لیے استعمال ہوتا ہے۔ proxy کے پیچھے 0 ہر کلائنٹ کو proxy شمار کرتا ہے، اور log ایک بار یہ بتاتا ہے
Variable Default مطلب
CONNECT_GITHUB_APP_ID، CONNECT_GITHUB_APP_SLUG، CONNECT_GITHUB_CLIENT_ID GitHub App
CONNECT_GITHUB_CLIENT_SECRET secret، dual
CONNECT_GITHUB_APP_PRIVATE_KEY Secret۔ App کی private key (PEM)
CONNECT_GOOGLE_CLIENT_ID، CONNECT_GOOGLE_CLIENT_SECRET Google client۔ secret dual ہے
CONNECT_LINEAR_CLIENT_ID Linear application۔ کوئی secret نہیں
CONNECT_SLACK_APP_ID، CONNECT_SLACK_CLIENT_ID Slack app
CONNECT_SLACK_CLIENT_SECRET، CONNECT_SLACK_SIGNING_SECRET secrets، dual
CONNECT_KLIPY_APP_KEY Klipy GIF search key۔ secret، dual
CONNECT_KLIPY_MODE proxy proxy key کو Connect میں رکھتا ہے؛ key اسے سرورز کو دیتا ہے
CONNECT_<LANE>_SECRET_GENERATION 1 GitHub، Google اور Slack: وہ generation جو نئی seals میں درج ہوتی ہے
CONNECT_<LANE>_MIN_SEAL_GENERATION 1 GitHub، Google اور Slack: پرانی seals کو دوبارہ sign in کرنا ہوگا
CONNECT_<LANE>_ACCEPTS_NEW true ہر lane: false نئے sign-ins روک دیتا ہے جبکہ موجودہ refresh ہوتے رہتے ہیں
Variable Default مطلب
CONNECT_SEAL_BACKEND local local یا gcp-kms
CONNECT_SEAL_KEYS secret، local کے لیے لازمی۔ کاما سے جدا kid:key entries، نئی سب سے پہلے؛ پرانی entries اب بھی decrypt ہوتی ہیں
CONNECT_KMS_KEY projects/…/locations/…/keyRings/…/cryptoKeys/…، gcp-kms کے لیے لازمی
CONNECT_STATE memory ایک instance کے لیے memory، کئی کے لیے redis۔ ایک پُر memory store نئے sign-ins اور درخواستوں کو مسترد کرتا ہے، بجائے اس کے کہ کوئی زندہ entry بھول جائے
CONNECT_REDIS_URL secret۔ redis:// یا rediss://۔ Redis 6.2 یا بعد کا، maxmemory-policy noeviction کے ساتھ، دونوں startup پر جانچے جاتے ہیں
CONNECT_REDIS_CA_FILE rediss:// کے لیے CA bundle
CONNECT_BINDINGS file Slack team bindings کہاں رہتے ہیں: file یا firestore
CONNECT_DATA_DIR data (image میں /data) bindings.json رکھتا ہے۔ ایک Connect اسے لاک کرتا ہے: اسی directory پر دوسرا Connect شروع نہیں ہوتا
CONNECT_FIRESTORE_PROJECT، CONNECT_FIRESTORE_DATABASE (default) database CONNECT_BINDINGS=firestore کے لیے۔ جب Firestore جواب نہ دے تو Connect شروع نہیں ہوتا
Variable Default مطلب
CONNECT_SIGNED_CONFIG_FILE offline-signed configuration، جیسی ہے ویسی پیش کی جاتی ہے۔ Control Center کا hosted Connect اسے استعمال کرتا ہے
CONNECT_CONFIG_PUBLIC_KEYS وہ keys جن کے خلاف signed configuration verify ہو
CONNECT_CONFIG_EPOCH 1 وہ epoch جو ایک self-hosted Connect کی configuration تیار کرتا ہے
CONNECT_LOG_HMAC_KEY ہر process کے لیے random secret۔ اسے سیٹ کریں تاکہ install ids کی جگہ استعمال ہونے والے tags restarts اور instances کے درمیان مستحکم رہیں
CONNECT_SENTRY_DSN secret۔ ایک https Sentry DSN جس پر error lines رپورٹ ہوتی ہیں: error type، stack frames، route اور request id، کبھی message، body یا header نہیں
CONNECT_SENTRY_ENVIRONMENT self-hosted Sentry environment
CONNECT_VERSION، CONNECT_IMAGE_DIGEST /v1/version کے ذریعے رپورٹ ہوتے ہیں
CONNECT_RATE_INSTALL_PER_MINUTE 600 فی install درخواستیں
CONNECT_RATE_IP_PER_MINUTE 300 فی پتہ درخواستیں (IPv6 پتہ فی /64 شمار ہوتا ہے)
CONNECT_RATE_GLOBAL_PER_SECOND 500 پورے instance کے لیے درخواستیں
CONNECT_RATE_SLACK_HOOK_IP_PER_MINUTE 600 فی پتہ Slack event اور command deliveries، باقی درخواستوں سے الگ شمار ہوتی ہیں
CONNECT_RATE_SLACK_HOOK_GLOBAL_PER_SECOND 100 پورے instance کے لیے Slack event اور command deliveries
CONNECT_RATE_SLACK_TEAM_PER_MINUTE 600 فی team Slack events
CONNECT_RATE_KLIPY_PER_MINUTE 120 فی install GIF searches
CONNECT_RATE_KLIPY_IP_PER_MINUTE 240 فی پتہ GIF searches، تمام servers میں
CONNECT_RATE_LOGINS_IP_PER_10_MINUTES 60 فی پتہ شروع کیے گئے sign-ins
CONNECT_RATE_GITHUB_TOKENS_ACCOUNT_PER_HOUR 30 فی GitHub account، ایک server پر، جاری کیے گئے GitHub tokens (sign-ins، refreshes، repository tokens)
CONNECT_RATE_GITHUB_TOKENS_ACCOUNT_CEILING_PER_HOUR 4 × اوپر کی قدر (120) وہی، ہر GitHub account کے لیے تمام servers پر
CONNECT_RATE_GITHUB_TOKENS_IP_PER_HOUR 600 فی پتہ جاری کیے گئے GitHub tokens
CONNECT_RATE_GITHUB_EXCHANGE_CEILING_PER_HOUR 500 پوری ایپ کے لیے نئے GitHub sign-ins
CONNECT_RATE_GITHUB_APP_MINTS_INSTALL_PER_HOUR 120 فی server bot tokens
CONNECT_RATE_GITHUB_APP_MINTS_ACCOUNT_PER_HOUR 240 فی مانگنے والا GitHub account، تمام servers پر bot tokens
CONNECT_RATE_GITHUB_APP_CEILING_PER_HOUR 3000 پوری ایپ کے لیے bot tokens
CONNECT_RATE_GITHUB_TOKEN_CEILING_PER_HOUR 1500 پوری ایپ کے لیے refreshes اور repository tokens۔ نئے sign-ins کی اپنی حد اوپر ہے
CONNECT_GITHUB_TOKEN_CAP_WARN 10 live repository tokens جو ایک GitHub account رکھ سکتا ہے، اس سے پہلے کہ Connect warning لاگ کرے
CONNECT_RATE_RETIRE_IP_PER_HOUR 10 فی پتہ retire کیے گئے install ids (IPv6 کے لیے فی /48)

حد سے آگے کی کال rate_limited کا جواب پاتی ہے۔ سرورز بعد میں دوبارہ کوشش کرتے ہیں اور اس کی وجہ سے کسی کو کبھی sign out نہیں کرتے۔

زیادہ تر تنظیموں کے لیے CONNECT_STATE=memory کے ساتھ ایک instance کافی ہے۔ ایک پتے کے پیچھے کئی instances کو CONNECT_STATE=redis اور CONNECT_BINDINGS=firestore چاہیے، تاکہ ایک instance پر شروع ہونے والا sign-in دوسری پر مکمل ہو سکے اور ہر instance ایک ہی Slack bindings اور retire شدہ install ids دیکھے۔ مشترکہ CONNECT_DATA_DIR کام نہیں کرتا: پہلا Connect اسے لاک کر دیتا ہے۔ فی install، فی پتہ اور پورے instance کی درخواست کی حدیں ہر instance کے لیے الگ ہیں؛ sign-ins، GitHub tokens، bot tokens، فی پتہ GIF searches، retirements اور Slack teams کی حدیں state store کے ذریعے مشترک ہیں۔

کسی کو sign out نہیں ہوتا:

  1. provider کے پاس نیا secret بنائیں اور پرانا رکھیں
  2. پرانی قدر NAME_PREVIOUS میں منتقل کریں، نئی NAME میں رکھیں، اور CONNECT_<LANE>_SECRET_GENERATION بڑھائیں۔ mount کی گئی فائلیں 30 سیکنڈ کے اندر اٹھا لی جاتی ہیں
  3. sign-ins کے refresh ہونے کا انتظار کریں، پھر provider پر پرانا secret حذف کریں اور NAME_PREVIOUS ہٹا دیں

seal key rotate کرنے کے لیے، پہلے CONNECT_SEAL_KEYS کے آغاز میں نیا cc-connect-config seal-key entry ڈالیں اور پرانا entry اس وقت تک رکھیں جب تک اس کی seals refresh نہ ہو جائیں۔

سرورز اپنے پہلے استعمال پر یاد رکھتے ہیں کہ آپ کے Connect نے کون سی app اور client ids کا اعلان کیا تھا۔ اگر آپ کوئی app بدلتے ہیں تو ہر سرور کے Connect کارڈ پر Connect کی ایپس بدل گئی ہیں ظاہر ہوتا ہے، اور Connect کے ذریعے sign-ins اس وقت تک رک جاتے ہیں جب تک اس کا owner نئی ایپس پر بھروسہ کریں نہ دبائے۔ تبدیلی سے پہلے سرور owners کو بتا دیں، تاکہ وہ جانیں کہ یہ prompt آپ کی طرف سے ہے۔

اس کا install id CONNECT_DENY_INSTALLS میں شامل کریں اور restart کریں۔ اس کا owner دیکھتا ہے “Connect نے اس سرور کی انسٹال آئی ڈی بلاک کر دی ہے۔ اپنے Connect سرور کے آپریٹر سے رابطہ کریں۔” اور اس پر ہر Connect sign-in رک جاتا ہے۔

سرور اپنا پرانا install id بھی خود retire کرتا ہے جب اس کا owner key rotate کرے۔ وہ ثابت کرتا ہے کہ id اس کا اپنا ہے، اُس ایک credential seal کے ذریعے جو اِس Connect نے اس کے لیے بنایا تھا، اس لیے صرف وہ سرور id retire کر سکتا ہے جس نے کسی کو sign in کرایا ہو۔ Connect retired ids کو ہمیشہ کے لیے رکھتا ہے، اس لیے پرانی key اور اس کے لیے بنائی گئی ہر seal کام کرنا بند کر دیتی ہے، اور پرانے id سے بندھی Slack workspaces آزاد ہو جاتی ہیں۔ جو tokens پہلے ہی جاری ہو چکے ہیں وہ خود بخود ختم ہو جاتے ہیں: کسی شخص کے tokens 8 گھنٹے کے اندر، bot کے tokens 1 گھنٹے کے اندر۔ Connect زیادہ سے زیادہ 100,000 retired ids رکھتا ہے؛ اس سے آگے rotation مسترد ہوتی ہے اور log error کی سطح پر یہ بتاتا ہے۔

ایک سرور کہتا ہے Connect نے اسے block کیا ہے

سیکشن کا عنوان “ایک سرور کہتا ہے Connect نے اسے block کیا ہے”

اس کا install id CONNECT_ALLOWED_INSTALLS میں نہیں ہے، CONNECT_DENY_INSTALLS میں ہے، یا key rotation سے retire ہو چکا ہے۔ id اس وقت بدلتا ہے جب اس کا owner key rotate کرے؛ نیا id مانگیں۔

اس کا ایک variable غائب ہو سکتا ہے، اس لیے Connect نے وہ lane نکال دی۔ startup log اور اوپر کی tables دیکھیں۔ GitHub کو پانچوں درکار ہیں: app id، slug، client id، client secret اور private key؛ Google کو client id اور secret دونوں چاہئیں۔

provider کے پاس رجسٹر کیا گیا redirect CONNECT_PUBLIC_URL سے بالکل مطابقت نہیں رکھتا۔ mount شدہ Connect کے لیے scheme، host، port اور /connect راستہ موازنہ کریں۔

seal key بدل گئی یا گم ہو گئی، کسی سرور نے اپنی key rotate کی، یا کسی سرور کا ڈیٹا کسی دوسری مشین پر بحال ہوا۔ ایک sealed credential صرف اسی install اور Connect کے لیے کھلتا ہے جنہوں نے اسے بنایا۔