Bỏ qua, đến phần nội dung

SSO của tổ chức (OIDC) ​

Với đăng nhập một lần (SSO), mọi người đăng nhập Tara bằng nhà cung cấp danh tính của công ty (Okta, Microsoft Entra ID, Keycloak hay bất kỳ nhà cung cấp OpenID Connect nào). Bạn cài từ Settings › SSO, và việc này do bạn tự làm, không cần nhân viên PhillipCLI. Owner và Admin làm được.

Sau đó mọi người chọn Sign in with SSO ở trang đăng nhập rồi nhập slug tổ chức, email công việc hoặc tên miền email. Trên terminal, chạy ph login --sso <org>.

Trang này dành cho tổ chức của bạn trên dịch vụ dùng chung. Nếu bạn tự chạy Tara và muốn một nhà cung cấp cho cả bản cài, xem Đăng nhập SSO (OIDC).

Cài đặt ​

  1. Ở nhà cung cấp, tạo một ứng dụng OIDC loại web (confidential), rồi đăng ký callback URL: https://tara.phillipcli.cloud/auth/sso/<org>/callback, trong đó <org> là slug tổ chức của bạn.
  2. Trong Tara, mở Settings › SSO và dán issuer, client ID và client secret. Tara lấy cấu hình và khóa ký của nhà cung cấp trước, nếu lỗi thì không lưu gì.
  3. Chạy test. Test phải thành công thì bạn mới bắt buộc SSO được.
  4. Chọn role cho người đăng nhập lần đầu: Viewer, Member hoặc không ai (không bao giờ là Admin hay Owner).
  5. Nếu muốn, bật Require SSO.
Settings › SSO đi qua đúng các bước này, từ trên xuống.

Secret được lưu mã hóa và không bao giờ hiện lại. Tara chỉ cho biết secret đã có.

Okta ​

Tạo ứng dụng OIDC - OpenID Connect loại Web Application, đặt callback ở trên làm sign-in redirect URI. Gán ứng dụng cho những người hoặc nhóm được đăng nhập. Issuer là domain Okta của bạn, hoặc địa chỉ authorization server nếu bạn dùng bản tự đặt: https://<your-company>.okta.com hay https://<your-company>.okta.com/oauth2/default.

Microsoft Entra ID ​

Trong App registrations, tạo một registration, thêm redirect URI loại Web là callback ở trên, và tạo client secret ở Certificates & secrets. Issuer là https://login.microsoftonline.com/<tenant-id>/v2.0. Client ID là Application (client) ID. Ở Enterprise applications, bạn giới hạn được ai đăng nhập.

Keycloak ​

Tạo client loại OpenID Connect, bật Client authentication và chỉ bật standard flow. Điền callback vào Valid redirect URIs. Issuer là https://<keycloak>/realms/<realm> (Keycloak trước bản 17 có thêm /auth). Lấy secret ở Credentials. Người dùng phải có địa chỉ email.

Dùng nhà cung cấp chỉ có SAML, AD FS hoặc Google Workspace? Xem Dùng nhà cung cấp SAML qua OIDC.

Trên terminal, các bước tương tự là:

bash
echo "$CLIENT_SECRET" | ph org sso set --issuer https://sso.example.com/realms/acme \
  --client-id tara --client-secret-stdin --jit-role member --enable
ph org sso test
ph org sso

ph org sso cho bạn thấy issuer, callback URL cần đăng ký, kết quả test và việc SSO có đang bắt buộc không.

Ai vào và với role nào ​

Lần đầu ai đó đăng nhập qua nhà cung cấp của bạn, Tara thêm họ vào tổ chức với role bạn đã chọn (Viewer, Member hoặc không ai). Tara tôn trọng giới hạn seat (Viewer miễn phí), không đổi role của người đã là thành viên, và không đưa lại người Admin đã gỡ. Muốn cấp role cao hơn, bạn đổi trong Members.

Bắt buộc SSO ​

Bạn bật khi test đã qua và có tên miền đã xác minh. Từ đó, thành viên có email đã xác minh (GitHub, Google hoặc link email) thuộc tên miền đã xác minh của bạn phải vào qua SSO. Với tổ chức của bạn, họ nhận lỗi sso_required và Portal chuyển họ sang SSO. Không gian cá nhân và các tổ chức khác của họ vẫn dùng bình thường. Nếu bạn đổi issuer, client ID hay secret, Tara tự tắt bắt buộc cho đến khi bạn test lại.

Owner luôn được miễn. Nếu nhà cung cấp hỏng, một Owner đăng nhập theo cách thường rồi tắt: ph org sso enforce off.

Người đã có tài khoản liên kết một lần, bằng Link my account trong Settings › SSO (Portal tự đề nghị khi chuyển họ sang SSO). Sau đó SSO mở đúng tài khoản có sẵn, không tạo tài khoản mới.

Phiên SSO có quyền gì ​

Nhà cung cấp danh tính do tổ chức bạn nắm, nên Tara thận trọng với những gì nó khai.

  • Phiên SSO chỉ thấy tổ chức của bạn. Nó không mở được các tổ chức khác của người đó.
  • Không ghi vào kho cá nhân. Phiên, phiên CLI hay token đi qua nhà cung cấp của bạn không đăng, gửi, nhập, đóng góp, đổi phạm vi hay ngừng hỗ trợ được tài nguyên nào trong kho cá nhân của người đó. Tara trả sso_session_personal. Muốn sửa tài nguyên cá nhân, bạn đăng nhập bằng GitHub, Google hoặc email. Đọc thì vẫn được.
  • Token chỉ cho tổ chức của bạn. Phiên này chỉ tạo được token cho tổ chức của bạn, và không liên kết thêm nhà cung cấp khác.
  • Không bao giờ liên kết theo email. Email mà danh tính SSO khai không gộp vào tài khoản có sẵn, và không được coi là đã xác minh. Xem Các cách đăng nhập.

Nếu Tara không nối được nhà cung cấp, hãy kiểm tra issuer là địa chỉ https công khai. Tara từ chối địa chỉ riêng và địa chỉ nội bộ.

Cấp phát người dùng bằng SCIM ​

SSO quyết định ai đăng nhập được. Muốn nhà cung cấp danh tính của bạn còn tự tạo, khóa, gỡ người và đặt role theo nhóm, dùng SCIM 2.0: Okta hoặc Microsoft Entra ID. SCIM không đăng nhập thay ai nên vẫn cần SSO. SCIM nằm trong gói Enterprise.

Gỡ SSO ​

Chạy ph org sso remove --yes. Mọi người không đăng nhập qua nhà cung cấp của bạn được nữa, và Require SSO tự tắt. Thành viên vẫn giữ tư cách thành viên và các cách đăng nhập khác.

Đọc thêm ​