Chạy máy chủ Connect
Control Center Connect chạy các đăng nhập nhà cung cấp (GitHub, Google Calendar, Linear, Slack) cho những máy chủ chưa đăng ký ứng dụng riêng. Hướng dẫn này chỉ cách chạy Connect của riêng bạn, để các ứng dụng nhà cung cấp, bí mật của chúng và danh sách máy chủ được phép dùng chúng đều nằm trong tay bạn.
Những gì Connect thấy và không thấy được mô tả trong tham chiếu Connect. Hãy đọc nó trước nếu bạn đang cân nhắc có nên chạy một Connect hay không.
Điều kiện tiên quyết
Phần tiêu đề “Điều kiện tiên quyết”- Một địa chỉ HTTPS công khai cho Connect, chẳng hạn
https://connect.example.com, đứng sau một proxy kết thúc TLS. HTTP thuần chỉ được chấp nhận trên loopback - Docker, hoặc một
cc_servermà bạn có thể khởi động lại với các biến môi trường bổ sung - Quyền đăng ký ứng dụng với từng nhà cung cấp bạn muốn phục vụ
- Các máy chủ sẽ dùng nó, cùng chủ của chúng ở bên cạnh: mỗi máy chủ có một id cài đặt mà bạn thêm vào danh sách cho phép của Connect
Bước 1: Chọn địa chỉ
Phần tiêu đề “Bước 1: Chọn địa chỉ”Chọn URL ngay bây giờ và giữ nguyên nó. CONNECT_PUBLIC_URL là phần của mọi việc Connect
làm: chữ ký yêu cầu, niêm phong thông tin xác thực, URL chuyển hướng của nhà cung cấp và id cài
đặt của mỗi máy chủ đều được ràng buộc với nó. Đổi nó về sau nghĩa là đăng ký lại các chuyển
hướng và mọi người đăng nhập lại.
Bước 2: Đăng ký ứng dụng nhà cung cấp
Phần tiêu đề “Bước 2: Đăng ký ứng dụng nhà cung cấp”Chỉ đăng ký những nhà cung cấp bạn muốn phục vụ. Một nhà cung cấp có biến số chưa đầy đủ sẽ
bị loại khỏi cấu hình của Connect, và các máy chủ thấy nó là không khả dụng. <base> bên dưới
là CONNECT_PUBLIC_URL của bạn.
| Nhà cung cấp | Đăng ký | Giữ lại |
|---|---|---|
| Ứng dụng GitHub | Callback URL <base>/oauth/github/callback. Setup URL <base>/oauth/github/setup với Redirect on update bật. Để Request user authorization (OAuth) during installation tắt: nếu bật, GitHub bỏ qua setup URL. Giữ Expire user authorization tokens bật |
App id, slug, client id, client secret, a private key |
Một OAuth client loại Web application với redirect URI <base>/oauth/google/callback, và Google Calendar API đã được bật |
Client id, client secret | |
| Linear | Một ứng dụng OAuth với callback URL <base>/oauth/linear/callback và <base>/oauth/linear_app/callback |
Chỉ client id |
| Slack | Redirect URL <base>/oauth/slack_oidc/callback và <base>/oauth/slack/callback. Event Subscriptions tại <base>/v1/hooks/slack/events (app_mention, message.*, assistant_thread_*, app_uninstalled, tokens_revoked). Slash command tại <base>/v1/hooks/slack/commands. Bật token rotation |
App id, client id, client secret, signing secret |
Hãy cấp cho GitHub App các quyền kho mã sau: Metadata chỉ đọc, Contents đọc và ghi, Pull requests đọc và ghi, Issues đọc và ghi, Checks, Actions và Commit statuses chỉ đọc. Thêm quyền tổ chức Members chỉ đọc cho các yêu cầu review của nhóm. Webhook có thể tắt: các máy chủ tự thăm dò.
Connect cần khóa riêng của GitHub App (Generate a private key trong cài đặt của App). Nó ký các yêu cầu của App để tìm cài đặt bao phủ một kho mã (hoặc, khi kho mã không có cài đặt nào, cài đặt của chủ sở hữu) và cấp một token cài đặt cho đúng một kho mã, mỗi lần chỉ sau khi đăng nhập của người yêu cầu đã chứng minh họ có quyền truy cập kho mã đó.
Mọi máy chủ trên Connect của bạn dùng chung bot của App. Nó có thể đọc, bình luận, gắn nhãn và thả cảm xúc với tư cách bot cho bất kỳ máy chủ nào trong số đó. Việc review pull request với tư cách bot chỉ được phép cho các máy chủ bạn liệt kê trong CONNECT_GITHUB_REVIEW_BOT_INSTALLS (id cài đặt của chúng, phân tách bằng dấu phẩy); mọi máy chủ khác đăng review bằng token của chính người review. Việc push không bao giờ được thực hiện với tư cách bot. Để cho phép một máy chủ của riêng bạn review với tư cách bot, hãy thêm id cài đặt của nó vào đó rồi khởi động lại. Giữ tệp khóa như một bí mật, giống khóa niêm phong. Linear không cần bí mật: Connect trả mã về cho máy chủ, và máy chủ tự hoàn tất trao đổi.
Bước 3: Thu thập id cài đặt
Phần tiêu đề “Bước 3: Thu thập id cài đặt”Connect chỉ trả lời các máy chủ trong danh sách cho phép của nó. Trên mỗi máy chủ, hãy trỏ nó tới Connect của bạn, rồi đọc id cài đặt của nó:
- Vào Cài đặt → Máy chủ → Đăng nhập một lần, mở thẻ Control Center Connect và chọn Dùng máy chủ Connect tùy chỉnh
- Nhập URL của bạn rồi lưu. Thẻ hiển thị Id cài đặt của máy chủ
Từ một terminal trên máy chủ, điều tương tự là:
cc_server connect enable --url https://connect.example.comcc_server connect statusstatus in ra id cài đặt. Nó hiển thị install_blocked cho đến khi Bước 5 hoàn tất, điều đó
là bình thường.
Id cài đặt được suy ra theo từng địa chỉ Connect, nên cùng một máy chủ có id khác nhau cho mỗi Connect mà nó nói chuyện. Nó chỉ đổi khi chủ máy chủ xoay khóa.
Bước 4: Tạo khóa niêm phong
Phần tiêu đề “Bước 4: Tạo khóa niêm phong”Connect mã hóa mọi thông tin xác thực mà nó trả về bằng một khóa niêm phong. Hãy tạo một khóa và giữ nó như một tệp bí mật:
docker run --rm ghcr.io/samuelalev/cc-connect:latest \ cc-connect-config seal-key > seal_keyschmod 600 seal_keysMất khóa niêm phong sẽ đăng xuất mọi người: không niêm phong nào có thể mở được nếu thiếu nó.
Bước 5: Khởi động container
Phần tiêu đề “Bước 5: Khởi động container”Mỗi bản phát hành công bố ghcr.io/samuelalev/cc-connect kèm chứng nhận nguồn gốc bản dựng.
Trong môi trường production, hãy ghim một thẻ phiên bản.
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:latestHãy trỏ reverse proxy của bạn tới cổng 8790, và đặt CONNECT_TRUST_PROXY thành số chặng proxy đứng trước Connect để giới hạn theo địa chỉ của nó thấy địa chỉ của từng client. Ảnh chạy với một người dùng không có đặc quyền, giữ trạng thái trong volume /data và có health check tích hợp (cc-connect --healthcheck, thăm dò /healthz: tiến trình có trả lời). /readyz còn kiểm tra rằng các kho trạng thái và ràng buộc của nó phản hồi, và rằng Redis, khi được dùng, vẫn chạy maxmemory-policy noeviction; hãy trỏ kiểm tra sẵn sàng của orchestrator tới đó.
Trang đồng ý đăng nhập trả về một form post mà Connect chỉ chấp nhận từ chính trang của nó: Sec-Fetch-Site, khi được gửi, phải là same-origin, và Origin, khi được gửi, phải là origin của CONNECT_PUBLIC_URL; một post không có cả hai bị từ chối. Vì vậy proxy phải chuyển tiếp nguyên vẹn cả hai header, và CONNECT_PUBLIC_URL phải là địa chỉ mà trình duyệt của mọi người thực sự dùng. Nếu việc tiếp tục trên trang đó luôn hiện “Liên kết này đã hết hạn”, và nhật ký có oauth.done_refused với lý do origin hoặc no_origin, thì một trong hai header đó đang bị tắt.
Connect từ chối khởi động (mã thoát 78) khi cấu hình của nó mở, không an toàn hoặc còn dở dang,
và in ra biến nào sai. Thiếu danh sách cho phép, một địa chỉ http không phải loopback, một khóa
niêm phong sai định dạng, hoặc cả NAME lẫn NAME_FILE cùng được đặt đều khiến nó dừng.
Điểm kiểm tra: trên mỗi máy chủ, thẻ Connect hiển thị Đang hoạt động, và Mỗi kiểu đăng nhập
chạy ở đâu ghi Connect cho mọi nhà cung cấp bạn đã đăng ký. cc_server connect status in
ra Health: ok cùng các làn tương tự.
Gắn Connect bên trong cc_server
Phần tiêu đề “Gắn Connect bên trong cc_server”Một máy chủ có thể tự lưu trữ Connect thay vì dùng một container riêng. Dịch vụ được gắn chính là dịch vụ mà ảnh chạy.
- Đặt các biến
CONNECT_*vào tệp.envcủa máy chủ, như ở Bước 5. Máy chủ từ chối khởi động khi một bí mật Connect, kể cảCONNECT_SENTRY_DSN, được export trong môi trường của nó - Thêm
CC_SERVER_CONNECT_HOST=on - Khởi động lại máy chủ. Nhật ký của nó in ra
embedded Connect at <url>
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 khi đó được phục vụ tại <server>/connect:
CONNECT_PUBLIC_URLmặc định là origin URL công khai của máy chủ cộng với/connect. Hãy đặt nó rõ ràng khi đứng sau proxy. Đường dẫn của nó phải chính xác là/connect, và phải dùng HTTPS trừ khi là loopback- Chỉ các biến
CONNECT_*mới đến được dịch vụ được gắn, nên nó không bao giờ mượn các ứng dụng nhà cung cấp của chính máy chủ CONNECT_ALLOWED_INSTALLSvẫn bắt buộc, kể cả với chính máy chủ đang lưu trữ- Một lần gắn cấu hình sai sẽ khiến máy chủ không khởi động được, thay vì phục vụ một broker mở
- Máy chủ demo không bao giờ gắn nó
Đăng ký chuyển hướng của nhà cung cấp với https://<server>/connect, rồi trỏ các máy chủ (kể cả
máy chủ đang lưu trữ) tới URL đó như ở Bước 3.
Tham chiếu cấu hình
Phần tiêu đề “Tham chiếu cấu hình”Mọi cài đặt là một biến môi trường. Bất kỳ bí mật nào cũng có thể lấy từ một tệp được gắn: đặt
NAME_FILE thay cho NAME. Connect đọc lại tệp tối đa mỗi 30 giây và giữ giá trị tốt gần nhất.
Các bí mật được đánh dấu dual cũng nhận NAME_PREVIOUS (hoặc NAME_PREVIOUS_FILE) trong lúc
xoay vòng.
Địa chỉ và truy cập
Phần tiêu đề “Địa chỉ và truy cập”| Biến | Mặc định | Ý nghĩa |
|---|---|---|
CONNECT_PUBLIC_URL |
bắt buộc | URL công khai chuẩn. HTTPS, hoặc http chỉ trên loopback. Một đường dẫn nghĩa là được gắn. Không có query hay fragment |
CONNECT_ALLOWED_INSTALLS |
bắt buộc | Các id cài đặt phân tách bằng dấu phẩy. * chỉ được chấp nhận cùng CONNECT_SIGNED_CONFIG_FILE |
CONNECT_DENY_INSTALLS |
Các id cài đặt bị từ chối ngay cả khi đã được cho phép | |
CONNECT_GITHUB_ALLOWED_OWNERS |
Các id chủ sở hữu GitHub dạng số. Khi đặt, token kho mã chỉ được cấp cho các kho mã do họ sở hữu. Nó không giới hạn ai đăng nhập: một người được phép dùng Connect này vẫn nhận token người dùng App riêng của họ. Để chỉ phục vụ một tổ chức, hãy giữ App riêng cho tổ chức đó | |
CONNECT_GITHUB_REVIEW_BOT_INSTALLS |
Các id cài đặt được phép để bot của App review pull request. Mặc định rỗng; * bị từ chối, và mỗi id cũng phải được cho phép |
|
CONNECT_HOST, CONNECT_PORT |
0.0.0.0, 8790 |
Địa chỉ bind và cổng |
CONNECT_TRUST_PROXY |
0 |
Số chặng proxy đáng tin trong X-Forwarded-For (0 đến 8). Chỉ dùng cho các giới hạn theo địa chỉ, gợi ý mạng của trang đăng nhập và địa chỉ được ghi nhật ký. Đứng sau proxy, 0 coi mọi client là proxy, và nhật ký nói điều đó một lần |
Các làn nhà cung cấp
Phần tiêu đề “Các làn nhà cung cấp”| Biến | Mặc định | Ý nghĩa |
|---|---|---|
CONNECT_GITHUB_APP_ID, CONNECT_GITHUB_APP_SLUG, CONNECT_GITHUB_CLIENT_ID |
GitHub App | |
CONNECT_GITHUB_CLIENT_SECRET |
Bí mật, dual | |
CONNECT_GITHUB_APP_PRIVATE_KEY |
Bí mật. Khóa riêng của App (PEM) | |
CONNECT_GOOGLE_CLIENT_ID, CONNECT_GOOGLE_CLIENT_SECRET |
Client Google. Bí mật là dual | |
CONNECT_LINEAR_CLIENT_ID |
Ứng dụng Linear. Không có bí mật | |
CONNECT_SLACK_APP_ID, CONNECT_SLACK_CLIENT_ID |
Ứng dụng Slack | |
CONNECT_SLACK_CLIENT_SECRET, CONNECT_SLACK_SIGNING_SECRET |
Bí mật, dual | |
CONNECT_KLIPY_APP_KEY |
Khóa tìm GIF Klipy. Bí mật, dual | |
CONNECT_KLIPY_MODE |
proxy |
proxy giữ khóa trong Connect; key đưa khóa cho các máy chủ |
CONNECT_<LANE>_SECRET_GENERATION |
1 |
GitHub, Google và Slack: thế hệ được ghi vào các niêm phong mới |
CONNECT_<LANE>_MIN_SEAL_GENERATION |
1 |
GitHub, Google và Slack: niêm phong cũ hơn phải đăng nhập lại |
CONNECT_<LANE>_ACCEPTS_NEW |
true |
Mọi làn: false ngừng đăng nhập mới trong khi đăng nhập hiện có vẫn làm mới |
Niêm phong, trạng thái và lưu trữ
Phần tiêu đề “Niêm phong, trạng thái và lưu trữ”| Biến | Mặc định | Ý nghĩa |
|---|---|---|
CONNECT_SEAL_BACKEND |
local |
local hoặc gcp-kms |
CONNECT_SEAL_KEYS |
Bí mật, bắt buộc với local. Các mục kid:key phân tách bằng dấu phẩy, mới nhất trước; các mục cũ hơn vẫn giải mã được |
|
CONNECT_KMS_KEY |
projects/…/locations/…/keyRings/…/cryptoKeys/…, bắt buộc với gcp-kms |
|
CONNECT_STATE |
memory |
memory cho một instance, redis cho nhiều instance. Kho trạng thái đầy sẽ từ chối đăng nhập và yêu cầu mới thay vì quên một mục còn hiệu lực |
CONNECT_REDIS_URL |
Bí mật. redis:// hoặc rediss://. Redis 6.2 trở lên với maxmemory-policy noeviction, cả hai được kiểm tra khi khởi động |
|
CONNECT_REDIS_CA_FILE |
Bundle CA cho rediss:// |
|
CONNECT_BINDINGS |
file |
Nơi lưu các ràng buộc đội Slack: file hoặc firestore |
CONNECT_DATA_DIR |
data (/data trong ảnh) |
Chứa bindings.json. Bị khóa bởi một Connect: Connect thứ hai trên cùng thư mục sẽ không khởi động |
CONNECT_FIRESTORE_PROJECT, CONNECT_FIRESTORE_DATABASE |
cơ sở dữ liệu (default) |
Dùng cho CONNECT_BINDINGS=firestore. Connect không khởi động khi Firestore không phản hồi |
Cấu hình, nhật ký và giới hạn
Phần tiêu đề “Cấu hình, nhật ký và giới hạn”| Biến | Mặc định | Ý nghĩa |
|---|---|---|
CONNECT_SIGNED_CONFIG_FILE |
Một cấu hình đã ký offline, được phục vụ nguyên trạng. Dùng cho Connect hosted của Control Center | |
CONNECT_CONFIG_PUBLIC_KEYS |
Các khóa mà cấu hình đã ký phải xác minh được | |
CONNECT_CONFIG_EPOCH |
1 |
Epoch của cấu hình mà một Connect tự lưu trữ tạo ra |
CONNECT_LOG_HMAC_KEY |
ngẫu nhiên mỗi tiến trình | Bí mật. Đặt nó để các thẻ thay cho id cài đặt trong nhật ký ổn định qua các lần khởi động lại và các instance |
CONNECT_SENTRY_DSN |
Bí mật. Một DSN Sentry https mà các dòng lỗi được báo cáo tới: loại lỗi, khung stack, route và id yêu cầu, không bao giờ là thông điệp, nội dung hay header | |
CONNECT_SENTRY_ENVIRONMENT |
self-hosted |
Môi trường Sentry |
CONNECT_VERSION, CONNECT_IMAGE_DIGEST |
Được báo cáo bởi /v1/version |
|
CONNECT_RATE_INSTALL_PER_MINUTE |
600 |
Số yêu cầu cho mỗi cài đặt |
CONNECT_RATE_IP_PER_MINUTE |
300 |
Số yêu cầu cho mỗi địa chỉ (một địa chỉ IPv6 tính theo /64) |
CONNECT_RATE_GLOBAL_PER_SECOND |
500 |
Số yêu cầu cho toàn bộ instance |
CONNECT_RATE_SLACK_HOOK_IP_PER_MINUTE |
600 |
Lượt gửi sự kiện và lệnh Slack cho mỗi địa chỉ, được đếm riêng với các yêu cầu khác |
CONNECT_RATE_SLACK_HOOK_GLOBAL_PER_SECOND |
100 |
Lượt gửi sự kiện và lệnh Slack cho toàn bộ instance |
CONNECT_RATE_SLACK_TEAM_PER_MINUTE |
600 |
Sự kiện Slack cho mỗi team |
CONNECT_RATE_KLIPY_PER_MINUTE |
120 |
Số lượt tìm GIF cho mỗi cài đặt |
CONNECT_RATE_KLIPY_IP_PER_MINUTE |
240 |
Lượt tìm GIF cho mỗi địa chỉ, trên mọi máy chủ |
CONNECT_RATE_LOGINS_IP_PER_10_MINUTES |
60 |
Số đăng nhập đã bắt đầu cho mỗi địa chỉ |
CONNECT_RATE_GITHUB_TOKENS_ACCOUNT_PER_HOUR |
30 |
Số token GitHub đã cấp cho mỗi tài khoản GitHub trên một máy chủ (đăng nhập, làm mới, token kho mã) |
CONNECT_RATE_GITHUB_TOKENS_ACCOUNT_CEILING_PER_HOUR |
4 × mục trên (120) |
Như trên cho mỗi tài khoản GitHub trên mọi máy chủ |
CONNECT_RATE_GITHUB_TOKENS_IP_PER_HOUR |
600 |
Số token GitHub đã cấp cho mỗi địa chỉ |
CONNECT_RATE_GITHUB_EXCHANGE_CEILING_PER_HOUR |
500 |
Đăng nhập GitHub mới cho toàn bộ ứng dụng |
CONNECT_RATE_GITHUB_APP_MINTS_INSTALL_PER_HOUR |
120 |
Token bot cho mỗi máy chủ |
CONNECT_RATE_GITHUB_APP_MINTS_ACCOUNT_PER_HOUR |
240 |
Token bot cho mỗi tài khoản GitHub yêu cầu, trên mọi máy chủ |
CONNECT_RATE_GITHUB_APP_CEILING_PER_HOUR |
3000 |
Token bot cho toàn bộ ứng dụng |
CONNECT_RATE_GITHUB_TOKEN_CEILING_PER_HOUR |
1500 |
Làm mới và token kho mã cho toàn bộ ứng dụng. Đăng nhập mới có giới hạn riêng ở trên |
CONNECT_GITHUB_TOKEN_CAP_WARN |
10 |
Số token kho mã còn hiệu lực mà một tài khoản GitHub được giữ trước khi Connect ghi cảnh báo |
CONNECT_RATE_RETIRE_IP_PER_HOUR |
10 |
Id cài đặt bị thu hồi cho mỗi địa chỉ (theo /48 với IPv6) |
Một lời gọi vượt giới hạn được trả lời rate_limited. Các máy chủ thử lại sau và không bao giờ đăng xuất ai vì điều đó.
Chạy nhiều hơn một instance
Phần tiêu đề “Chạy nhiều hơn một instance”Một instance với CONNECT_STATE=memory là đủ cho hầu hết các tổ chức. Nhiều instance phía sau
một địa chỉ cần CONNECT_STATE=redis và
CONNECT_BINDINGS=firestore, để một đăng nhập bắt đầu trên instance này có thể hoàn tất trên
instance khác và mọi instance thấy cùng các ràng buộc Slack và cùng id cài đặt đã thu hồi. Một CONNECT_DATA_DIR dùng chung thì không hoạt động: Connect đầu tiên sẽ khóa nó. Các giới hạn theo cài đặt, theo địa chỉ và theo instance là riêng cho từng instance; các giới hạn đăng nhập, token GitHub, token bot, lượt tìm GIF theo địa chỉ, thu hồi và đội Slack được chia sẻ qua kho trạng thái.
Xoay bí mật nhà cung cấp
Phần tiêu đề “Xoay bí mật nhà cung cấp”Không ai bị đăng xuất:
- Tạo bí mật mới tại nhà cung cấp và giữ bí mật cũ
- Chuyển giá trị cũ sang
NAME_PREVIOUS, đặt giá trị mới vàoNAME, và tăngCONNECT_<LANE>_SECRET_GENERATION. Các tệp được gắn sẽ được nhận trong vòng 30 giây - Chờ các đăng nhập làm mới, rồi xóa bí mật cũ tại nhà cung cấp và bỏ
NAME_PREVIOUS
Để xoay khóa niêm phong, hãy đặt một mục cc-connect-config seal-key mới vào đầu
CONNECT_SEAL_KEYS và giữ mục cũ cho đến khi các niêm phong của nó đã được làm mới.
Đổi ứng dụng
Phần tiêu đề “Đổi ứng dụng”Các máy chủ ghi nhớ id ứng dụng và id client mà Connect của bạn đã công bố lần đầu chúng dùng nó. Nếu bạn thay một ứng dụng, thẻ Connect của mọi máy chủ sẽ hiển thị Ứng dụng của Connect đã thay đổi, và đăng nhập qua Connect sẽ tạm dừng cho đến khi chủ của nó nhấn Tin tưởng ứng dụng mới. Hãy báo chủ máy chủ trước khi bạn chuyển, để họ biết lời nhắc đó đến từ bạn.
Chặn một máy chủ
Phần tiêu đề “Chặn một máy chủ”Thêm id cài đặt của nó vào CONNECT_DENY_INSTALLS rồi khởi động lại. Chủ của nó sẽ thấy
“Connect đã chặn ID cài đặt của máy chủ này. Hãy liên hệ người vận hành máy chủ Connect của bạn.” và mọi đăng nhập qua Connect trên đó sẽ dừng lại.
Một máy chủ cũng thu hồi id cài đặt cũ của chính nó khi chủ của nó xoay khóa. Nó chứng minh id đó là của mình bằng một niêm phong thông tin xác thực mà Connect này đã tạo cho nó, nên chỉ một máy chủ đã từng đăng nhập ai đó mới có thể thu hồi một id. Connect giữ các id đã thu hồi mãi mãi, nên khóa cũ và mọi niêm phong được tạo cho nó đều ngừng hoạt động, và giải phóng các workspace Slack đang gắn với id cũ. Token đã cấp trước đó tự hết hạn: trong vòng 8 giờ với token của người, 1 giờ với token của bot. Connect giữ tối đa 100.000 id đã thu hồi; vượt quá mức đó, một lần xoay khóa bị từ chối và nhật ký ghi điều đó ở mức lỗi.
Xử lý sự cố
Phần tiêu đề “Xử lý sự cố”Một máy chủ báo Connect đã chặn nó
Phần tiêu đề “Một máy chủ báo Connect đã chặn nó”Id cài đặt của nó không có trong CONNECT_ALLOWED_INSTALLS, nó có trong
CONNECT_DENY_INSTALLS, hoặc nó đã bị thu hồi bởi một lần xoay khóa. Id đổi khi chủ máy chủ xoay khóa; hãy yêu cầu id mới.
Mọi đăng nhập vào một nhà cung cấp đều thất bại
Phần tiêu đề “Mọi đăng nhập vào một nhà cung cấp đều thất bại”Một trong các biến của nó có thể bị thiếu, nên Connect đã loại làn đó ra. Hãy kiểm tra nhật ký khởi động và các bảng ở trên. GitHub cần đủ năm thứ là app id, slug, client id, client secret và khóa riêng; Google cần cả client id lẫn client secret.
Đăng nhập thất bại với lỗi không khớp redirect
Phần tiêu đề “Đăng nhập thất bại với lỗi không khớp redirect”Redirect đã đăng ký với nhà cung cấp không khớp chính xác với CONNECT_PUBLIC_URL. Hãy so sánh
scheme, host, cổng và đường dẫn /connect đối với một Connect được gắn.
Mọi người phải đăng nhập lại
Phần tiêu đề “Mọi người phải đăng nhập lại”Khóa niêm phong đã thay đổi hoặc bị mất, một máy chủ đã xoay khóa của nó, hoặc dữ liệu của một máy chủ được khôi phục sang một máy khác. Một thông tin xác thực đã niêm phong chỉ mở được cho cài đặt và Connect đã tạo ra nó.