---
title: "API key"
description: "API key xác thực các tích hợp machine-to-machine đã được phê duyệt. Public Deployment Configure Embed tích hợp sẵn không dùng organization API key trong trình duyệt; nó đổi publ…"
url: "https://sotaagents.ai/vi/manual/admin-console/api-keys"
generated_by: "sotaagents-ldp"
docs_index: "https://sotaagents.ai/manual/llms.txt"
locale: "vi"
---

# API key

API key xác thực các tích hợp machine-to-machine đã được phê duyệt. Public Deployment _Configure Embed_ tích hợp sẵn không dùng organization API key trong trình duyệt; nó đổi publish/embed identity lấy guest session bị giới hạn. Nếu chỉ dùng chat hoặc widget tích hợp sẵn, không tạo key cho mục đích đó.

1. #### Mở API Keys

   Truy cập _Console → Tổ chức của bạn → API Keys_ ở thanh bên trái.

![Màn hình API Keys liệt kê các key kèm public key, scope, trạng thái, lần dùng cuối và ngày tạo](/manual/assets/product/console-api-keys-20260813.webp)
_Mỗi key hiển thị scope và đã từng được dùng hay chưa._

2. #### Tạo key

   Nhấn _Create API Key_ (góc trên bên phải). Hộp thoại mở ra — nhập **Tên (Name)** tùy chọn (ví dụ: "Môi trường Production") để nhận biết sau này, sau đó nhấn _Create_.

![Hộp thoại Create API Key với tên đã nhập](/manual/assets/product/console-api-key-dialog-20260813.webp)
_Tên chỉ là nhãn cho bạn; nó không ảnh hưởng tới quyền của key._

3. #### Lưu ngay key và secret

   Màn hình "API Key created" **chỉ hiển thị duy nhất một lần**. Màn hình này hiển thị cả **API Key** (dạng: `sota_ek_…`) và **API Secret**. Hãy sao chép cả hai ngay bây giờ và lưu trữ an toàn — bạn không thể lấy lại secret sau khi đóng màn hình này.

![Hộp thoại hiện một lần sau khi tạo, với API key, secret đã che và cảnh báo secret sẽ không hiện lại](/manual/assets/product/console-api-key-created-20260813.webp)
_Secret chỉ hiện một lần. Hãy copy trước khi đóng hộp thoại._

4. #### Xác nhận và đóng

   Sau khi lưu, nhấn _I have saved the Secret_ để đóng hộp thoại.

5. #### Sử dụng key trong lời gọi API

   API key được dùng để nhúng SotaAgents vào các sản phẩm bên ngoài hoặc tích hợp với các hệ thống nội bộ. Công dụng chính là ký handshake cấp ticket — xem [Nhúng SotaAgents vào hệ thống nội bộ](/vi/manual/enterprise-integration/embedding-in-your-systems). Với widget công khai cho khách ẩn danh, hãy dùng _Workspace → Configure Embed_.

6. #### Vô hiệu hóa key

   Để ngừng sử dụng một key mà không xóa nó, nhấp vào nút _Actions_ trên dòng tương ứng và chọn _Disable_. Xác nhận trong hộp thoại. Key dừng hoạt động ngay lập tức và vẫn hiển thị ở trạng thái bị vô hiệu hóa trong danh sách.

> [!WARNING]
> Bảo mật API key
>
> Tuyệt đối không đưa API key vào mã nguồn (source control) hoặc chia sẻ trong tin nhắn. Hãy bảo vệ key như mật khẩu. Nếu key bị lộ, hãy vô hiệu hóa ngay và tạo key mới.