验证用户访问

本指南介绍如何在 Milvus 中管理用户身份验证，包括启用身份验证、以用户身份连接和修改用户凭证。

启用用户身份验证

...
common:
...
  security:
    authorizationEnabled: false
...

...
extraConfigFiles:
  user.yaml: |+
    common:
      security:
        authorizationEnabled: true
...

apiVersion: milvus.io/v1beta1
kind: Milvus
metadata:
  name: my-release
  labels:
    app: milvus
spec:
  # Omit other fields ...
  config:
    common:
      security:
        authorizationEnabled: true

通过身份验证连接 Milvus

启用身份验证后，需要使用用户名和密码连接到 Milvus。默认情况下，启动 Milvus 时会创建root 用户，密码为Milvus 。下面是一个示例，说明如何使用默认root 用户在启用身份验证后连接 Milvus：

# use default `root` user to connect to Milvus

from pymilvus import MilvusClient

client = MilvusClient(
    uri='http://localhost:19530', # replace with your own Milvus server address
    token="root:Milvus"
) 

创建新用户

以默认root 用户身份连接后，可按以下步骤创建和验证新用户：

# create a user
client.create_user(
    user_name="user_1",
    password="P@ssw0rd",
)

# verify the user has been created

client.describe_user("user_1")

# output
# {'user_name': 'user_1', 'roles': ()}

有关创建用户的更多信息，请参阅create_user()。

使用新用户连接 Milvus

使用新创建用户的凭据进行连接：

# connect to milvus with the newly created user

client = MilvusClient(
    uri="http://localhost:19530",
    token="user_1:P@ssw0rd"
)

更新用户密码

用以下代码更改现有用户的密码：

# update password

client.update_password(
    user_name="user_1",
    old_password="P@ssw0rd",
    new_password="P@ssw0rd123"
)

有关更新用户密码的更多信息，请参阅update_password()。

如果忘记了旧密码，Milvus 提供了一个配置项，允许将某些用户指定为超级用户。这样，重置密码时就不需要旧密码了。

默认情况下，Milvus 配置文件中的common.security.superUsers 字段为空，这意味着所有用户在重置密码时都必须提供旧密码。不过，你可以将特定用户指定为超级用户，他们不需要提供旧密码。在下面的代码段中，root 和foo 被指定为超级用户。

你应该在管理 Milvus 实例运行的 Milvus 配置文件中添加以下配置项。

common:
    security:
        superUsers: root, foo

删除用户

要删除用户，请使用drop_user() 方法。

client.drop_user(user_name="user_1")

列出所有用户

列出所有用户。

# list all users

client.list_users()

限制条件

1. 用户名不得为空，长度不得超过 32 个字符。必须以字母开头，且只能包含下划线、字母或数字。
2. 密码必须至少包含 6 个字符，长度不得超过 256 个字符。

下一步

• 你可能还想了解如何
  • 扩展 Milvus 集群
• 如果您已准备好在云上部署集群：
  • 了解如何使用 Terraform 在亚马逊 EKS 上部署 Milvus
  • 学习如何使用 Kubernetes 在 GCP 上部署 Milvus 集群
  • 了解如何使用 Kubernetes 在 Microsoft Azure 上部署 Milvus