From 8a70300e01a1c836f2df45f42889ae55544b1730 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 27 Oct 2026 15:53:41 +0000 Subject: [PATCH 1/2] docs(security): explain how agents ask for credentials in chat Describe the single-use credential link and that a request from a group or thread is delivered only by direct message (nextlevelbuilder/dewee#1760). Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01FL32rwzKkVWs7HQGUEUhZH --- src/content/docs/en/security/secrets-roles-and-audit.md | 6 ++++++ src/content/docs/vi/security/secrets-roles-and-audit.md | 6 ++++++ 2 files changed, 12 insertions(+) diff --git a/src/content/docs/en/security/secrets-roles-and-audit.md b/src/content/docs/en/security/secrets-roles-and-audit.md index 88b90e0..7cfe1d9 100644 --- a/src/content/docs/en/security/secrets-roles-and-audit.md +++ b/src/content/docs/en/security/secrets-roles-and-audit.md @@ -21,6 +21,12 @@ Without the encryption key, the gateway logs a warning at startup and stores the The HTTP API never returns a stored provider key; it shows `***` instead. API keys and webhook secrets are shown once, when you create them. If you lose one, create a new one and revoke the old one. +### When an agent asks you for a credential + +An agent you allowed to request credentials never asks you to paste a key into the chat. In the console chat it shows a form; on a chat app it sends a single-use link to a form in the console, which works for 24 hours and only for the person who asked. The value goes straight to encrypted storage, and the agent only learns whether it was saved. + +If you ask from a group or a thread, the link is sent to you in a direct message, never to the group; the group only hears that a private message was sent. This works on Telegram, Discord and Slack, and only when your chat account is linked to a workspace user. If the bot cannot message you privately (for example, you never started a chat with it), the request is cancelled and the agent asks you to message it directly or to continue in the console. + ## Workspace roles in the console The console has three built-in roles and any number of custom ones. diff --git a/src/content/docs/vi/security/secrets-roles-and-audit.md b/src/content/docs/vi/security/secrets-roles-and-audit.md index c07906f..5023799 100644 --- a/src/content/docs/vi/security/secrets-roles-and-audit.md +++ b/src/content/docs/vi/security/secrets-roles-and-audit.md @@ -21,6 +21,12 @@ Nếu thiếu khoá mã hoá, gateway ghi cảnh báo lúc khởi động và l HTTP API không bao giờ trả về API key của provider đã lưu; nó hiện `***` thay thế. API key và secret của webhook chỉ hiện một lần, lúc bạn tạo. Nếu làm mất, hãy tạo cái mới và thu hồi cái cũ. +### Khi agent xin bạn một credential + +Agent được bạn cho phép xin credential không bao giờ bảo bạn dán key vào khung chat. Trong chat của console, agent hiện một form; trên ứng dụng chat, agent gửi một link dùng một lần tới form trong console. Link có hiệu lực 24 giờ và chỉ dùng được bởi người đã yêu cầu. Giá trị được ghi thẳng vào kho mã hoá, agent chỉ biết là đã lưu hay chưa. + +Nếu bạn yêu cầu từ một nhóm hoặc một thread, link được gửi cho bạn qua tin nhắn riêng, không bao giờ vào nhóm; nhóm chỉ được báo là đã gửi tin nhắn riêng. Tính năng này hoạt động trên Telegram, Discord và Slack, và chỉ khi tài khoản chat của bạn đã liên kết với một người dùng trong workspace. Nếu bot không nhắn riêng được cho bạn (ví dụ bạn chưa từng bắt đầu chat với bot), yêu cầu bị huỷ và agent sẽ đề nghị bạn nhắn trực tiếp cho nó hoặc tiếp tục trong console. + ## Vai trò trong workspace trên console Console có ba vai trò dựng sẵn và bao nhiêu vai trò tuỳ chỉnh cũng được. From da584c81516b84fcef3425f91f889ef5d7f39319 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 27 Oct 2026 16:08:18 +0000 Subject: [PATCH 2/2] docs(security): match the credential link section to the shipped behavior Group requests go to the requester's direct messages without a linked account requirement, a failed direct message revokes the link, and runs no person started never send a link (nextlevelbuilder/dewee#1777). Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01FL32rwzKkVWs7HQGUEUhZH --- src/content/docs/en/security/secrets-roles-and-audit.md | 2 +- src/content/docs/vi/security/secrets-roles-and-audit.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/en/security/secrets-roles-and-audit.md b/src/content/docs/en/security/secrets-roles-and-audit.md index 7cfe1d9..6411223 100644 --- a/src/content/docs/en/security/secrets-roles-and-audit.md +++ b/src/content/docs/en/security/secrets-roles-and-audit.md @@ -25,7 +25,7 @@ The HTTP API never returns a stored provider key; it shows `***` instead. API ke An agent you allowed to request credentials never asks you to paste a key into the chat. In the console chat it shows a form; on a chat app it sends a single-use link to a form in the console, which works for 24 hours and only for the person who asked. The value goes straight to encrypted storage, and the agent only learns whether it was saved. -If you ask from a group or a thread, the link is sent to you in a direct message, never to the group; the group only hears that a private message was sent. This works on Telegram, Discord and Slack, and only when your chat account is linked to a workspace user. If the bot cannot message you privately (for example, you never started a chat with it), the request is cancelled and the agent asks you to message it directly or to continue in the console. +If you ask from a group or a thread, the link is sent to you in a direct message, never to the group; the group only hears that a private message was sent. This works on Telegram, Discord and Slack. If the bot cannot message you privately (for example, you never started a chat with it, or the channel has no direct messages), the request is cancelled and the link revoked, and the agent asks you to continue in a direct chat or in the console. Scheduled and other automatic runs never send a credential link on a chat app. ## Workspace roles in the console diff --git a/src/content/docs/vi/security/secrets-roles-and-audit.md b/src/content/docs/vi/security/secrets-roles-and-audit.md index 5023799..93e2de8 100644 --- a/src/content/docs/vi/security/secrets-roles-and-audit.md +++ b/src/content/docs/vi/security/secrets-roles-and-audit.md @@ -25,7 +25,7 @@ HTTP API không bao giờ trả về API key của provider đã lưu; nó hiệ Agent được bạn cho phép xin credential không bao giờ bảo bạn dán key vào khung chat. Trong chat của console, agent hiện một form; trên ứng dụng chat, agent gửi một link dùng một lần tới form trong console. Link có hiệu lực 24 giờ và chỉ dùng được bởi người đã yêu cầu. Giá trị được ghi thẳng vào kho mã hoá, agent chỉ biết là đã lưu hay chưa. -Nếu bạn yêu cầu từ một nhóm hoặc một thread, link được gửi cho bạn qua tin nhắn riêng, không bao giờ vào nhóm; nhóm chỉ được báo là đã gửi tin nhắn riêng. Tính năng này hoạt động trên Telegram, Discord và Slack, và chỉ khi tài khoản chat của bạn đã liên kết với một người dùng trong workspace. Nếu bot không nhắn riêng được cho bạn (ví dụ bạn chưa từng bắt đầu chat với bot), yêu cầu bị huỷ và agent sẽ đề nghị bạn nhắn trực tiếp cho nó hoặc tiếp tục trong console. +Nếu bạn yêu cầu từ một nhóm hoặc một thread, link được gửi cho bạn qua tin nhắn riêng, không bao giờ vào nhóm; nhóm chỉ được báo là đã gửi tin nhắn riêng. Tính năng này hoạt động trên Telegram, Discord và Slack. Nếu bot không nhắn riêng được cho bạn (ví dụ bạn chưa từng bắt đầu chat với bot, hoặc kênh không hỗ trợ tin nhắn riêng), yêu cầu bị huỷ, link bị thu hồi và agent sẽ đề nghị bạn tiếp tục trong chat riêng hoặc trong console. Các lần chạy theo lịch hoặc tự động khác không bao giờ gửi link credential trên ứng dụng chat. ## Vai trò trong workspace trên console