API quản trị dành cho các tổ chức Enterprise

Các API quản trị của Notion cho phép tổ chức của bạn xử lý công việc quản trị bằng mã. Điều này bao gồm các nhiệm vụ phổ biến như Bắt đầu Xuất không gian làm việc, tạo và giải phóng lưu giữ pháp lý, đăng xuất người dùng được quản lý khỏi Notion, v.v.

Bạn có thể thiết lập việc này trong cài đặt tổ chức của mình. Bạn tạo một bot quản trị cho tổ chức của mình, sau đó cấp cho nó một mã thông báo chỉ với quyền truy cập mà nó cần.

• Tổ chức của bạn cần phải sử dụng gói Enterprise.

• Bạn phải là chủ sở hữu tổ chức.

• Công cụ này được xây dựng cho các nhóm quản trị, CNTT, bảo mật và tuân thủ. Các thành viên và khách sẽ không nhận thấy bất kỳ thay đổi nào trong công việc hàng ngày của họ.

1. Mở bộ chuyển đổi không gian làm việc của bạn và chọn Quản lý tổ chức.

2. Đi tới Chung, sau đó mở Quản lý mã thông báo API quản trị viên cấp tổ chức.

3. Chọn Tạo kết nối.

4. Đặt tên cho kết nối mà nhóm của bạn sẽ nhận ra, chẳng hạn như “Tự động hóa tuân thủ”, và chỉ chọn quyền truy cập cần thiết. Nếu một kết nối chỉ chạy Xuất, đừng cấp cho nó quyền lưu giữ pháp lý.

5. Chọn Tạo mã thông báo, sau đó sao chép mã thông báo và lưu nó vào trình quản lý bí mật mà nhóm của bạn đang sử dụng.

Bạn sẽ thấy kết nối mới được liệt kê trong cài đặt tổ chức của mình, cùng với người đã tạo và thời gian tạo. Bạn có thể quay lại và sao chép lại mã thông báo bất cứ lúc nào từ menu của kết nối.

• Chọn tập hợp quyền truy cập nhỏ nhất vẫn hoàn thành được công việc.

• Xoay vòng mã thông báo theo lịch trình mà nhóm bảo mật của bạn thiết lập.

• Xóa mã thông báo ngay lập tức nếu nó bị chia sẻ nhầm hoặc người sở hữu nó thay đổi vai trò. Mọi tập lệnh sử dụng mã thông báo đó sẽ ngừng hoạt động ngay lập tức.

• Bạn không thể giới hạn mã thông báo quản trị viên cho các địa chỉ IP hoặc mạng cụ thể. Hãy sử dụng các biện pháp kiểm soát mà bạn đã có, như lưu trữ mã thông báo trong trình quản lý bí mật và chạy các lệnh gọi từ các hệ thống mà bạn tin tưởng.

Các Hành động được thực hiện bằng mã thông báo quản trị viên sẽ hiển thị trong nhật ký kiểm tra của bạn. Bot quản trị viên được liệt kê là tác nhân, vì vậy bạn có thể phân biệt công việc tự động với công việc của con người.

• Cuộc gọi bị từ chối. Kiểm tra xem tổ chức của bạn có đang sử dụng gói Enterprise hay không.

• Bạn gặp lỗi quyền. Kiểm tra xem mã thông báo có truy cập vào Hành động bạn đang gọi hay không. Một mã thông báo chỉ được giới hạn cho Xuất không thể tạo lưu giữ pháp lý.

• Một cuộc gọi đăng xuất không có tác dụng. Kiểm tra xem tài khoản đó có phải là người dùng được quản lý hay không. Các tài khoản bên ngoài miền đã xác minh của bạn không được bao gồm.

Để biết định dạng yêu cầu, tham số và mẫu mã, hãy xem tài liệu tham khảo API quản trị viên trong tài liệu dành cho nhà phát triển.