使用appcode认证鉴权方式进行在线预测-九游平台

场景描述

appcode认证是一种简易的api调用认证方式，通过在http请求头中添加参数x-apig-appcode来实现身份认证，无需复杂的签名过程，适合于客户端环境安全可控的场景，如内网系统之间的api调用。在modelarts中，支持在部署在线服务时开启appcode认证（部署模型为在线服务中的“支持app认证”参数）。对于已部署的在线服务，modelarts支持修改其配置开启appcode认证。

本文主要介绍如何修改一个已有的在线服务，使其支持appcode认证并进行在线预测。

前提条件

提前部署在线服务，具体操作可以参考案例：使用modelarts standard一键完成商超商品识别模型部署。

操作步骤

1. 在modelarts控制台页面菜单栏中，单击“模型部署 > 在线服务”，进入在线服务页面。
2. 单击“授权管理”后，单击创建应用即可创建app应用。
   图1 授权管理
   
3. 创建完app应用后即可展开app，然后单击添加appcode即可添加appcode。
   图2 添加appcode
   
4. 单击使用modelarts standard一键完成商超商品识别模型部署案例中创建的在线服务名称，进入在线服务详情页，单击“修改”，进入修改在线服务页面。
   图3 修改服务
   
5. 开启app认证开关，选择自己创建的app应用名称，单击“下一步”，然后单击“提交”即可保存修改。
   图4 开启app认证
   
6. appcode认证预测。
   1. 在部署服务详情中单击“调用指南”，第二行的api接口公网地址即为app认证调用地址，展开后即可看到appcode值。
      图5 调用指南
      
   2. 在postman调试预测采用appcode认证：
      • 请求post url填app认证调用地址
      • 请求头headers中key参数为x-apig-appcode，value参数为appcode值
      • 请求body按照接口定义传参，本案例中key参数为images，选择为file格式，value参数单击上传需要识别的图片。
        图6 headers
        
        图7 body
        
        图8 返回结果
        

常见app认证报错分析

• 报错信息 "error_msg": "the api does not exist or has not been published in the environment", "error_code": "apig.0101"

  该报错需要检查app认证api是否还存在或者url是否正确。

• 报错信息 "error_msg": "incorrect app authentication information: app not found with specified appcode", "error_code": "apig.0303"

  该报错需要检查请求头headers参数中x-apig-appcode参数的值是否填错。

• 报错信息 "error_msg": "backend unavailable", "error_code": "apig.0202"

  该报错信息需要检查dispatcher实例是否正常。