文件

外部身分管理

MinIO 透過以下身分提供者 (IDP) 支援多個外部身分管理員

以下教學提供特定 IDP 軟體的具體指引

使用者可以使用其外部管理憑證和相關的 安全性權杖服務 (STS) API 來針對 MinIO 進行身份驗證。完成身份驗證後,MinIO 會嘗試將使用者與一或多個已設定的 原則 建立關聯。沒有關聯原則的使用者在 MinIO 部署上沒有任何權限。

OpenID Connect (OIDC)

MinIO 支援使用與 OpenID Connect (OIDC) 相容的身分提供者 (IDP),例如 Okta、KeyCloak、Dex、Google 或 Facebook,來進行使用者身分的外部管理。設定外部 IDP 啟用單一登入工作流程,其中應用程式在存取 MinIO 之前會先針對外部 IDP 進行身份驗證。

MinIO 使用 基於原則的存取控制 (PBAC) 來定義已驗證的使用者可以存取的操作和資源。MinIO 支援建立和管理外部管理使用者可以聲明的 原則

對於由外部 OpenID Connect (OIDC) 相容提供者管理的身分,MinIO 使用 JSON Web 權杖宣告來識別要指派給已驗證使用者的 原則

MinIO 預設會尋找 policy 宣告,並讀取要指派的一或多個原則的清單。MinIO 會嘗試將現有原則與 JWT 宣告中指定的原則進行比對。如果 MinIO 部署上不存在任何指定的原則,MinIO 會拒絕該使用者發出的任何和所有操作的授權。例如,考慮一個具有以下鍵值指派的宣告

policy="readwrite_data,read_analytics,read_logs"

指定的原則宣告會指示 MinIO 將名稱與 readwrite_dataread_analyticsread_logs 匹配的原則附加到已驗證的使用者。

您可以使用 MINIO_IDENTITY_OPENID_CLAIM_NAME 環境變數設定自訂原則宣告,使用 mc admin config set 來設定 identity_openid claim_name 設定。

如需有關將 MinIO 原則對應至 OIDC 管理身分的更多資訊,請參閱 OpenID Connect 存取管理

您可以使用 JWT 除錯工具來解碼傳回的 JWT 權杖,並驗證使用者屬性是否包含指定的宣告。如需有關 JWT 宣告的更多資訊,請參閱 RFC 7519:JWT 宣告。請參閱您偏好的 OIDC 提供者的文件,以取得有關設定使用者宣告的指示。

Active Directory / LDAP

MinIO 支援使用 Active Directory 或 LDAP (AD/LDAP) 服務來進行使用者身分的外部管理。設定外部身分提供者 (IDP) 可啟用單一登入 (SSO) 工作流程,其中應用程式在存取 MinIO 之前會先針對外部 IDP 進行身份驗證。

查詢 Active Directory / LDAP 服務

MinIO 會查詢已設定的 Active Directory / LDAP 伺服器,以驗證應用程式指定的憑證,並選擇性地傳回使用者所屬的群組清單。這個稱為「Lookup-Bind 模式」的流程,會使用一個具有最低權限的 AD/LDAP 使用者,其權限僅足以與 AD/LDAP 伺服器進行使用者和群組查詢的身份驗證。

以下標籤頁提供了啟用 Lookup-Bind 模式所需的環境變數和配置設定的參考。

AD/LDAP 管理身分的存取控制

MinIO 使用基於策略的存取控制 (PBAC)來定義已驗證使用者可以存取的操作和資源。當使用 Active Directory/LDAP 伺服器進行身分管理(身份驗證)時,MinIO 通過 PBAC 維持對存取(授權)的控制。

當使用者使用其 AD/LDAP 憑證成功通過 MinIO 的身份驗證時,MinIO 會搜尋所有明確與該使用者辨別名稱 (DN) 相關聯的策略。具體來說,策略必須使用 mc idp ldap policy attach 命令分配給具有相符 DN 的使用者。

MinIO 也支援查詢使用者的 AD/LDAP 群組成員資格。 MinIO 會嘗試將現有策略與使用者每個群組的 DN 進行比對。已驗證使用者的完整權限集,由其明確分配和群組繼承的策略組成。有關更多資訊,請參閱群組查詢

MinIO 使用預設拒絕行為,如果使用者沒有明確分配或群組繼承的策略,則無法存取 MinIO 部署上的任何資源。

MinIO 提供用於基本存取控制的內建策略。您可以使用 mc admin policy create 命令建立新的策略。

群組查詢

MinIO 支援查詢 Active Directory / LDAP 伺服器,以取得已驗證使用者所屬的群組清單。 MinIO 會嘗試將現有的策略與每個群組 DN 進行比對,並將每個符合的策略分配給已驗證的使用者。

以下標籤頁提供了啟用群組查詢所需的環境變數和配置設定的參考

請參閱Active Directory / LDAP 設定參考文件,以取得有關這些變數的更多資訊。 使用 Active Directory / LDAP 配置 MinIO 進行身份驗證教學包含設定這些值的完整說明。

請參閱 identity_ldap 參考文件,以取得有關這些設定的更多資訊。使用 Active Directory / LDAP 配置 MinIO 進行身份驗證教學包含設定這些值的完整說明。