Hub documentation

Tài khoản dịch vụ

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Tài khoản dịch vụ

Tính năng này là một phần của các gói Enterprise và Enterprise Plus.

Tài khoản dịch vụ là các danh tính thuộc sở hữu của tổ chức, được thiết kế để truy cập theo chương trình vào các tài nguyên của tổ chức bạn, chẳng hạn như các pipeline CI/CD, các script tự động hóa và các tích hợp backend. Khác với tài khoản thành viên cá nhân, tài khoản dịch vụ không gắn liền với một cá nhân cụ thể: nó thuộc về tổ chức và được quản lý bởi các quản trị viên của tổ chức đó.

Vì tài khoản dịch vụ được tách biệt khỏi bất kỳ cá nhân nào, nó giúp các quy trình tự động tiếp tục hoạt động ngay cả khi nhân sự gia nhập hoặc rời khỏi tổ chức, đồng thời cho phép bạn giới hạn phạm vi và xoay vòng thông tin xác thực mà không ảnh hưởng đến token cá nhân của bất kỳ thành viên nào.

Tạo tài khoản dịch vụ

Với tư cách là quản trị viên tổ chức, hãy chuyển đến phần Service Accounts trong cài đặt tổ chức của bạn để tạo và quản lý các tài khoản dịch vụ.

Creating a new service account from the organization settings.

Khi tạo tài khoản dịch vụ, bạn cung cấp:

  • Một name để xác định tài khoản dịch vụ.
  • Một description tùy chọn để ghi chú mục đích sử dụng của tài khoản dịch vụ.

Tài khoản dịch vụ không có mật khẩu và không thể đăng nhập tương tác — chúng chỉ được truy cập thông qua các access token mà bạn cấp cho chúng. Khác với người dùng thông thường, tài khoản dịch vụ cũng không có trang hồ sơ HF, không nằm trong danh sách thành viên của tổ chức và chỉ được quản lý thông qua cài đặt Service Accounts.

Tài khoản dịch vụ không thể được thêm vào Resource Groups, kể cả thông qua tính năng tham gia tự động. Để hạn chế các kho mà tài khoản dịch vụ có thể truy cập, hãy giới hạn phạm vi các token truy cập của nó (xem bên dưới).

Quản lý token truy cập

Quyền truy cập của tài khoản dịch vụ vào tổ chức của bạn được xác định hoàn toàn bởi các token truy cập chi tiết mà bạn cấp cho nó. Với mỗi token, bạn chọn một tên và một bộ quyền chi tiết, nhờ đó chỉ cấp quyền truy cập cần thiết cho một quy trình làm việc cụ thể.

Quyền có thể được cấp ở hai cấp độ:

  • Trên toàn tổ chức — áp dụng một quyền (ví dụ: quyền đọc hoặc ghi nội dung kho) cho tất cả các kho trong tổ chức.
  • Theo từng kho — giới hạn quyền đọc hoặc ghi chỉ cho các kho cụ thể. Tìm và chọn các kho mà token sẽ áp dụng, sau đó chọn các quyền cần cấp. Bạn có thể chọn các kho do tổ chức sở hữu và các kho có cổng kiểm soát bên ngoài tổ chức mà tài khoản dịch vụ đã được cấp quyền truy cập.

Điều này cho phép bạn phát hành các token có phạm vi hạn hẹp — chẳng hạn, một token chỉ có thể đọc một kho lưu trữ model duy nhất — thay vì cấp quyền truy cập vào toàn bộ tổ chức.

Token cũng có thể được cho phép làm việc với các kho có kiểm soát bên ngoài tổ chức của bạn, trong phần Kho có kiểm soát của biểu mẫu token:

  • Đọc nội dung các kho có cổng mà tài khoản dịch vụ có quyền truy cập — đọc các kho có cổng sau khi tài khoản dịch vụ được cấp quyền truy cập.
  • Yêu cầu quyền truy cập các kho có kiểm soát — cho phép token gửi yêu cầu truy cập các kho có kiểm soát thay mặt cho tài khoản dịch vụ.

Để cấp cho một token quyền truy cập vào một số kho có kiểm soát nhất định, hãy bỏ chọn Read contents of gated repos the service account has access to và chọn từng kho riêng lẻ trong phần quyền theo từng kho.

Creating a new access token with fine-grained permissions for a service account.

Từ trang tài khoản dịch vụ, quản trị viên có thể:

  • Tạo một token truy cập mới với tên đã chọn và các quyền chi tiết.
  • Cập nhật tên hoặc quyền của một token hiện có.
  • Quay vòng một token để thay thế nó bằng một giá trị mới. Token trước đó sẽ ngừng hoạt động ngay lập tức, điều này hữu ích nếu thông tin xác thực có thể đã bị lộ.
  • Xóa một token để thu hồi quyền truy cập của nó vĩnh viễn.

Token tài khoản dịch vụ không cần được phê duyệt theo chính sách token “Yêu cầu phê duyệt của quản trị viên”. Chúng có thể truy cập các tài nguyên của tổ chức của bạn ngay khi được tạo.

Tương tự như token truy cập cá nhân, token tài khoản dịch vụ sẽ hết hạn sau một năm không được sử dụng. Quản trị viên tổ chức sẽ nhận được email nhắc nhở 30 ngày trước đó, và token sẽ hiển thị huy hiệu Expires trên trang của tài khoản dịch vụ. Để giữ token, hãy sử dụng nó trước ngày đó. Token đã hết hạn sẽ hiển thị huy hiệu Invalidated và ngừng hoạt động. Hãy xoay vòng chúng để lấy giá trị mới, sau đó bạn sẽ cần cập nhật giá trị này ở mọi nơi mà token được sử dụng.

Token truy cập chỉ được hiển thị một lần, vào thời điểm nó được tạo hoặc xoay vòng. Hãy lưu trữ nó một cách an toàn — bạn không thể truy xuất lại sau đó. Nếu bạn làm mất nó, hãy xoay vòng token để tạo ra một giá trị mới.

Tạo thông tin xác thực S3

Token tài khoản dịch vụ có thể được sử dụng để truy cập Storage Buckets của tổ chức bạn thông qua S3-compatible API. Gateway xác thực bằng các khóa truy cập theo phong cách AWS được suy ra từ token tài khoản dịch vụ.

  1. Trang tới trang của tài khoản dịch vụ. Tạo token bằng nút Tạo token mới nếu bạn chưa có token nào. Quyền của token sẽ trở thành quyền của thông tin xác thực S3.

  2. Tìm token trong danh sách, mở menu thả xuống của nó và chọn Generate S3 credentials.

    Generate S3 credentials option in service account token's dropdown menu
  3. Sao chép access key ID (có tiền tố HFAK…) và secret access key đã được tạo ra vào một nơi an toàn — secret chỉ được hiển thị một lần. Nếu bạn làm mất nó, hãy sử dụng Invalidate and refresh S3 credentials để tạo một cặp mới. Access key trước đó sẽ ngừng hoạt động ngay lập tức.

Thông tin xác thực S3 kế thừa các quyền của token truy cập cơ bản. Hãy giới hạn phạm vi của token chỉ cho các bucket mà bạn dự định sử dụng.

Sử dụng Revoke S3 credentials để vô hiệu hóa cặp mà không xóa token — việc xóa token (hoặc tài khoản dịch vụ) cũng sẽ thu hồi thông tin xác thực S3 của nó. Trang của tài khoản dịch vụ hiển thị access key ID hiện đang được ghép cặp với từng token.

Sử dụng tên tổ chức của bạn làm <namespace> trong URL endpoint (xem Cấu hình Client). Việc tạo và thu hồi thông tin xác thực S3 được ghi lại trong Audit Logs của tổ chức.

Nếu một token có miễn trừ Bảo mật Mạng được bật, chỉ quản trị viên tổ chức mới có thể tạo thông tin xác thực S3 cho token đó.

Miễn trừ Bảo mật Mạng

Tùy chọn này là một phần của gói Enterprise Plus.

Nếu tổ chức của bạn sử dụng cài đặt Network Security, token của tài khoản dịch vụ sẽ chịu sự ràng buộc của chúng giống như bất kỳ thông tin xác thực nào khác: chúng chỉ hoạt động từ các dải IP của tổ chức bạn, và Content Access Policy sẽ áp dụng cho những gì chúng có thể truy cập.

Một số quy trình tự động chạy bên ngoài mạng doanh nghiệp của bạn — chẳng hạn như một tác vụ CI do nhà cung cấp đám mây lưu trữ. Đối với những trường hợp đó, bạn có thể miễn trừ một token riêng lẻ khỏi việc thực thi Bảo mật Mạng của tổ chức bằng tùy chọn Bypass IP restrictions and the Content Access Policy trong biểu mẫu token.

Khi được bật:

  • Token hoạt động từ bất kỳ địa chỉ IP nào, ngay cả khi Hạn chế quyền truy cập tổ chức chỉ vào các dải IP của bạn đang được bật.
  • Token có thể truy cập nội dung mà Chính sách Truy cập Nội dung của tổ chức bạn sẽ chặn nếu không có token này.
  • Miễn trừ chỉ áp dụng cho cài đặt Bảo mật Mạng của tổ chức của bạn. Nó không bao giờ bỏ qua chính sách của tổ chức khác.
  • Token được liệt kê với huy hiệu Không có hạn chế IP trên trang của tài khoản dịch vụ.
  • Việc xoay token giữ nguyên quyền miễn trừ.

Chỉ quản trị viên tổ chức mới có thể kích hoạt ngoại lệ hoặc xoay vòng token đã được miễn trừ.

Vì token miễn trừ không còn được bảo vệ bởi ranh giới mạng của bạn, chính token đó trở thành thông tin xác thực duy nhất bảo vệ các tài nguyên mà nó có thể truy cập. Chúng tôi khuyến nghị giới hạn phạm vi của nó xuống bộ kho mã nhỏ nhất có thể, cấp quyền chỉ đọc khi điều đó là đủ, và xoay vòng token thường xuyên.

Hóa đơn

Tài khoản dịch vụ không được tính là thành viên chịu phí của tổ chức bạn, do đó việc tạo chúng không tiêu tốn một chỗ trả phí trong gói của bạn.

Update on GitHub