Active Directory / LDAP 存取管理

MinIO 支援設定單一 Active Directory 或 LDAP (AD/LDAP) 服務，用於外部管理使用者身分。啟用 AD/LDAP 外部身分管理會停用 MinIO 內部 IDP。

對於由外部 AD/LDAP 提供者管理的身分，MinIO 使用使用者的辨別名稱，並嘗試將其對應到現有的原則。

如果 AD/LDAP 設定包含查詢使用者 AD/LDAP 群組成員資格的必要設定，MinIO *也會* 使用這些群組辨別名稱，並嘗試將每個名稱對應到現有的原則。

MinIO 預設拒絕存取所有未經使用者指派或繼承的原則明確允許的動作或資源。由 AD/LDAP 提供者管理的使用者必須指定必要的原則作為使用者設定檔資料的一部分。如果沒有任何原則符合使用者 DN 或群組 DN，MinIO 會封鎖對部署上所有動作和資源的存取。

MinIO 發出以驗證使用者身分並擷取其群組成員資格的特定 AD/LDAP 查詢，會在使用 Active Directory / LDAP 身分管理部署叢集時進行設定。此頁面涵蓋建立 MinIO 原則以符合可能傳回的辨別名稱。

驗證和授權流程

使用 Active Directory / LDAP 憑證的應用程式的登入流程如下

將 AD/LDAP 憑證指定給 MinIO 安全性權杖服務 (STS) AssumeRoleWithLDAPIdentity API 端點。
MinIO 會根據 AD/LDAP 伺服器驗證提供的憑證。
MinIO 會檢查是否有任何原則的名稱與使用者辨別名稱 (DN) 相符，並將該原則指派給已驗證的使用者。

如果設定為執行群組查詢，MinIO 也會查詢使用者所屬的 AD/LDAP 群組清單。MinIO 會檢查是否有任何原則的名稱與傳回的群組 DN 相符，並將該原則指派給已驗證的使用者。
MinIO 會以存取金鑰、秘密金鑰和工作階段權杖的形式在 STS API 回應中傳回暫時憑證。憑證具有與名稱符合已驗證的使用者 DN *或* 群組 DN 的原則相符的權限。

MinIO 提供一個範例 Go 應用程式 ldap.go，可處理完整的登入流程。

AD/LDAP 使用者可以選擇建立與其 AD/LDAP 使用者辨別名稱相關聯的存取金鑰。存取金鑰是長期存在的憑證，其權限繼承自父使用者。父使用者可以在建立存取金鑰時進一步限制這些權限。使用以下任一方法建立新的存取金鑰

使用 AD/LDAP 管理的使用者憑證登入 MinIO 主控台。
在使用者區段中，選取存取金鑰，然後選取建立存取金鑰 +。
使用 mc admin user svcacct add 命令來建立存取金鑰。指定使用者辨別名稱作為要關聯存取金鑰的使用者名稱。

將政策對應至使用者 DN

下列命令使用 mc idp ldap policy attach，將現有的 MinIO 政策與 AD/LDAP 使用者 DN 關聯起來。

mc idp ldap policy attach myminio consoleAdmin \
  --user='cn=sisko,cn=users,dc=example,dc=com'

mc idp ldap policy attach myminio readwrite,diagnostics \
  --user='cn=dax,cn=users,dc=example,dc=com'

MinIO 會將與 cn=sisko,cn=users,dc=example,dc=com 相符的已驗證使用者指派 consoleAdmin 政策，授予對 MinIO 伺服器的完整存取權。
MinIO 會將與 cn=dax,cn=users,dc=example,dc=com 相符的已驗證使用者指派 readwrite 和 diagnostics 政策，授予對 MinIO 伺服器的基本讀寫存取權，並授予診斷管理操作的存取權。
MinIO 不會對與 cn=quark,cn=users,dc=example,dc=com 相符的已驗證使用者指派任何政策，並拒絕所有 API 操作的存取權。

將政策對應至群組 DN

下列命令使用 mc idp ldap policy attach，將現有的 MinIO 政策與 AD/LDAP 群組 DN 關聯起來。

mc idp ldap policy attach myminio consoleAdmin \
  --group='cn=ops,cn=groups,dc=example,dc=com'

mc idp ldap policy attach myminio diagnostics \
  --group='cn=engineering,cn=groups,dc=example,dc=com'

MinIO 會將 cn=ops,cn=groups,dc=example,dc=com AD/LDAP 群組中的任何已驗證使用者指派 consoleAdmin 政策，授予對 MinIO 伺服器的完整存取權。
MinIO 會將 cn=engineering,cn=groups,dc=example,dc=com AD/LDAP 群組中的任何已驗證使用者指派 diagnostics 政策，授予對診斷管理操作的存取權。