# 配置APIG的AIAPIKey认证
APIG支持AI API（Artificial Intelligence Application Programming Interface，人工智能应用编程接口）通过AIAPIKey进行鉴权认证。这种方式不仅能够高效地控制AI API的访问权限，还能够实现对多租户场景下的精细权限管理。
AIAPIKey认证指在调用API时，HTTP请求头部消息增加一个参数Authorization，而不需要对请求内容签名，API网关也仅校验AIAPIKey，不校验请求签名，从而实现快速响应。
#### 前提条件
- 已创建APP认证类型的AI API。如未创建，请[创建API](https://support.huaweicloud.com/usermanual-apig/apig_03_0128.html)。
- 已创建凭据，并且关联账号ID和项目ID，以及关联APP认证类型的AI API。如未创建，请[配置APIG的API认证凭据](https://support.huaweicloud.com/usermanual-apig/apig_03_0056.html)。
- 已开启ai_api_key认证方式开关。如未开启，请[配置APIG实例参数](https://support.huaweicloud.com/usermanual-apig/apig_03_0039.html)。
 
#### 约束与限制
- AIAPIKey受限使用，如需使用，请[提交工单](https://support.huaweicloud.com/usermanual-ticket/zh-cn_topic_0127038618.html)申请。
- 每个凭据最多可创建5个AIAPIKey。如需调整配额，请[提交工单](https://support.huaweicloud.com/usermanual-ticket/zh-cn_topic_0127038618.html)，申请修改。
- app_token和ai_api_key同时开启时，优先判断AIAPIKey认证，当AIAPIKey认证失败时，进行app_token认证。当两种方式均认证失败时，则认证失败，其中一种认证成功即认证成功。
 
 #### 添加AIAPIKey
1. 进入[API网关控制台](https://console.huaweicloud.com/apig2/#/overview)页面。
2. 根据实际业务在左侧导航栏上方选择实例。

3. 在左侧导航栏选择"API管理 \> 凭据管理"。

4. 单击凭据名称，进入凭据详情页面。
5. 在"AIAPIKeys"区域，单击"添加AIAPIKey"。
6. 根据下表参数说明，在弹窗中配置AIAPIKey。 
   表1配置AIAPIKey 
   | 参数       | 说明                                                                                                                                                                                                                                                             |
   |:---|:---|
   | 生成方式     | 选择AIAPIKey的生成方式。 - 自动生成：由系统随机生成AIAPIKey。  - 手动输入：自定义AIAPIKey。   |
   | AIAPIKey | 仅手动输入方式需要填写AIAPIKey的值。 支持大小写字母、数字，以及+/=-_等特殊字符，长度为8\~128个字符。                                                                                                                                                                    |
   | 别名       | AIAPIKey的别名，可用于区分AIAPIKey。支持英文、数字、下划线、中划线，长度为1\~100个字符。                                                                                                                                                                                                        |
      
   
   
7. 单击"确定"。
8. AIAPIKey添加完成后，您可以使用AIAPIKey进行API请求的认证。 
   发送请求时，增加请求头部参数"Authorization"，省略请求签名相关信息。
   以Curl方式为例，增加头部参数名称："Authorization"，参数值填"Bearer [已添加的AIAPIKey]"。
   ```
   curl -X GET "https://api.exampledemo.com/testapi" -H "content-type: application/json"  -H "host: api.exampledemo.com" -H "Authorization: Bearer OGUwYzlk******ThlMTBlMzdjMQ=="
   ```
   
   
 
#### 相关文档
如果您希望通过API添加AIAPIKey，请参考[创建AIAPIKey](https://support.huaweicloud.com/api-apig/CreateAiApiKey.html)。