# Sử dụng quyền truy cập API

> Tạo token truy cập cá nhân cho tập lệnh và ứng dụng khách MCP, đồng thời gửi các sự kiện của Livespace đến hệ thống của bạn bằng webhook.

Trong Cài đặt › **Truy cập API**, bạn có thể tạo token truy cập cá nhân để tập lệnh hoặc ứng dụng khách MCP sử dụng Dvina thay mặt bạn. Quản trị viên cũng có thể thêm webhook tại đây để gửi các sự kiện của Livespace đến hệ thống của mình.

Quyền truy cập API có trong gói Enterprise. Mọi thành viên đều có thể tạo token riêng; chỉ chủ sở hữu và quản trị viên mới thấy mục **Webhook**.

## Tạo token

1. Mở Cài đặt và chọn **Truy cập API**.
2. Trong **Token truy cập cá nhân**, chọn **Tạo token**.
3. Nhập **Tên** để sau này bạn biết token được dùng cho việc gì.
4. Chọn **Quyền truy cập**: **Chỉ đọc** hoặc **Đọc và ghi**.
5. Chọn thời điểm **Hết hạn**: **Sau 30 ngày**, **Sau 90 ngày**, **Sau 365 ngày** hoặc **Không bao giờ hết hạn**.
6. Chọn **Tạo token**.
7. Trong **Sao chép token của bạn**, sao chép token và lưu ở nơi an toàn. Đây là lần duy nhất token được hiển thị.

Token hoạt động thay mặt bạn trong Livespace nơi bạn tạo token, với vai trò hiện tại của bạn tại đó. Token **Chỉ đọc** có thể đọc nhưng không thể thêm hoặc thay đổi bất kỳ nội dung nào.

Để dùng token với ứng dụng khách MCP, xem [Kết nối bằng khóa API thay vì OAuth](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Kiểm tra, thay mới hoặc thu hồi token

Các token của bạn được liệt kê trong **Token truy cập cá nhân** cùng với quyền truy cập của từng token. Chọn một token để xem thông tin **Bắt đầu bằng**, **Quyền truy cập**, **Lần sử dụng gần nhất** và thời điểm **Hết hạn**.

- **Để thay thế token**, chọn **Thay mới…**, rồi chọn **Thay mới** để xác nhận. Token mới sẽ thay thế token cũ, và token cũ sẽ ngừng hoạt động ngay lập tức. Sao chép token mới trong **Sao chép token của bạn**.
- **Để vô hiệu hóa token**, chọn **Thu hồi…**, rồi chọn **Thu hồi** để xác nhận. Mọi thứ sử dụng token đó sẽ ngừng hoạt động ngay lập tức.

Việc tạo, thay mới và thu hồi token được ghi lại trong [nhật ký kiểm toán](/docs/teams/audit-log).

## Thêm webhook

Webhook gửi các sự kiện của Livespace, cũng là những bản ghi trong [nhật ký kiểm toán](/docs/teams/audit-log), đến địa chỉ bạn chọn.

1. Trong Cài đặt › **Truy cập API**, tại mục **Webhook**, chọn **Thêm webhook**.
2. Nhập **Tên** và **URL**. Sử dụng URL HTTPS công khai.
3. Trong **Sự kiện**, để trống để nhận tất cả sự kiện, hoặc liệt kê các hành động và phạm vi, chẳng hạn như `member.added` hoặc `sharing.*`.
4. Chọn **Thêm**.
5. Trong **Sao chép khóa bí mật dùng để ký**, sao chép khóa bí mật. Đây là lần duy nhất khóa này được hiển thị.

Nếu Dvina hiển thị **Dvina không thể truy cập địa chỉ này**, hãy sử dụng URL HTTPS công khai.

### Kiểm tra chữ ký của từng yêu cầu

Dvina gửi sự kiện theo lô ở định dạng JSON và ký mọi yêu cầu. Dùng khóa bí mật dùng để ký để kiểm tra xem yêu cầu có đến từ Dvina hay không:

- Mỗi yêu cầu có một tiêu đề `X-Dvina-Signature` dạng `t=<timestamp>,v1=<signature>`.
- Chữ ký là giá trị HMAC-SHA256 ở dạng thập lục phân, được tạo bằng khóa bí mật dùng để ký của bạn từ dấu thời gian, một dấu chấm và phần thân yêu cầu.
- Tự tính giá trị này rồi so sánh. Từ chối yêu cầu nếu chữ ký không khớp hoặc dấu thời gian quá cũ.

## Kiểm tra hoặc thay đổi webhook

Các webhook của bạn được liệt kê trong **Webhook** kèm trạng thái: **Đang bật**, **Đã tạm dừng** hoặc **Đang lỗi**. Chọn một webhook để xem chi tiết.

- **Để thay đổi webhook**, chỉnh sửa **Tên**, **URL** hoặc **Sự kiện**, rồi chọn **Lưu**.
- **Để tạm dừng webhook**, tắt **Gửi sự kiện**. Bật lại để tiếp tục gửi.
- **Để kiểm tra hoạt động của webhook**, xem **Trạng thái** và số sự kiện **Đã gửi**. Webhook đang lỗi sẽ hiển thị **Lỗi gần nhất**. Dvina tiếp tục thử lại và ghi nhận lỗi trong nhật ký kiểm toán.
- **Để thay đổi khóa bí mật của webhook**, chọn **Khóa bí mật ký mới…**, rồi xác nhận. Các yêu cầu sẽ được ký bằng khóa bí mật mới ngay lập tức, vì vậy hãy cập nhật bên nhận ngay.
- **Để xóa webhook**, chọn **Xóa…**, rồi chọn **Xóa** để xác nhận. Sẽ không có gì được gửi đến webhook đó nữa.

## Nội dung liên quan

- [Sử dụng Dvina từ các ứng dụng khác qua MCP](/docs/dvina-mcp/overview)
- [Sử dụng nhật ký kiểm toán](/docs/teams/audit-log)
- [Tổng quan về nhóm](/docs/teams/overview)