# 通过堡垒机纳管主机或数据库资源
堡垒机支持添加SSH、RDP、VNC、TELNET、FTP、SFTP、DB2、MySQL、SQL Server、Oracle、SCP、Rlogin、Redis、MongoDB等协议类型的资源，包括Linux主机、Windows主机和数据库等。
本章节主要介绍通过添加单个主机资源、从文件导入主机资源、导入云主机资源、自动发现主机资源、克隆主机资源等方式，将主机资源纳入堡垒机进行集中管理。
#### 约束限制
- 添加的主机和应用资源数量总和不能超过[资产数](https://support.huaweicloud.com/cbh_faq/cbh_03_0016.html)。
- 系统内协议类型@主机地址:端口需唯一，不能重复，即被纳管的主机资源需唯一。否则再次创建相同配置的主机时，会报"主机已存在"错误。
- 为主机资源配置"所属部门"为上级部门时，当前用户的角色需拥有管理权限，否则会配置失败。修改用户角色管理权限，请参见[查看或修改角色的基本信息及权限范围](https://support.huaweicloud.com/usermanual-cbh/cbh_02_001402.html#cbh_02_001402__section1683053410589)。
 
#### 前提条件
- 已获取"主机管理"模块操作权限。
- 如需纳管VNC协议的Linux主机，请先在本地测试VNC与Linux主机已连接正常。 如何连接，请参见[使用VNC Viewer连接Linux云服务器](https://support.huaweicloud.com/bestpractice-ecs/zh-cn_topic_0168615364.html)。**云堡垒机不负责第三方VNC软件的兼容性问题。**
  
 
#### 添加单个主机或数据库资源
1. [登录堡垒机系统](https://support.huaweicloud.com/usermanual-cbh/cbh_02_0003.html)。
2. 选择"资源 \> 主机管理"，进入主机管理列表页面。
3. 单击"新建"，弹出新建主机编辑窗口。 
   配置主机资源的网络参数和基础信息。
   图1新建单个主机资源   
   ![](https://support.huaweicloud.com/usermanual-cbh/zh-cn_image_0000002172777321.png "点击放大")
    表1添加资源参数说明 
   | 参数    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   |:---|:---|
   | 主机名称   | 自定义的主机资源名称，系统内"主机名称"不能重复。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
   | 协议类型  | 选择主机的协议类型。 - 专业版支持协议类型有SSH、RDP、VNC、TELNET、FTP、SFTP、DB2、MySQL、SQL Server、Oracle、SCP、Rlogin、DM、Redis、MongoDB。  - 标准版支持协议类型有SSH、RDP、VNC、TELNET、FTP、SFTP、SCP、Rlogin。                                                                                                                                                                                              |
   | 连接方式                       | "协议类型"选择"SSH"、"RDP"协议时，可配置此参数。 选择连接方式，支持"直连"和"代理"，选择"代理"时，需选择代理服务器。如何添加代理服务器请参见[代理服务器管理](https://support.huaweicloud.com/usermanual-cbh/cbh_02_0076.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   | 主机地址  | 输入主机与堡垒机网络通畅的IP地址 - 选择主机的EIP地址或私有IP地址，建议优先选择可用私有IP地址。  - 系统默认要求网络接口为主机的IPv4地址。主机开启IPv6地址后，可配置主机的IPv4或IPv6地址。 说明： 因堡垒机管理同一VPC网络下的主机资源，根据网络稳定性与就近优势。私有IP对外访问的端口不受网络安全（安全组和ACL）的限制。EIP为独立的弹性IP，对外访问的端口受网络安全限制，可能导致无法通过堡垒机登录到主机。 故建议"主机地址"优先考虑配置同VPC网络下私有IP地址。    |
   | 端口    | 输入主机的端口号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   | 系统类型  | （可选）选择主机的操作系统类型或者设备系统类型。 - 默认为空，需要根据添加的资源系统类型选择对应的系统类型。  - 提供多种默认系统类型，并支持系统管理员**admin** 自定义系统类型，详情请参见[系统类型](https://support.huaweicloud.com/usermanual-cbh/cbh_02_0044.html)。                                                                                                                                                                                    |
   | 终端速度 | "协议类型"选择"Rlogin"协议时，可选择不同终端速率。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   | 编码    | "协议类型"选择"SSH"、"TELNET"时，可选择运维界面中文编码。 可选择UTF-8、Big5、GB18030。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   | 终端类型 | "协议类型"选择"SSH"、"TELNET"时，可选择运维终端类型。 可选择Linux、Xterm、Xterm-256color（默认）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   | 更多选项  | （可选）选择配置文件管理、X11转发、上行剪切板、下行剪切板、键盘审计。 - 文件管理：仅SSH、RDP、VNC协议类型主机可配置。  - 剪切板：仅SSH、RDP、TELNET协议类型主机可配置。  - X11转发：仅SSH协议类型主机可配置。  - 键盘审计：仅RDP、VNC协议类型主机可配置。                                    |
   | 所属部门    | 选择主机所属部门。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
   | 标签      | （可选）自定义标签或选择已有标签。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   | 主机描述  | （可选）对主机的简要描述。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
      
   
   
4. 单击"下一步"，为主机或数据库资源添加资源账户。 
   ![](https://support.huaweicloud.com/usermanual-cbh/public_sys-resources/note_3.0-zh-cn.png)
   未配置主机账户和密码时，默认创建"\[Empty\]"空账户，登录资源时需手动输入主机账户和相应密码。
   表2纳管主机账户信息说明 
   | 参数           | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   |:---|:---|
   | 添加账户           | 选择立即添加账户，或以后再添加账户。 - 选择"立即添加"，需要继续配置下面的各项内容。  - 选择"以后添加"，将结束本页配置，后续您可以在资源列表或资源详情中添加账户。                                                                                                                                                                                                                                                                                               |
   | 登录方式            | 选择登录方式。 - 选择"自动登录"时，"主机账户"和"密码"为必填项。 如果选择了自动登录方式，在创建改密策略的时候需要勾选"允许修改SSH key"选项，否则手动执行改密可能会失败。   - 选择"手动登录"时，"主机账户"和"密码"为可选项。  - 选择"CSMS凭证登录"时，需要已有凭证供选择。                                                                                          |
   | 主机账户           | 输入主机的账户名称。创建后不可修改，且系统内"资源账户"名唯一，不能重复。 勾选"特权账户"，即该账户可标识为管理资源的特权账户，拥有改密权限。 若主机安装了AD域服务，添加的主机账户为*域名* \\*主机账户名*，例如ad\\administrator。                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   | 密码               | 输入主机账户对应的密码。 默认勾选"验证"，配置完成确定后，自动验证资源账户的状态。 - 验证账户通过后，直接保存资源相关信息。  - 验证账户不通过，根据提示修改配置。 - 提示验证账户超时，请返回配置窗口，确认并修改资源信息；如果纳管的是root账号，请确认对应主机已开启允许root登录权限。  - 提示账户密码错误，请返回配置窗口，确认并修改资源账户密码。     |
   | 验证数据库                                | 当创建的是MongoDB协议资源时，需配置验证数据库，用于记录当前账户登录时，使用哪个认证库登录。 支持最长63个字符，禁止包含空字符**\\0** ，空格以及下列字符**：/\\."$**。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   | Postgresql参数/Gaussdb参数/DB2参数/Oracle参数 | 当创建的是PostgreSQL、Gaussdb、DB2、Oracle协议资源时，可配置此参数。 在输入框中输入数据库名称，指定当前资源账户可以登录的数据库，最多可指定20个数据库。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   | SSH Key         | 当创建的是SSH协议资源时，可配置此参数。 配置登录SSH Key验证，配置后优先使用SSH Key登录SSH主机资源。支持PEM或RFC4716格式的RSA私钥。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   | Passphrase      | 当创建的是SSH协议资源时，可配置此参数。 SSH Key对应私钥序列，可选择配置。 - 未生成私钥密码情况下，登录主机无需输入密码。  - 已生成私钥密码情况下，每次登录主机需手动输入私钥密码。                                                                                                                                                                                                                                                                                                                             |
   | 登录角色                                  | 当创建的是Oracle协议资源时，可配置此参数。 选择登录该主机资源的角色。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   | 账户描述            | 对资源账户的简要描述。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
      
   
   
5. 单击"确定"，且资源账户验证通过后，返回主机列表查看新建的主机资源。
 
#### 从文件导入主机或数据库资源
文件导入方式上传的文件类型需为csv、xls或xlsx格式的表格文件。
1. [登录堡垒机系统](https://support.huaweicloud.com/usermanual-cbh/cbh_02_0003.html)。
2. 选择"资源 \> 主机管理"，进入主机管理列表页面。
3. 单击界面右上角的"导入"，弹出配置界面。
4. "导入方式"选择"从文件导入"。
5. 单击"单击下载"，下载模板文件到本地。
6. 按照模板文件中的配置项说明，填写要导入的主机配置信息。 
   ![](https://support.huaweicloud.com/usermanual-cbh/public_sys-resources/note_3.0-zh-cn.png)
   表格内容需为文本格式。
   表3主机导入模板参数说明 
   | 参数               | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   |:---|:---|
   | 名称               | （必填）填入自定义主机资源名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   | IP地址/域名         | （必填）填入主机的IP地址或域名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   | 协议类型             | （必填）选择主机资源的协议类型，仅能填写一种类型。 - 专业版支持协议类型有SSH、RDP、VNC、TELNET、FTP、SFTP、DB2、MySQL、SQL Server、Oracle、SCP、Rlogin、DM、Redis、MongoDB。  - 标准版支持协议类型有SSH、RDP、VNC、TELNET、FTP、SFTP、SCP、Rlogin。                                                        |
   | 端口               | （必填）填入主机端口。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   | 系统类型            | 填入主机的系统类型。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   | 所属部门            | （必填）填入资源所归属的部门，需完整填写部门结构。 - 仅可填入一组部门层级，一个资源只能分属一个部门。  - 默认可填入部门为总部，部门上下级之间用","隔开。  - 请务必确保填入系统内已创建的[部门](https://support.huaweicloud.com/usermanual-cbh/cbh_02_0010.html)。   |
   | 标签               | 填入主机资源标签。 - 可填入多个标签，标签之间用","隔开。                                                                                                                                                                                                                                                                                                                                                                         |
   | 主机描述           | 填入对主机资源的简要描述。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   | 主机账户              | 填入主机资源账户名称。 - 不填写，也不会生成Empty账户。                                                                                                                                                                                                                                                                                                                                                                  |
   | 登录方式          | 选择主机资源登录方式。 - 可选择自动登录、手动登录、提权登录。                                                                                                                                                                                                                                                                                                                                                                       |
   | 特权账户           | 选择是否设置资源账户为特权账户。 - 可选择是或否。                                                                                                                                                                                                                                                                                                                                                                           |
   | 密码               | 填入资源账户的登录密码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   | SSH Key          | 针对SSH协议类型主机，可填入登录SSH Key验证。 配置后优先使用SSH Key登录资源。                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
   | passphrase       | 填入SSH Key对应私钥序列。 若您已生成私钥密码，每次登录主机需手动输入私钥密码。 详见**[如何配置SSH Key登录主机资源？](https://support.huaweicloud.com/cbh_faq/cbh_03_1034.html)**                                                                                                                                                                                                                                                                                                                                                                          |
   | Oracle参数       | 针对Oracle协议类型主机，必须填入参数。 - 可选择SERVICE_NAME或SID。  - 可填入多个参数，参数之间用","隔开。                                                                                                                                                                                                                      |
   | SERVICE_NAME或SID | 针对Oracle协议类型主机，必须填入参数值。 - 可填入多个参数值，参数值之间用","隔开。                                                                                                                                                                                                                                                                                                                                                       |
   | 登录角色             | 针对Oracle协议类型主机，必须填入参数。 - 可选择normal、sysdba、sysoper。  - 可填入多个参数，参数之间用","隔开。                                                                                                                                                                                                                   |
   | 数据库名             | 针对DB2数据库，必须填入参数。 - 可选择数据库名、实例名。  - 可填入多个参数，参数之间用","隔开。                                                                                                                                                                                                                                     |
   | 实例名              | 针对DB2数据库，必须填入参数。 - 可选择数据库名、实例名。  - 可填入多个参数，参数之间用","隔开。                                                                                                                                                                                                                                        |
   | 切换自              | 针对SSH协议类型主机，填入SSH主机资源账户名称，将该账户提权为特权账户。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   | 切换命令            | 填入切换账户的执行命令。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   | 账户描述              | 填入对资源账户的简要描述。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   | 账户组             | 填入资源账户所属的账户组。 - 资源账户可同时存在于同部门多个账户组，不同账户组之间用","隔开。  - 请务必确保填入系统内已创建的[账户组](https://support.huaweicloud.com/usermanual-cbh/cbh_02_0021.html)。                                                                                                                                              |
      
   
   
7. 单击"单击上传"，选择要导入的文件。
8. （可选）勾选"覆盖已有主机"，默认不勾选。 
   - 勾选，表示当协议类型@主机地址:端口信息重复时，覆盖原有主机信息。
   
   - 不勾选，表示当协议类型@主机地址:端口信息重复时，跳过重复的主机信息。
   
   
   
   
9. 单击"确定"，返回主机列表查看新增的主机。 
   ![](https://support.huaweicloud.com/usermanual-cbh/public_sys-resources/note_3.0-zh-cn.png)
   - 文件方式导入主机时，需严格按照Excel配置要求填写主机信息。
   
   - SSH协议类型主机支持配置SSH Key私钥登录方式。在填写SSH Key和Passphrase时，需填写正确的私钥和密码，不要引入其他字符和空格。配置SSH Key公钥和Passphrase密码后，优先SSH Key私钥方式验证登录资源。
   
   - SSH Key私钥和Passphrase密码为选填项，建议批量导入的资源仅纳管主机账户和密码登录。
    
   
   
 
#### 导入云主机或数据库资源
支持检索账号下全量Region资源，实现一键添加。
1. [登录堡垒机系统](https://support.huaweicloud.com/usermanual-cbh/cbh_02_0003.html)。
2. 选择"资源 \> 主机管理"，进入主机管理列表页面。
3. 单击界面右上角的"导入云资源"，弹出配置界面。 
   表4导入云资源配置说明 
   | 参数               | 说明                                                                                                                                                                                                                                                                                                                                                                              |
   |:---|:---|
   | 资源类型             | 可选择云主机和云数据库。 说明： 云数据库目前仅支持MySQL、PostgreSQL、SQL Server类型的数据库。                                                                                                                                                                                                                                                                                      |
   | 认证类型                                 | 支持选择AK/SK和云服务委托。                                                                                                                                                                                                                                                                                                                                                                                        |
   | Access Key ID    | 认证类型选AK/SK时需填写该项。 单击输入框后面的帮助按钮，获取相关信息。                                                                                                                                                                                                                                                                                                             |
   | Access Key Secret | 认证类型选AK/SK时需填写该项。 单击"Access Key ID"输入框后面的帮助按钮，获取相关信息。                                                                                                                                                                                                                                                                                              |
   | 优先导入IP            | 可选择"公网"或"内网"。                                                                                                                                                                                                                                                                                                                                                                   |
   | 更多选项            | （可选）勾选"覆盖已有主机"，默认不勾选。 - 勾选，表示当协议类型@主机地址:端口信息重复时，覆盖原有主机信息。  - 不勾选，表示当协议类型@主机地址:端口信息重复时，跳过重复的主机信息。   |
   | 所属部门            | 为导入主机配置部门。                                                                                                                                                                                                                                                                                                                                                                      |
   | 标签              | 为导入主机配置标签。                                                                                                                                                                                                                                                                                                                                                                       |
      
   
   
4. 确认信息无误，单击"下一步"，进入区域选择页面，选择需要导入资源的区域。 
   ![](https://support.huaweicloud.com/usermanual-cbh/public_sys-resources/note_3.0-zh-cn.png)
   一次只能选择一个区域进行导入。
   
   
5. 确认无误，单击"下一步"，自动执行导入，完成后在主机列表查看即可。
 
#### 自动发现主机或数据库资源
"自动发现"功能可通过输入的IP地址或地址段，使用Nmap工具扫描并发现该IP网段下所有的主机资源。
![](https://support.huaweicloud.com/usermanual-cbh/public_sys-resources/note_3.0-zh-cn.png)
主机与堡垒机在同一VPC内，且网络连接通畅，才能"自动发现"主机。
1. [登录堡垒机系统](https://support.huaweicloud.com/usermanual-cbh/cbh_02_0003.html)。
2. 选择"资源 \> 主机管理"，进入主机管理列表页面。
3. 单击界面右上角的"自动发现"，弹出配置界面。
4. 输入需导入的主机"IP地址"和主机的"端口"。 
   默认端口21，22，23，3389，5901，也可添加其他端口或端口范围。
   图2自动发现主机   
   ![](https://support.huaweicloud.com/usermanual-cbh/zh-cn_image_0000002172895745.png)
   
   
5. 单击"确定"，自动开始扫描。
6. 扫描结束后，勾选需要导入的主机。 
   - 输入主机名称，如果不输入主机名称，默认名称为主机IP。
   
   - 主机会根据端口默认选中相关协议类型，如果未匹配默认端口，则需要手动选取协议类型。
   
   
   
   
7. 选择自动发现的主机，单击"添加"。 
   单击"返回"或"关闭"，返回主机列表页面，查看新增的主机资源。
   
   
 
#### 克隆主机或数据库资源
若主机服务器内有多种资源形式，可通过克隆已添加的主机资源配置，并修改一定配置参数，快速添加主机资源。
1. [登录堡垒机系统](https://support.huaweicloud.com/usermanual-cbh/cbh_02_0003.html)。
2. 选择"资源 \> 主机管理"，进入主机管理列表页面。
3. 在已添加的主机资源的"操作"列，单击"更多 \> 克隆"，弹出新建主机编辑窗口。
4. 修改已有主机信息，并添加资源账户。 
   "协议类型"、"主机地址"、"端口"三个参数中必须修改一个。
   
   
5. 单击"确认"，返回主机列表页面，查看新添加的主机资源。
 
