Các tổ chức
Tổ chức nhóm các thông tin xác thực dưới một chủ sở hữu để nhiều người có thể chia sẻ chúng: các API key cho JSON API, và các proxy user cho cổng proxy. Mọi chi phí sử dụng từ thông tin xác thực của tổ chức được tính vào gói dịch vụ của chủ sở hữu tổ chức, không tính cho người gửi request.
Nơi tìm tính năng này
Đăng nhập vào bảng điều khiển và mở Tổ chức trên thanh bên. Mỗi tổ chức bạn tham gia là một hàng:
| Cột | Nội dung hiển thị |
|---|---|
| Tổ chức | Tên tổ chức. Nhấp vào tên, hoặc Mở, để chuyển đến trang riêng của tổ chức. |
| Vai trò của bạn | Chủ sở hữu, Quản trị viên, hoặc Thành viên |
| Thành viên | Số lượng người trong tổ chức, bao gồm cả chủ sở hữu |
| Key | Số lượng API key mà tổ chức sở hữu |
| Đã tạo | Thời điểm được tạo |
| Thao tác | Mở |
Tạo tổ chức
Nhấp vào Tổ chức mới, nhập tên từ 2 đến 60 ký tự và xác nhận. Bạn sẽ trở thành chủ sở hữu. Tên phải chứa ít nhất một chữ cái hoặc chữ số, và không được trùng với tên tổ chức đã có (hệ thống so sánh chữ cái và chữ số, bỏ qua các ký tự khác).
Việc tạo tổ chức yêu cầu gói dịch vụ hỗ trợ nhiều người. Hàng Tổ chức bạn sở hữu trên trang Mức sử dụng & Giới hạn sẽ hiển thị liệu gói của bạn có hỗ trợ hay không.
Vai trò
Có ba vai trò, và mỗi tổ chức có chính xác một chủ sở hữu.
| Vai trò | Quyền hạn |
|---|---|
| Thành viên | Tạo và sử dụng API key cũng như proxy user của tổ chức, đổi tên API key, và xem các thành viên cũng như nhóm của tổ chức |
| Quản trị viên | Mọi quyền của thành viên, kèm theo thêm và xóa người, thay đổi vai trò của họ, quản lý mọi thông tin xác thực của tổ chức, và đổi tên tổ chức |
| Chủ sở hữu | Mọi quyền của quản trị viên, kèm theo chuyển giao quyền sở hữu tổ chức cho người khác. Chủ sở hữu duy trì gói dịch vụ mà mọi thông tin xác thực của tổ chức tính phí vào. |
Chủ sở hữu không thể bị xóa, không thể rời khỏi tổ chức, và không thể bị giáng cấp. Quyền sở hữu chỉ chuyển giao theo một chiều: thông qua thao tác chuyển giao.
Việc thuộc về tổ chức chính là điều kiện cấp quyền truy cập vào các thông tin xác thực của tổ chức đó. Một thành viên không có quyền quản trị vẫn có thể tạo key hoặc proxy user do công ty chi trả. Đây chính là mục đích: một lập trình viên viết trình thu thập dữ liệu không cần phải dùng thông tin xác thực cá nhân để rồi bị tính phí thay vì công ty.
Trang tổ chức
Nút Mở trên bất kỳ hàng nào sẽ đưa bạn đến trang của tổ chức đó. Sáu thẻ nằm ở trên cùng: Thành viên (với phân loại chủ sở hữu, quản trị viên và thành viên bên dưới), Vai trò của bạn, Chủ sở hữu, API key, Proxy user, và Nhóm. Bên dưới là hai tab:
- Thành viên: những người trong tổ chức, kèm theo các quyền kiểm soát do vai trò của bạn cung cấp.
- Nhóm: các nhóm bạn trực thuộc bên trong tổ chức này, ở chế độ chỉ đọc.
Chủ sở hữu và quản trị viên cũng có thêm nút Đổi tên trong phần tiêu đề trang.
Thêm thành viên
Chủ sở hữu và quản trị viên có thẻ Thêm thành viên phía trên bảng Thành viên. Nhập địa chỉ email, chọn Thành viên hoặc Quản trị viên, và gửi.
Điều xảy ra tiếp theo phụ thuộc vào địa chỉ, và dashboard sẽ cho bạn biết trường hợp nào xảy ra:
- Địa chỉ đã có tài khoản FourA: họ tham gia ngay lập tức và nhận được email nêu rõ tên tổ chức, ai đã thêm họ, và vai trò của họ có thể làm gì.
- Địa chỉ chưa có tài khoản: FourA sẽ gửi email lời mời cho họ và họ sẽ tham gia ngay khi đăng nhập bằng địa chỉ đó. Không cần phải nhấp vào liên kết nào, và lời mời hoạt động dù họ đăng ký tài khoản mới hay đã có tài khoản từ trước mà chưa từng mở.
Lời mời hết hạn sau 14 ngày. Việc thêm lại cùng một địa chỉ sẽ làm mới lời mời đang chờ thay vì xếp chồng thêm lời mời thứ hai.
Chủ sở hữu nhận được email bất cứ khi nào có người tham gia, vì thành viên mới sẽ sử dụng credit của chủ sở hữu. Không ai nhận được email xác nhận cho hành động của chính mình.
Lời mời đang chờ
Khi có ít nhất một lời mời đang mở, bảng Invitations sẽ xuất hiện phía trên mục Thành viên, hiển thị cho chủ sở hữu và admin. Bảng này liệt kê địa chỉ, vai trò đang chờ gán, người đã mời, và thời gian mời. Lời mời đã hết hạn vẫn được liệt kê và đánh dấu, để bạn có thể thấy lý do tại sao không có ai tham gia. Sử dụng thao tác trên hàng để thu hồi lời mời.
Thay đổi vai trò
Chủ sở hữu và admin thay đổi vai trò của thành viên giữa Member và Admin bằng menu thả xuống trong cột Role. Ba quy tắc:
- Bạn không thể tự thay đổi vai trò của chính mình. Hãy yêu cầu admin khác, hoặc rời khỏi tổ chức.
- Vai trò của chủ sở hữu không thể chỉnh sửa tại đây. Sử dụng Make owner thay thế.
- Mỗi thay đổi đều yêu cầu xác nhận trước và nêu rõ người đó sẽ có thể làm gì sau khi thay đổi.
Xóa thành viên và Rời khỏi tổ chức
Chủ sở hữu và admin thấy nút Remove trên mọi hàng ngoại trừ hàng của chính họ và hàng của chủ sở hữu. Hàng của chính bạn sẽ hiển thị nút Leave, bất kể vai trò của bạn là gì.
Việc xóa ai đó cũng sẽ đưa họ ra khỏi các team của tổ chức, vì vậy họ lập tức không còn thấy thông tin đăng nhập của tổ chức nữa. Thao tác này không ảnh hưởng đến chính các thông tin đăng nhập: key hoặc proxy user của tổ chức thuộc về tổ chức, không thuộc về người đã tạo ra nó.
Chủ sở hữu không thể bị xóa cũng như không thể tự rời đi. Hãy chuyển giao quyền sở hữu tổ chức trước.
Chuyển giao quyền sở hữu tổ chức
Chỉ chủ sở hữu mới có thể thực hiện việc này. Trên tab Members, nhấp vào Make owner ở người tiếp quản và xác nhận.
Tổ chức sẽ chuyển sang gói dịch vụ của họ: từ thời điểm đó, mọi request mà key của tổ chức thực hiện và mọi tunnel mà proxy user của tổ chức mở đều tính vào credit, lưu lượng, giới hạn và hóa đơn của họ. Chủ sở hữu cũ sẽ trở thành admin và giữ nguyên mọi quyền hạn mà admin có thể làm.
Key bạn có thể thấy
Mọi key mà tổ chức sở hữu đều hiển thị với tất cả thành viên trong tổ chức. Điểm khác biệt nằm ở những thao tác bạn có thể thực hiện với key:
| Thao tác | Member | Admin | Owner |
|---|---|---|---|
| Sử dụng key, hiển thị key, tạo key tổ chức mới | Có | Có | Có |
| Đổi tên key, chỉnh sửa phần mô tả | Có | Có | Có |
| Tạo lại (regenerate), vô hiệu hóa, xóa | Không | Có | Có |
| Di chuyển key ra khỏi tổ chức | Không | Không | Có |
Đổi tên một khóa là vô hại. Tạo lại hoặc vô hiệu hóa khóa sẽ làm gián đoạn mọi đồng nghiệp đang sử dụng khóa đó ngay lập tức, đây là lý do các quyền này thuộc về admin. Chuyển khóa ra ngoài sẽ đưa tài sản ra khỏi tổ chức và tính mức sử dụng vào gói của người tiếp nhận, vì vậy quyền này chỉ dành riêng cho owner.
Xem Quản lý API Keys để xem hướng dẫn chi tiết.
Các Proxy User bạn có thể thấy
Proxy user cũng áp dụng ba cấp độ tương tự, vì những lý do tương tự.
| Hành động | Member | Admin | Owner |
|---|---|---|---|
| Sử dụng, xem mật khẩu, tạo mới | Có | Có | Có |
| Mật khẩu mới, vô hiệu hóa, xóa, thay đổi targeting đã lưu | Không | Có | Có |
| Chuyển ra khỏi tổ chức | Không | Không | Có |
Targeting đã lưu thuộc quyền của admin thay vì member vì việc trỏ lại targeting sẽ âm thầm trỏ lại mọi kết nối mà toàn bộ tổ chức thực hiện với thông tin xác thực đó. Tạo mật khẩu mới cũng thuộc quyền này vì nó làm hỏng mọi tệp cấu hình đã dán thông tin xác thực đó vào.
Trình tải xuống của công ty nên thuộc về proxy user của tổ chức. Proxy user cá nhân sẽ ngừng hoạt động vào ngày người đó rời đi, và chi phí sẽ tính cho họ. Xem Proxy Users để biết hướng dẫn.
Bộ lọc Owner
Khi bạn thuộc về một tổ chức, menu thả xuống Owner sẽ xuất hiện phía trên Tổng quan, Metrics, Activity, API Keys, và Proxy. Nó có ba loại tùy chọn: Everything, Personal, và một mục cho mỗi tổ chức. Tùy chọn được giữ nguyên giữa các lần truy cập và áp dụng cho cả năm trang đó.
Usage & Limits và Billing chủ đích không áp dụng bộ lọc này. Chúng trả lời câu hỏi "chi phí nào tính cho tôi", đây là câu hỏi khác với "tôi có thể thấy gì": một member không bao giờ thấy hạn ngạch của owner.
Phân bổ thanh toán
Mỗi request thực hiện bằng khóa thuộc sở hữu của tổ chức, và mỗi tunnel mở bằng proxy user thuộc sở hữu của tổ chức, đều được tính phí cho owner của tổ chức, bất kể ai là người gửi. Đó là toàn bộ lý do để chuyển thông tin xác thực vào tổ chức: nó thay đổi đối tượng bị tính mức sử dụng cho credits, lưu lượng, giới hạn gói, và hóa đơn.
Trang Usage & Limits của owner tính các thông tin xác thực của tổ chức cùng với thông tin cá nhân của họ, trên tab API keys và tab Proxy users, đồng thời tách biệt hai phần này để thấy rõ chi tiêu đến từ đâu.
Teams
Mỗi tổ chức đều có một nhóm mặc định tên là Everyone. Các khóa mới sẽ tự động được đưa vào nhóm này và mọi người tham gia tổ chức đều được thêm vào, điều này giúp tư cách thành viên cấp quyền truy cập vào các khóa.
Tab Teams liệt kê các nhóm bạn trực thuộc, cùng vai trò của bạn trong từng nhóm, số lượng thành viên, và các khóa nhóm cho phép bạn dùng (Keys you can use). Việc tạo và chỉnh sửa nhóm hiện chưa có trên dashboard.
Liên quan
- Quản lý API Key: Tạo, chuyển giao và quản lý key trong tổ chức
- Người dùng Proxy: Tạo và chuyển giao người dùng proxy trong tổ chức
- Mức sử dụng và Giới hạn: Thành viên nhóm, tổ chức và các quyền hạn trong gói của bạn
- Thanh toán và Gói đăng ký: Cách gói của chủ sở hữu chi trả cho việc sử dụng key của tổ chức
- Tổng quan về Dashboard: Tất cả các phần trên dashboard