Nacos Client访问鉴权

更新时间: 2023-09-01 16:08:09

MSE中的Nacos注册配置中心可以开启鉴权功能,以降低某个实例被恶意用户非法获取或修改的风险。本文介绍如何在MSE上为Nacos实例配置鉴权访问以及如何使用Nacos Client进行鉴权访问。

前提条件

使用说明

本文档内容涉及图中引擎直连链路的访问权限的开启和配置,授权成功后,Nacos Client可以通过RAM用户访问MSE的Nacos。

幻灯片1.JPG
说明

关于引擎管控链路的访问鉴权配置和使用,即为RAM用户授予使用MSE控制台权限的具体操作,请参见注册配置中心授权

开启鉴权

重要
  • 创建的Nacos引擎默认不启用鉴权,Nacos引擎会响应所有请求。此外,Nacos开源控制台的登录功能仅用于记录用户,并没有鉴权拦截请求的能力。您可以参照本文开启鉴权。

  • 开启Nacos鉴权功能之后,无法通过Nacos开源控制台访问Nacos实例,仅支持使用MSE控制台访问该实例。基于阿里云RAM用户体系,MSE控制台支持更细粒度的控制台权限控制。具体操作,请参见注册配置中心授权

  1. 登录MSE注册配置中心管理控制台,并在顶部菜单栏选择地域。

  2. 在左侧导航栏,选择注册配置中心 > 实例列表

  3. 实例列表页面,单击目标实例名称。

  4. 在左侧菜单栏,单击参数设置,然后在参数设置页面单击编辑

  5. 选择ConfigAuthEnabledNamingAuthEnabled参数,在列,单击ConfigAuthEnabledNamingAuthEnabled对应的,然后单击保存并重启实例

    重要

    打开配置中心鉴权或注册中心鉴权开关前,您需要在客户端配置AccessKey,否则将无法获取配置或服务。

    • ConfigAuthEnabled:配置中心鉴权开关。支持基础版1.2.1及以上版本的实例,以及专业版及开发版全版本的实例。

    • NamingAuthEnabled:注册中心鉴权开关。支持专业版或开发版2.0.4及以上版本的实例。

    两个开关分别控制对应模块,互不影响。

为RAM用户配置鉴权

步骤一:创建RAM用户

  1. 使用阿里云账号登录RAM控制台

  2. 在左侧导航栏,选择身份管理 > 用户

  3. 用户页面,单击创建用户

  4. 创建用户页面的用户账号信息区域,设置用户基本信息。

    • 登录名称:可包含英文字母、数字、半角句号(.)、短划线(-)和下划线(_),最多64个字符。

    • 显示名称:最多包含128个字符。

    • 可选:标签:您可以单击edit,然后输入标签键和标签值。为RAM用户绑定标签,便于后续基于标签的用户管理。

    说明

    单击添加用户,可以批量创建多个RAM用户。

  5. 访问方式区域,选择OpenAPI调用访问

    • 控制台访问:设置控制台登录密码、重置密码策略和多因素认证策略。

      说明

      自定义登录密码时,密码必须满足密码复杂度规则。关于如何满足密码复杂度规则,请参见设置RAM用户密码强度

    • OpenAPI调用访问:自动为RAM用户生成访问密钥(AccessKey),支持通过API或其他开发工具访问阿里云。

    说明

    为了保障账号安全,建议仅为RAM用户选择一种登录方式,避免RAM用户离开组织后仍可以通过访问密钥访问阿里云资源。

  6. 单击确定

步骤二:为RAM用户添加权限

说明

该操作将会授予用户所有Nacos实例的配置及服务的读写或只读权限,属于粗粒度授权。关于细粒度授权管理,请参见注册中心细粒度鉴权配置中心细粒度鉴权

  1. 使用阿里云账号登录RAM控制台

  2. 在左侧导航栏,选择身份管理 > 用户

  3. 用户页面,单击目标RAM用户操作列的添加权限

  4. 添加权限面板,为RAM用户添加权限。

    1. 选择授权应用范围。

      • 整个云账号:权限在当前阿里云账号内生效。

      • 指定资源组:权限在指定的资源组内生效。

        说明

        指定资源组授权生效的前提是该云服务已支持资源组。更多信息,请参见支持资源组的云服务

    2. 输入授权主体。

      授权主体即需要授权的RAM用户,系统会自动填入当前的RAM用户。您也可以添加其他RAM用户。

    3. 选择权限策略。

      权限策略名称

      说明

      AliyunMSEFullAccess

      管理微服务引擎MSE的权限,等同于阿里云账号的权限,被授予该权限的RAM用户拥有所有功能的操作权限。

      AliyunMSEReadOnlyAccess

      微服务引擎MSE的只读权限,被授予该权限的RAM用户具有阿里云账号所有资源的只读权限。

      说明

      每次最多绑定5条策略,如需绑定更多策略,请分次操作。

  5. 单击确定

  6. 单击完成

步骤三:客户端(SDK)配置鉴权

AccessKey包括AccessKey ID和AccessKey Secret,需一起使用。Nacos实例开启鉴权后,在使用Nacos客户端时,需要添加对应RAM用户的AccessKey ID和AccessKey Secret,否则无法访问Nacos实例。关于获取AccessKey,请参见创建AccessKey

Java版本的Nacos Client

若您使用的是Java版本的Nacos Client,请按照下列方式配置程序代码。

properties.put(PropertyKeyConst.SERVER_ADDR, "${mseNacos实例域名}");
properties.put(PropertyKeyConst.ACCESS_KEY, "${accessKey}");
properties.put(PropertyKeyConst.SECRET_KEY, "${secretKey}");
NamingService naming = NamingFactory.createNamingService(properties);
ConfigService configService = ConfigFactory.createConfigService(properties);

Spring Cloud Alibaba框架

若您使用的是Spring Cloud Alibaba框架,请在应用配置文件添加下列配置。

## 注册中心
spring.cloud.nacos.discovery.accessKey=${accessKey}
spring.cloud.nacos.discovery.secretKey=${secretKey}

## 配置中心
spring.cloud.nacos.config.accessKey=${accessKey}
spring.cloud.nacos.config.secretKey=${secretKey}

Dubbo框架

若您使用的是Dubbo框架,请在dubbo配置文件的注册中心链接URL中加入下列配置。

dubbo.registry.address=nacos://${mseNacos实例域名}:8848?accessKey=${accessKey}&secretKey=${secretKey}

Go版本的Nacos Client

若您使用的是Go版本的Nacos Client,请按照下列方式配置程序代码。

cc := constant.ClientConfig{
    AccessKey:   "${accessKey}",
    SecretKey:   "${secretKey}"
}

serverConfigs := []constant.ServerConfig{
    {
        IpAddr:      "${mseNacos实例域名}",
        Port:        8848
    }
}

namingClient, err := clients.NewNamingClient(
    vo.NacosClientParam{
        ClientConfig:  &clientConfig,
        ServerConfigs: serverConfigs,
    },
)

configClient, err := clients.NewConfigClient(
    vo.NacosClientParam{
        ClientConfig:  &clientConfig,
        ServerConfigs: serverConfigs,
    },
)

为RAM角色配置鉴权

如果应用程序需要访问开启鉴权的MSE,需要将AccessKey以配置文件的形式或其他形式传递到应用程序中。这在一定程度上增加了AccessKey管理的复杂性以及暴露的风险性。

借助ECS实例或ACK实例的RAM角色,您可以将RAM角色与ECS实例或ACK实例关联起来,然后将RAM角色名称告知Nacos Client,此后无需配置AccessKey即可访问MSE。基于RAM角色,您可以为不同实例设定不同的角色和授权策略,控制访问权限粒度或范围。例如,如果配置只读策略,则关联了该角色的ECS仅可读取MSE的配置和服务,而无法新增或修改MSE配置和服务。更多信息,请参见ECS实例RAM角色授权概述RAM角色概览

说明

使用RAM角色进行鉴权,需要将应用部署到阿里云ECS实例或ACK集群,且ECS实例或ACK集群的网络环境为专用网络VPC。更多信息,请参见什么是云服务器ECS什么是容器服务Kubernetes版什么是专有网络

使用ECS实例访问MSE Nacos

步骤一:创建RAM角色并配置授权策略

  1. 使用阿里云账号登录RAM控制台
  2. 在左侧导航栏,选择身份管理 > 角色
  3. 角色页面,单击创建角色
  4. 创建角色面板,选择可信实体类型为阿里云服务,然后单击下一步
  5. 选择角色类型为普通服务角色
  6. 输入角色名称备注
  7. 选择受信服务。
    说明 可以选择的受信服务请以控制台界面为准。
  8. 单击完成
  9. 角色页面,单击目标RAM角色操作列的添加权限
  10. 添加权限面板,为RAM角色添加权限。

    1. 选择授权应用范围。

      • 整个云账号:权限在当前阿里云账号内生效。

      • 指定资源组:权限在指定的资源组内生效。

        说明

        指定资源组授权生效的前提是该云服务已支持资源组。更多信息,请参见支持资源组的云服务

    2. 输入授权主体。

      授权主体即需要授权的RAM角色,系统会自动填入当前的RAM角色。您也可以添加其他RAM角色。

    3. 选择权限策略。

      权限策略名称

      说明

      AliyunMSEFullAccess

      管理微服务引擎MSE的权限,等同于阿里云账号的权限,被授予该权限的RAM用户拥有所有功能的操作权限。

      AliyunMSEReadOnlyAccess

      微服务引擎MSE的只读权限,被授予该权限的RAM用户具有阿里云账号所有资源的只读权限。

      说明

      若要精确控制访问权限,您需要为角色添加细粒度权限。具体操作,请参见注册中心细粒度鉴权配置中心细粒度鉴权

  11. 单击确定
  12. 单击完成

步骤二:为ECS实例授予该RAM角色

  1. 登录ECS管理控制台

  2. 在左侧导航栏,选择实例与镜像 > 实例

  3. 在顶部菜单栏左上角处,选择地域。

  4. 找到要操作的ECS实例,选择图标 > 实例设置 > 授予/收回RAM角色

  5. 在弹窗中,选择创建好的实例RAM角色,单击确定完成授予。

步骤三:客户端(SDK)配置RAM角色并访问

Java版本的Nacos Client

若您使用的是Java版本的Nacos Client,请按照下列方式配置程序代码。

说明

使用RAM角色进行鉴权需要客户端升级至对应版本。更多信息,请参见Nacos Client鉴权及加解密支持版本

properties.put(PropertyKeyConst.SERVER_ADDR, "${mseNacos实例域名}");
properties.put(PropertyKeyConst.RAM_ROLE_NAME, "${roleName}");
// 注册中心
NamingService naming = NamingFactory.createNamingService(properties);
// 配置中心
ConfigService configService = ConfigFactory.createConfigService(properties);

Spring Cloud Alibaba框架

若您使用的是Spring Cloud Alibaba框架,请在应用配置文件添加下列配置。

说明

需要将Spring Cloud Alibaba框架版本升级至2.2.9.RELEASE及以上版本。

## 注册中心
spring.cloud.nacos.discovery.ramRoleName=${roleName}

## 配置中心
spring.cloud.nacos.config.ramRoleName=${roleName}

Dubbo框架

若您使用的是Dubbo框架,请在dubbo配置文件的注册中心链接URL中加入下列配置。

dubbo.registry.address=nacos://${mseNacos实例域名}:8848?ramRoleName=${roleName}

使用ACK集群访问MSE Nacos

步骤一:找到ACK集群Worker RAM角色

  1. 登录容器服务管理控制台

  2. 在控制台左侧导航栏,单击集群

  3. 集群列表页面,单击目标集群名称或者目标集群右侧操作列下的详情

  4. 集群信息页面,单击集群资源,然后单击Worker RAM 角色右侧的ID进入RAM控制台。

步骤二:为ACK集群Worker RAM角色授予权限

  1. 在左侧导航栏,选择身份管理 > 角色
  2. 权限管理页签,单击权限策略名称下的ID。

    image
  3. 策略内容页签,单击修改策略内容,根据需求添加内容,然后单击确定

    • 为实例授予微服务引擎MSE的管理权限。

      {
          "Action": "mse:*",
          "Resource": "*",
          "Effect": "Allow"
      },
      {
          "Action": "ram:CreateServiceLinkedRole",
          "Resource": "*",
          "Effect": "Allow",
          "Condition": {
              "StringEquals": {
                  "ram:ServiceName": "mse.aliyuncs.com"
              }
          }
      }
    • 为实例授予微服务引擎MSE的只读权限。

      {
          "Action": [
              "mse:Query*",
              "mse:List*",
              "mse:Get*"
          ],
          "Resource": "*",
          "Effect": "Allow"
      },
      {
          "Action": "ram:CreateServiceLinkedRole",
          "Resource": "*",
          "Effect": "Allow",
          "Condition": {
              "StringEquals": {
                  "ram:ServiceName": "mse.aliyuncs.com"
              }
          }
      }
    • 如果需要授予实例细粒度的MSE访问权限,您需要自定义权限策略。更多信息,请参见注册中心细粒度鉴权配置中心细粒度鉴权

      {
      	 // 自定义的权限策略
      },
      {
          "Action": "ram:CreateServiceLinkedRole",
          "Resource": "*",
          "Effect": "Allow",
          "Condition": {
              "StringEquals": {
                  "ram:ServiceName": "mse.aliyuncs.com"
              }
          }
      }

步骤三:客户端(SDK)配置RAM角色并访问

Java版本的Nacos Client

若您使用的是Java版本的Nacos Client,请按照下列方式配置程序代码。

说明

使用RAM角色进行鉴权需要客户端升级至对应版本。更多信息,请参见Nacos Client鉴权及加解密支持版本

properties.put(PropertyKeyConst.SERVER_ADDR, "${mseNacos实例域名}");
properties.put(PropertyKeyConst.RAM_ROLE_NAME, "${roleName}");
// 注册中心
NamingService naming = NamingFactory.createNamingService(properties);
// 配置中心
ConfigService configService = ConfigFactory.createConfigService(properties);
Spring Cloud Alibaba框架

若您使用的是Spring Cloud Alibaba框架,请在应用配置文件添加下列配置。

说明

需要将Spring Cloud Alibaba框架版本升级至2.2.9.RELEASE及以上版本。

## 注册中心
spring.cloud.nacos.discovery.ramRoleName=${roleName}

## 配置中心
spring.cloud.nacos.config.ramRoleName=${roleName}
Dubbo框架

若您使用的是Dubbo框架,请在dubbo配置文件的注册中心链接URL中加入下列配置。

dubbo.registry.address=nacos://${mseNacos实例域名}:8848?ramRoleName=${roleName}

阿里云首页 微服务引擎 MSE 相关技术圈