--- title: "Giữ bí mật truy cập" locale: vi url: https://tlg.builera.app/docs/safety/keep-secrets verified: 2026-10-24 app_version: "2.0" --- # Giữ bí mật truy cập Nhận biết dữ liệu truy cập nhạy cảm, cách app bảo vệ chúng và các bước cần làm khi nghi có rò rỉ. Bất kỳ dữ liệu nào cho phép đăng nhập, gọi API hoặc giả danh bên gửi đều là bí mật. Không đưa chúng vào ảnh chụp, tệp xuất, nhật ký tự viết hoặc nội dung gửi cho người hỗ trợ. ## Những gì cần bảo vệ | Bí mật | Quyền truy cập mà nó có thể mang lại | |---|---| | Phiên Telegram | Truy cập tài khoản đã đăng nhập. | | Mã đăng nhập, mật khẩu 2 lớp | Hoàn tất đăng nhập hoặc xác nhận thao tác nhạy cảm. | | Mật khẩu proxy | Sử dụng đường mạng của proxy. | | Hetzner API token | Quản lý tài nguyên theo quyền token được cấp. | | Khoá API bắt đầu bằng `tga_` | Gọi API trong phạm vi kết nối AI. | | Bí mật webhook | Ký hoặc kiểm tra tính xác thực của webhook. | | Bot token | Điều khiển bot tương ứng. | | Mã ghép máy | Ghép worker với máy được đăng ký. | Không chia sẻ cả chuỗi cấu hình proxy nếu chuỗi đó chứa tài khoản và mật khẩu. Một ảnh QR đăng nhập cũng phải được coi là dữ liệu truy cập nhạy cảm. ## App bảo vệ như thế nào App dùng cơ chế niêm phong cho các bí mật cần giải mã để sử dụng, như mật khẩu proxy, token Hetzner, bot token và bí mật webhook. Phiên Telegram được bảo vệ trên máy worker và khi sao lưu. Khoá API của kết nối AI có cách lưu khác: app giữ dấu băm để kiểm tra khoá, không giữ bản rõ để bạn xem lại. Khi mất khoá, bạn cần tạo khoá thay thế. Mật khẩu 2 lớp được nhập cho một lần đăng nhập hoặc thao tác cần nó; không phải mật khẩu để lưu lại trong hồ sơ tài khoản. Đừng nhập mật khẩu vào ô ghi chú để “tiện dùng lần sau”. Bí mật webhook được trả về khi tạo hoặc đổi bí mật, với dấu hiệu `shown_once`. Một lần gọi lại có cùng khoá chống lặp có thể trả lại cùng kết quả tạo ban đầu; vì vậy “hiện một lần” không nên được hiểu là bí mật không bao giờ đi qua phản hồi API. > [!IMPORTANT] > Không coi mọi màn hình là nơi không thể xuất hiện token. Luồng quản lý bot có thao tác xem token dành cho người dùng trong app. Chỉ mở khi cần và không chụp hoặc sao chép sang nơi công khai. Các đường xuất dữ liệu và chẩn đoán thông thường không phải bản sao lưu bí mật. App có che một số mẫu nhạy cảm trong phản hồi webhook, nhưng bạn vẫn phải rà lại tệp và nội dung trước khi chia sẻ. Bộ che không thể bảo đảm nhận biết mọi chuỗi bí mật do bạn tự dán vào. ## Khi khoá API bị lộ 1. Vào **Cài đặt → Kết nối AI**. 2. Chọn **Dừng ngay** cho kết nối liên quan. 3. Kiểm tra hoạt động và những việc kết nối đã tạo. 4. Đổi khoá API. 5. Cập nhật khoá mới trong hệ thống được phép sử dụng. 6. Chỉ bật lại sau khi đã loại bỏ nguyên nhân rò rỉ. Dừng kết nối từ chối lệnh mới và huỷ việc đang xếp hàng của nó. Việc đã thực hiện trên Telegram không được hoàn tác chỉ vì bạn dừng kết nối. > [!WARNING] > Xoá kết nối cắt quyền truy cập của các hệ thống đang dùng nó. Hãy xác định đúng kết nối trước khi xoá. Nếu không còn dùng, xoá kết nối sau khi đã lưu lại thông tin điều tra không chứa bí mật. ## Với các bí mật khác Đổi bí mật webhook rồi cập nhật bên nhận; nếu thu hồi khoá cũ ngay, bên nhận chưa cập nhật sẽ từ chối sự kiện. Với token Hetzner, bot token hoặc mật khẩu proxy, hãy thu hồi hay đổi tại dịch vụ cấp chúng rồi cập nhật cấu hình liên quan. Nếu nghi phiên Telegram bị lộ, kiểm tra các phiên đăng nhập và thu hồi phiên không nhận ra. Không gửi phiên cho người hỗ trợ để họ “kiểm tra hộ”. ## Liên quan - [Kết nối AI](https://tlg.builera.app/docs/integrations/ai-connections) - [Đổi bí mật webhook](https://tlg.builera.app/docs/agent-playbooks/rotate-webhook-secret) - [Thao tác nguy hiểm](https://tlg.builera.app/docs/safety/dangerous-actions)