文档首页/ 数据加密服务 DEW/ 最佳实践/ 凭据管理/ 如何使用凭据管理服务自动轮转安全密码
更新时间:2024-08-05 GMT+08:00
分享

如何使用凭据管理服务自动轮转安全密码

本文介绍如何通过函数工作流和凭据管理服务,定期生成和轮转强安全密码,以满足用户安全合规的密码生成、托管、以及定期自动轮换的要求。

使用流程

图1 轮转密码流程

流程说明如下:

  1. 定时触发器到期后,会发布定时触发事件。
  2. 函数工作流接收到事件后,会生成新的随机密码,替换凭据模板内容中的占位符,随后将替换后的内容作为新版本存入凭据中。
  3. 应用程序定期通过调用API/SDK获取最新凭据版本。
  4. 凭据管理服务检索并解密凭据密文,将凭据中保存的信息通过凭据管理API安全地返回到应用程序中。
  5. 应用程序获取到解密后的凭据明文信息,使用新密码更新目标对象(数据库、服务器等),使新密码生效,后续使用新密码对目标对象进行访问。

约束条件

  • 区域已上线凭据管理服务(CSMS)。
  • 区域已上线函数工作流服务(FunctionGraph)。

创建委托

  1. 登录管理控制台
  2. 单击页面左侧的,选择管理与监管 > 统一身份认证服务,进入用户界面。
  3. 在左侧导航栏选择“委托”, 进入委托页面。
  4. 单击“创建委托”,进入“创建委托”页面,如图 创建委托所示,填写参数,参数说明如表 创建委托参数说明所示。

    图2 创建委托
    表1 创建委托参数说明

    参数

    配置说明

    委托名称

    可自定义。

    委托类型

    选择“云服务”

    云服务

    选择“FunctionGraph”

    持续时间

    由函数使用场景决定。如函数需要长时间执行,推荐选择“永久”

    描述

    自定义。

  5. 单击“下一步”,进入委托授权界面。
  6. 勾选需要授权函数工作流的“CSMS FullAccess”“KMS CMKFullAccess”权限。

    图3 选择授权权限

  7. 单击“下一步”,根据业务需要选择授权范围。

    图4 选择授权范围

  8. 单击“确定”,委托创建成功。

创建密码轮转函数

  1. 登录管理控制台
  2. 单击页面左侧的,选择计算 > 函数工作流,进入函数工作流界面。
  3. 单击页面右上角的“创建函数”,进入创建函数页面,如图 创建函数所示,填写参数,参数说明如表 基本信息参数配置所示。

    图5 创建函数
    表2 基本信息参数配置

    参数

    配置说明

    区域

    选择函数部署的区域。

    项目

    选择函数部署的项目。

    函数名称

    自定义函数名称。

    委托名称

    选择创建委托的委托名称。

    企业项目

    如果您已开通企业项目,选择需要添加函数的企业项目即可。

    如果您未开通企业项目,控制台默认不显示“企业项目”,可直接跳过该参数。如需开通企业项目,请参考如何开通企业项目/企业多账号

    运行时

    选择用来编写函数的语言,当前支持使用Python进行代码配置。

    说明:

    仅支持使用Python 3.6、3.9、3.10版本。

  4. 单击“创建函数”,进入函数配置界面。
  5. 单击“设置”页签,在左侧导航栏单击“环境变量”。单击“添加环境变量”,在变量配置行添加环境变量,参数说明如表 基本信息参数配置所示。添加完成后单击“保存”

    表3 环境变量配置

    参数

    配置说明

    示例

    region

    项目名称,比如北京四对应:cn-north-4。单击页面右上角用户名,在下拉框中选择我的凭证,即可查看region信息。

    cn-north-4

    secret_name

    待轮转的凭据名称。

    说明:

    需提前完成创建凭据操作。具体请参见创建凭据

    rds-functionGraph-rotate

    secret_content

    指定的凭据模板内容,需用{}指定,比如:{"password":"password_placeholder"}其中password_placeholder为占位符,函数执行后会将password_placeholder替换为生成的安全密码,并将替换后的内容整体存入凭据中。

    说明:

    当凭据模板内容中存在多个占位符时,会生成多个密码并依次进行替换。

    {"password":"password_placeholder"}

    password_length

    密码长度,可选范围8-128,默认为16。

    16

    password_format

    密码格式,共支持四种,可选,默认为2:

    1. 包含数字和字母;

    2. 包含数字、字母和特殊字符(~!@#%^*-_=+?);

    3. 只包含数字;

    4. 只包含字母。

    2

  6. 单击“代码”页签,并在编辑窗口中添加如下密码轮转函数,完成后单击“部署”。

    # -*- coding:utf-8 -*-
    import json
    import secrets
    import string
    import requests
    import inspect
     
    def handler (event, context):
        global secret_content
        global password_length
        global password_format
        global kms_endpoint
        global region
        global secret_name
        global headers
        region = context.getUserData('region')
        secret_name = context.getUserData('secret_name')
        password_length = 16 if context.getUserData('password_length') is None else int(context.getUserData('password_length'))
        password_format = 2 if context.getUserData('password_format') is None else int(context.getUserData('password_format'))
        secret_content = context.getUserData('secret_content')
        headers = {
            'Content-Type': 'application/json',
            'x-Auth-Token': context.getToken()
        }
        try:
            new_content = replace_old_content(secret_content)
            # check region, if pass, return kms endpoint
            kms_endpoint = check_region(region)
            return update(context, new_content)
        except Exception as e:
            print("ERROR: %s" % e)
            return 'FAILED'
     
    # replace "password_placeholder" in secret_content by new password
    def replace_old_content(content):
        while content.find("password_placeholder") != -1:
            password = generate_password()
            while password.find("password_placeholder") != -1:
                password = generate_password()
            content = content.replace("password_placeholder", password, 1)
        return content
        
    def generate_password():
        special_chars = "~!@#%^*-_=+?"
        # password format(default is 2): 
        # 1.support letters and digits; 2.support letters, digits and special chars(~!@#%^*-_=+?);
        # 3.only support digits; 4.only support letters
        format_mapping = {
            1: string.ascii_letters + string.digits,
            2: string.ascii_letters + string.digits + special_chars,
            3: string.digits,
            4: string.ascii_letters
        }
        if password_length < 8 or password_length > 128:
            raise Exception("invalid password_length: %s, the password length range must be between 8-128." % password_length)
        try:
            support_chars = format_mapping[password_format]
            password = ''.join([secrets.choice(support_chars) for _ in range(password_length)])
            return password
        except:
            raise Exception("invalid password_format: %s." % password_format)
        
    def check_region(region):
        endpoint_mapping = {
            'cn-north-1': 'cn-north-1.myhuaweicloud.com',
            'cn-north-2': 'cn-north-2.myhuaweicloud.com',
            'cn-north-4': 'cn-north-4.myhuaweicloud.com',
            'cn-north-7': 'cn-north-7.myhuaweicloud.com',
            'cn-north-9': 'cn-north-9.myhuaweicloud.com',
            'cn-east-2': 'cn-east-2.myhuaweicloud.com',
            'cn-east-3': 'cn-east-3.myhuaweicloud.com',
            'cn-south-1': 'cn-south-1.myhuaweicloud.com',
            'cn-south-2': 'cn-south-2.myhuaweicloud.com',
            'cn-southwest-2': 'cn-southwest-2.myhuaweicloud.com',
            'ap-southeast-1': 'ap-southeast-1.myhuaweicloud.com',
            'ap-southeast-2': 'ap-southeast-2.myhuaweicloud.com',
            'ap-southeast-3': 'ap-southeast-3.myhuaweicloud.com',
            'af-south-1': 'af-south-1.myhuaweicloud.com',
            'la-north-2': 'la-north-2.myhuaweicloud.com',
            'la-south-2': 'la-south-2.myhuaweicloud.com',
            'na-mexico-1': 'na-mexico-1.myhuaweicloud.com',
            'sa-brazil-1': 'sa-brazil-1.myhuaweicloud.com'
        }
        try:
            endpoint = endpoint_mapping[region]
            kms_endpoint = '%s.%s' % ('kms', endpoint)
            return kms_endpoint
        except:
            raise Exception("invalid region: %s" % region)
     
    def check_csms_resp(resp):
        if resp.status_code in (200, 201, 204):
            return
        caller_function_name = inspect.stack()[1].function
        json_resp = json.loads(resp.text)
        if 'error_msg' in json_resp:
            error_message = 'function:%s , reason: %s' % (
                caller_function_name, json_resp['error_msg'])
            raise Exception(error_message)
        error_message = 'function:%s , reason: %s' % (
            caller_function_name, resp.text)
        raise Exception(error_message)
     
    def update(context, new_content):
        project_id = context.getProjectID()
        url = 'https://%s/v1/%s/secrets/%s/versions' % (kms_endpoint, project_id, secret_name)
        payload = {'secret_string': new_content}
        payload = json.dumps(payload)
        resp = requests.post(url, headers=headers, data=payload)
        check_csms_resp(resp)
        return 'SUCCESS'

调试

需对创建的函数工作流进行调试,具体请参见在线调试

创建触发器

需创建触发器,具体请参见使用定时触发器

查看凭据

  1. 登录管理控制台
  2. 单击页面左侧,选择安全与合规 > 数据加密服务,默认进入“密钥管理”界面。
  3. 在左侧导航树中,选择凭据管理 > 凭据列表,进入“凭据管理”页面。
  4. 在凭据列表查找指定凭据,即创建密码轮转函数中secret_name对应凭据。
  5. 单击凭据名称,进入凭据详情页面,即可查看凭据当前版本以及历史版本等信息。

    图6 查看凭据信息

  6. 在当前版本区域,单击“查看凭据值”,即可查看当前生效的安全密码。

    图7 查看凭据值

相关文档