检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
概述 使用APP认证调用API APP认证需要通过SDK访问。 使用IAM认证调用API 支持Token认证和AK/SK认证两种。 Token认证：通过Token认证调用请求。Token认证无需使用SDK签名，优先使用Token认证。
自定义认证 在API请求参数中携带认证信息进行认证。 无认证 无需认证，可直接调用API。 父主题： 调用API
API列表 API列表支持查看当前实例下所有的API，包含URL、运行环境、安全认证信息。 操作步骤 登录ROMA API控制台。 在控制台单击，选择区域，在“ROMA API”下选择待操作的应用。 在左侧导航栏选择“API管理 > API列表”。
IAM认证 支持Token认证或AK/SK认证。Explorer自动获取或临时生成Token或AK/SK。 无认证 填写API的Headers参数。 自定义认证 单击“调试结果”页签，查看调试结果。 父主题： API目录
访问参数会被添加到后端签名认证信息中，并发送给后端服务，后端服务根据携带的访问参数返回不同的响应参数。 开启绿色通道后，需要设置白名单和黑名单。白名单中的地址可以不用认证即可调用API；黑名单中的地址不允许调用API。 单击“确定”，完成授权。
创建凭证 凭证代表用户认证标识，用户通过凭证来订阅上架的产品，订阅后方可调用对应产品下的API。 操作步骤 登录ROMA API控制台。 在控制台单击，选择区域，在“ROMA API”下选择待操作的应用。 在左侧导航栏选择“API消费 > API目录”。
表1 安全配置参数说明 参数 参数说明 安全认证 API使用的认证方式，推荐使用APP认证。 APP认证：表示由ROMA API进行API请求的安全认证。 华为IAM认证：表示通过IAM服务进行安全认证。 自定义认证：表示使用自定义的后端函数API进行安全认证。
表2 安全配置参数 信息项 描述 安全认证 API认证方式： APP认证：表示由ROMA API服务负责接口请求的安全认证。 华为IAM认证：表示借助IAM服务进行安全认证。 自定义认证：用户有自己的认证系统或服务（如使用OAuth认证），可选择“自定义认证”。
app_token app_token认证方式开关。启用后，可在API请求中使用获取的access_token进行API的调用认证。
APP认证：填写APP认证所使用密钥对的Secret。 Basic Auth：填写basic认证所使用的密码。 Public Key：填写Public Key认证所使用的私钥。
通信失败、返回异常响应等错误 AUTHORIZER_FAILURE 500 自定义认证失败 自定义认证方返回认证失败 AUTHORIZER_IDENTITIES_FAILURE 401 自定义认证身份来源错误 前端自定义认证的身份来源信息缺失或不合法错误 AUTH_FAILURE
26 auth_type API认证类型。 27 access_model1 认证模式1。 28 access_model2 认证模式2，开启双重认证时，为自定义认证编号。 29 inner_time apig的内部处理时长，单位秒。
认证层 提供AK/SK、Token方式进行应用的认证，授权后才可访问；支持系统级和API级的IP黑白名单，拒绝恶意访问。 审计层 支持LTS日志分析，可为追查异常调用和恢复业务操作提供客观依据。
API管理 API服务管理 APIs管理 API列表 策略管理 自定义认证 SSL证书管理 API测试 凭据管理
图5 全局配置 安全配置：选择认证方式，此处选择“APP认证”。 后端请求配置。 表4 后端请求参数配置 参数 配置说明 后端服务类型 选择后端服务类型，此处选择“HTTP&HTTPS”。 负载通道 “不使用”负载通道。
双向认证 仅当“协议”选择“HTTPS”时需要配置。 是否选择“使用backend_client_certificate配置的证书做客户端认证”，若选择，您需在实例详情的“配置参数”页签中提前配backend_client_certificate证书。
API认证 APP认证工作原理 APP认证-Java IAM认证 其他认证 自定义认证 对后端服务进行签名 02 购买 ROMA API本身不收费，但部分功能需要关联对应资源才能使用，关联的资源需要提前购买。
如果校验通过，则执行下一个filter，否则返回认证失败。
如果signedHeaders中不包含X-Sdk-Date，也返回认证失败。
如果使用错误的Key和Secret访问，服务器返回401认证不通过。 父主题： 对后端服务进行签名
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
