鉴权
服务端如何开启鉴权
非Docker环境
按照官方文档配置启动,默认是不需要登录的，这样会导致配置中心对外直接暴露。而启用鉴权之后，需要在使用用户名和密码登录之后，才能正常使用nacos。
开启鉴权之前，application.properties中的配置信息为：
代码语言：javascript复制### If turn on auth system:
nacos.core.auth.enabled=false开启鉴权之后，application.properties中的配置信息为：
代码语言：javascript复制### If turn on auth system:
nacos.core.auth.system.type=nacos
nacos.core.auth.enabled=true注意：鉴权开关是修改之后立马生效的，不需要重启服务端。
Docker环境
官方镜像
如果使用官方镜像，请在启动docker容器时，添加如下环境变量
代码语言：javascript复制NACOS_AUTH_ENABLE=true例如，可以通过如下命令运行开启了鉴权的容器:
代码语言：javascript复制docker run --env PREFER_HOST_MODE=hostname --env MODE=standalone --env NACOS_AUTH_ENABLE=true -p 8848:8848 nacos/nacos-server除此之外，还可以添加其他鉴权相关的环境变量信息：
name | description | option |
|---|---|---|
NACOS_AUTH_ENABLE | 是否开启权限系统 | 默认:false |
NACOS_AUTH_TOKEN_EXPIRE_SECONDS | token 失效时间 | 默认:18000 |
NACOS_AUTH_TOKEN | token | 默认:SecretKey012345678901234567890123456789012345678901234567890123456789 |
NACOS_AUTH_CACHE_ENABLE | 权限缓存开关 ,开启后权限缓存的更新默认有15秒的延迟 | 默认 : false |
然后运行docker-compose构建命令,例如
代码语言：javascript复制docker-compose -f example/standalone-derby.yaml up自定义镜像
如果选择自定义镜像，请在构建镜像之前，修改nacos工程中的application.properties文件，
将下面这一行配置信息
代码语言：javascript复制nacos.core.auth.enabled=false修改为
代码语言：javascript复制nacos.core.auth.system.type=nacos
nacos.core.auth.enabled=true然后再配置nacos启动命令。
客户端如何进行鉴权
Java SDK鉴权
在构建“Properties”类时,需传入用户名和密码。
代码语言：javascript复制properties.put("username","${username}");
properties.put("password","${password}");示例代码
代码语言：javascript复制try {
// Initialize the configuration service, and the console automatically obtains the following parameters through the sample code.
String serverAddr = "{serverAddr}";
Properties properties = new Properties();
properties.put("serverAddr", serverAddr);
// if need username and password to login
properties.put("username","nacos");
properties.put("password","nacos");
ConfigService configService = NacosFactory.createConfigService(properties);
} catch (NacosException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}Open-API鉴权
首先需要使用用户名和密码登陆nacos。
代码语言：javascript复制curl -X POST '127.0.0.1:8848/nacos/v1/auth/login' -d 'username=nacos&password=nacos'若用户名和密码正确,返回信息如下:
代码语言：javascript复制{"accessToken":"eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJuYWNvcyIsImV4cCI6MTYwNTYyOTE2Nn0.2TogGhhr11_vLEjqKko1HJHUJEmsPuCxkur-CfNojDo","tokenTtl":18000,"globalAdmin":true}接下来进行配置信息或服务信息时,应当使用该accessToken鉴权,在url后添加参数accessToken={accessToken},其中{accessToken}为登录时返回的token信息，例如
代码语言：javascript复制curl -X GET '127.0.0.1:8848/nacos/v1/cs/configs?accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJuYWNvcyIsImV4cCI6MTYwNTYyMzkyM30.O-s2yWfDSUZ7Svd3Vs7jy9tsfDNHs1SuebJB4KlNY8Q&dataId=nacos.example.1&group=nacos_group'curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJuYWNvcyIsImV4cCI6MTYwNTYyMzkyM30.O-s2yWfDSUZ7Svd3Vs7jy9tsfDNHs1SuebJB4KlNY8Q&port=8848&healthy=true&ip=11.11.11.11&weight=1.0&serviceName=nacos.test.3&encoding=GBK&namespaceId=n1'开启服务身份识别功能
开启鉴权功能后，服务端之间的请求也会通过鉴权系统的影响。考虑到服务端之间的通信应该是可信的，因此在1.2~1.4.0版本期间，通过User-Agent中是否包含Nacos-Server来进行判断请求是否来自其他服务端。
但这种实现由于过于简单且固定，导致可能存在安全问题。因此从1.4.1版本开始，Nacos添加服务身份识别功能，用户可以自行配置服务端的Identity，不再使用User-Agent作为服务端请求的判断标准。
开启方式:
代码语言：javascript复制### 开启鉴权
nacos.core.auth.enabled=true
### 关闭使用user-agent判断服务端请求并放行鉴权的功能
nacos.core.auth.enable.userAgentAuthWhite=false
### 配置自定义身份识别的key（不可为空）和value（不可为空）
nacos.core.auth.server.identity.key=example
nacos.core.auth.server.identity.value=example 所有集群均需要配置相同的server.identity信息，否则可能导致服务端之间数据不一致或无法删除实例等问题。
旧版本升级 考虑到旧版本用户需要升级，可以在升级期间，开启
nacos.core.auth.enable.userAgentAuthWhite=true功能，待集群整体升级到1.4.1并稳定运行后，再关闭此功能。这样做可以保证旧版本用户在升级过程中的正常使用，并且在升级完成后保证系统的安全性。开启nacos.core.auth.enable.userAgentAuthWhite=true功能可以允许通过User-Agent头部鉴别身份，来保护系统免受恶意攻击。同时，关闭此功能也可以减少系统的运行成本和维护复杂度。因此，在升级过程中，我们应该根据实际情况来配置相关的参数，并且及时关闭不必要的功能。这样才能确保系统的高可用性和稳定性。
