# 为API分组绑定域名
在开放API前，您需要为API分组绑定独立域名，用户通过独立域名访问分组内的API。
独立域名可分为内网域名和公网域名两种：
- 内网域名：部署在云服务平台内的业务系统，可以使用内网域名访问API。
- 公网域名：部署在云服务平台外的业务系统，可以使用公网域名访问API。
您也可以使用系统分配的默认子域名访问API分组内的API，该子域名唯一且不可修改，每天最多可以访问1000次，仅适用于内部测试使用。
#### 约束与限制
Site实例不支持使用子域名调用API，仅支持使用IP+Host头方式调用API。
#### 获取域名
- 云服务平台内业务系统访问API的场景，需获取内网域名作为独立域名。
  1. 申请内网域名，具体请参考[创建内网域名](https://support.huaweicloud.com/usermanual-dns/zh-cn_topic_0057773658.html)。
  
  2. 配置域名到"服务集成APIC 连接地址"的A类型记录集配置，具体请参考[添加内网域名解析记录](https://support.huaweicloud.com/usermanual-dns/dns_usermanual_2513.html)。
  
  3. 如果API分组中的API支持HTTPS请求协议，则需要为独立域名添加SSL证书。您需要提前获取SSL证书的内容和密钥，并[创建SSL证书](https://support.huaweicloud.com/usermanual-roma/roma_03_2133.html#roma_03_2133__section848219487190)。
   
- 云服务平台外业务系统访问API的场景，需获取公网域名作为独立域名。
  1. 申请公网域名，具体可通过域名注册商申请。
  
  2. 备案公网域名，您可以通过[备案中心](https://beian.huaweicloud.com/)完成域名备案。备案时长需几个工作日，建议您提前进行备案。
  
  3. 配置域名到API分组子域名的CNAME类型记录集配置，具体请参考[添加内网域名解析记录](https://support.huaweicloud.com/usermanual-dns/dns_usermanual_2513.html)。
  
  4. 如果API分组中的API支持HTTPS请求协议，则需要为独立域名添加SSL证书。您需要提前获取SSL证书的内容和密钥，并[创建SSL证书](https://support.huaweicloud.com/usermanual-roma/roma_03_2133.html#roma_03_2133__section848219487190)。
   
 
#### 绑定域名
1. 登录[ROMA Connect控制台](https://console.huaweicloud.com/roma3)，在左侧导航栏选择"资源管理"，在实例页面单击实例，进入实例控制台。
2. 在左侧的导航栏选择"服务集成 APIC \> API分组"，在页面中单击API分组的名称进入API运行页面。
3. 在页面左上角选择"分组信息"页签，在"域名管理"下，单击"绑定独立域名"。
4. 在绑定独立域名弹窗中填写域名配置信息。
   表1独立域名配置 
   | 参数                   | 说明                                                                                                                                                                                                                                                                                          |
   |:---|:---|
   | 域名                   | 填写要绑定的域名。                                                                                                                                                                                                                                                                                   |
   | 支持最小TLS版本            | 选择域名访问所使用的最小TLS版本。该配置仅对HTTPS生效，不影响HTTP或者其他访问方式。 - TLS1.1  - TLS1.2   TLS1.1存在安全风险，推荐使用TLS1.2。 |
   | 支持http to https自动重定向 | 是否支持HTTP到HTTPS的重定向。 仅当API的请求协议选择"HTTPS"或"HTTP\&HTTPS"，且独立域名已绑定SSL证书时重定向生效。 注意： 由于浏览器限制，非GET或非HEAD方法的重定向可能导致数据丢失，因此API请求方法限定为GET或HEAD。                                                               |
      
   
5. 完成后单击"确定"，将独立域名与API分组绑定。
   - 在域名列表中显示已创建的域名，表示域名创建成功。
   
   - 如果不再需要此域名时，在域名所在行，单击"解绑域名"。
   
   
   
   - 如果API分组中的API使用HTTPS请求协议，则需要为已创建的独立域名[绑定SSL证书（可选）]。
    
 
 #### 绑定SSL证书（可选）
当API分组中的API支持HTTPS请求协议，则需要为独立域名绑定SSL证书。否则跳过此步骤。
1. 在域名所在行单击"添加SSL证书"。
2. 在选择SSL证书弹窗中勾选要绑定的SSL证书，然后单击"确定"，完成SSL证书的绑定。
   - 如果选择的SSL证书上传过CA证书，可以勾选"开启客户端认证"即开启HTTPS双向认证。**注意，开启/关闭客户端认证会对现有业务有影响，请谨慎操作。**
   
   - 如果证书列表中无可用的SSL证书，可单击"创建SSL证书"，新增SSL证书，具体操作配置请参考[创建SSL证书](https://support.huaweicloud.com/usermanual-roma/roma_03_2133.html)章节。
    
 
#### 常见问题
配置API的调用域名相关常见问题：
- 绑定域名失败常见原因：未[解析域名]或域名重复。
- 添加SSL证书失败常见原因：生成证书的域名和实际添加证书所用的域名不一致。