竹云IDaaS开放平台

简体中文

English

简体中文

English

Appearance

认证源云桥 ​

概述 ​

认证源类型云桥是IDaaS云桥中的一种，用于建立竹云IDaaS与企业内部相应认证源之间的连接通道，目前支持AD认证源和LDAP认证源两种认证源。

本章节指导您在IDaaS平台部署及使用认证源云桥Agent，提供认证源云桥安装包的更新记录，以便您根据项目实际需求选择合适版本。下文以操作系统CentOS Linux release 8.0.1905部署认证源云桥Agent为例。

前提条件 ​

  • 拥有IDaaS企业中心平台的管理员权限。

  • 拥有内网服务器操作权限。

  • 服务器已安装net-tools、curl、jdk(OpenJDK 17及以上版本)、rng-tools。安装步骤参考如下：

    net-tools安装

    • 验证net-tools是否已安装

      rpm -q net-tools

    • 如果未安装则下载安装包并上传至内网服务器。

    • 进入文件所在目录，执行安装命令。

      yum -y install net-tools-2.0-0.22.20131004git.el7.x86_64.rpm

    • 验证安装。

      rpm -q net-tools

    curl安装

    • 大多数Linux发行版都自带curl，验证是否已安装即可。

      curl --version

    jdk安装

    • 下载安装包并上传至内网服务器。

    • 进入文件所在目录，执行安装命令。

      yum -y install jdk-17.0.13_linux-x64_bin.rpm

    • 验证安装。

      java -version

    rng-tools安装

    • 需要安装rng-tools工具提高系统熵池的补充速率，执行以下命令进行安装rng-tools：

      yum install rng-tools

    • 查看rngd配置文件是否存在：

      cat /etc/sysconfig/rngd

    • 如果没有该文件或文件内容为空，请执行以下命令新增该文件：

      echo "OPTIONS=\"-r /dev/urandom\"" > /etc/sysconfig/rngd

    • 执行以下命令启动rng服务以及查询rng服务状态。

      service rngd start   启动rng服务
service rngd status   查看rng服务状态

      状态为enabled表示启动成功：

部署前准备 ​

软件包 ​

请提前准备如下所示软件包。

软件包名称说明下载链接
cloudAgent-authSource-{版本号}.zip认证源云桥安装包。点此下载
cloudAgent-authSource-{版本号}.zip.sha256认证源云桥安装包的SHA256校验文件，用于校验认证源云桥安装包的完整性。点此下载

认证源云桥安装包解压后的文件如下：

名称说明
agent.sh开机自启动云桥Agent的文件。
cloudAgent-authSource.jar认证源云桥Agent的部署包。
cloudBridge.sh手动启动云桥Agent的文件。
config云桥Agent配置文件（application.yml）的存放目录。
log云桥Agent日志（agent.log）的存放目录。

部署认证源云桥 ​

  1. 登录IDaaS企业中心平台，在上方导航栏选择 “设置 > 云桥配置“ ，单击 ”添加云桥Agent“ ，设置名称并选择认证源类型云桥。

    TIP

    • 云桥Agent添加完成后，系统会自动生成ClientID和ClientSecret，请妥善保管。
    • 如不慎忘记ClientSecret，单击目标Agent的 “重置密钥” 即可重新生成。重置后，原密钥将会失效，请谨慎操作。
    • 支持查看云桥连接日志及服务日志。
    • 支持为云桥Agent配置IP，配置为部署云桥Agent的服务器的出口IP，配置后只允许该IP连接IDaaS云服务，以确保服务安全性。
    • 支持删除目标Agent，请谨慎操作。

  2. 上传获取的认证源云桥的所有软件包至目标服务器，执行如下命令校验云桥安装包的完整性，当回显信息显示OK，表示完整性校验成功。

    sha256sum -c cloudAgent-authSource-{版本号}.zip.sha256

  3. 执行以下命令解压认证源云桥安装包，其中存放地址必须唯一，否则会导致安装出错。

    unzip -od {文件解压后的存放地址} cloudAgent-authSource-{版本号}.zip

  4. 进入文件解压后的目录，配置config目录下的application.yml文件。

    ###UTF-8格式YAML配置标识头,勿删除###
server:
  # 云桥启动端口  
  port: 9082

agent:
  # 云桥服务地址，domain为在IDaaS的租户域名xx.bccastle.com
  示例：serverAddress: wss://domain/api/v1/ws
  # 云桥ClientID，在IDaaS创建的云桥的ClientID
  示例：agentId: 7jve68NwihfnjsD8SJToWxTU5Wg8hkl1
  # 云桥ClientSecret，在IDaaS创建的云桥的ClientSecret
  示例：agentSecret: LdfwryojYHLMaeNGVdr9fSh1iwyDCL0QuBx2wewrjxT5UOhUQVpAqwerfgj8pLNV1

authentication:
  ad:
    # AD认证开关，默认值为false，为true开启AD认证
    示例：enable: false
    # AD服务器地址，格式为ldap://host:port/，多个地址时使用,分隔，多个地址时schema必须全部相同，全部都为ldap或全部都为ldaps
    示例：urls: ldap://localhost:389/
    # AD中的节点，会到该节点下查询用户
    示例：rootDn: User
    # AD中的域名，域名存在时，自动拼接登录名+@+域名作为查询条件，否则仅登录名作为查询条件
    示例：domain: test.ad.com
    # 用户查询条件，根据对象类和用户登录名进行查找，userPrincipalName可根据实际情况调整；
    # 占位符说明：{0}-带域名查询，页面输入值+域名，如zhangsan@companya.cn,
    # 无域名时获取认证源域名属性值拼接后查询,{1}-原值查询，以页面输入值查询，如zhangsan。
    示例：searchFilter: '(&(objectClass=user)(userPrincipalName={0}))'
    # AD连接超时时间，可设置范围 1000 - 3000 毫秒
    示例：timeout: 1000
  
  ldap:
    # LDAP 认证开关，默认值false，为true开启LDAP认证
    示例：enable: false
    # LDAP服务器地址，格式为ldap://host:port/，多个地址时使用,分隔，多个地址时schema必须全部相同，全部都为ldap或全部都为ldaps
    示例：urls: ldap://localhost:389/
    # LDAP目录树最顶部的根目录
    示例：baseDn: DC=test,DC=com,DC=cn
    # LDAP管理员账号标识
    示例：managerDn: testadmin
    # LDAP管理员账号密码
    示例：managerPassword: Passw0rd
    # Ldap公共搜索路径
    示例：userSearchBase: ou=people
    # LDAP中匹配系统用户的过滤条件，详细请参考:https://ldap.com/ldap-filters/，基于条件的查询优先级低于基于DN的查询
    示例：userSearchFilter: (&(objectClass=user)(uid={0}))
    # 填写用户ID或者组织单元除BaseDn外，Ldap用户搜索路径，用户DN模式查询优先
    示例：dnPatterns: uid={0},ou=people
    # LDAP连接超时时间，可设置范围 1000 - 3000 毫秒
    示例：timeout: 1000

# This is the Agent log level control configuration
logging:
  level:
    com.bamboocloud.bcidaas.cloudbridge: DEBUG
  file:
    # The value of the attribute must have a unit, which can be KB or MB
    # 单个日志文件大小。默认值10MB，最大值10MB
    # default: 10MB
    # max-size: 10MB
    # The maximum number of days that log files are to be archived
    # 日志最长保留时间。默认值7天，最大值7天
    # default: 7 DAYS
    # max-history: 7

  5. 配置文件完成后，在云桥安装包解压后的目录下执行以下命令启动云桥，当提示Starting Agent Success表示云桥启动成功，若启动失败请排查配置文件。

    ./cloudBridge.sh start

  6. （可选）如果需要开机自启动云桥，请在云桥安装包解压后的目录下执行以下命令，当提示The Agent service installed successfully, need to reboot will take effect表示启动成功。

    ./agent.sh install

  7. （可选）如果需要取消云桥开机自启动，请在云桥安装包解压后的目录下执行以下命令，当提示uninstall Agent Success表示取消云桥开机自启动成功。

    ./agent.sh uninstall

  8. 您可以通过目录中的log/agent.log文件获取日志信息。

使用认证源云桥 ​

更新日志 ​

本模块展示认证源云桥Agent安装包的更新记录。

版本更新说明
V25.2.1.1第三方组件升级，修复安全漏洞
V25.2.1.0Spring版本升级，修复安全漏洞
V24.11.1.0第三方组件升级，修复安全漏洞
V24.8.2.0云桥客户端安全加固
V24.4.1.0云桥客户端安全加固
V24.2.1.0支持 AD、LDAP 连接超时时间配置
V23.10.1.0JDK版本升级到JDK 17
V23.5.1.0增加客户端连接信息和日志备份
V22.11.1.01.优化了一些已知bug
2.优化WebSocket的连接
V22.9.1.01.修改云桥安装脚本，以systemd的方式安装看门狗，支持Ubuntu系统
2.安装脚本增加安装前的环境检查
V22.7.1.0支持查看云桥服务日志
V22.6.1.0支持LDAP认证
V21.10.2.01.配置错误，提示更加精确
2.优化Agent获取Pid的方式
V21.9.2.0新增看门狗机制
V21.9.1.01.云桥重连机制优化
2.优化了一些已知BUG

竹云IDaaS开放平台

Copyright © 竹云科技