构建程序-j9九游会登录

创建api分组

创建函数及添加事件源之前，需要先创建一个api分组，api分组是api的管理单元，用来存放api。

您需要拥有一个apig实例后才能开启api网关服务相关功能，具体请参见购买实例。

1. 登录apig控制台，在左侧导航栏选择“api管理 > api分组”，单击“创建api分组”。
2. 选择直接创建，设置以下分组信息，完成后单击“确定”创建分组。
   • 分组名称：输入您自定义的分组名称，例如apigroup_test。
   • 描述：输入对分组的描述。

创建自定义认证函数

前端自定义认证指apig利用校验函数对收到的api请求进行安全认证，如果您想要使用自己的认证系统对api的访问进行认证鉴权，您可以在api管理中创建一个前端自定义认证来实现此功能。您需要先在functiongraph创建一个函数，通过函数定义您所需的认证信息，函数创建成功后，即可对api网关中的api进行认证鉴权。

本示例以header中的请求参数：event["headers"]，为例进行演示。请求参数详细说明请参见请求参数代码定义示例。

1. 在服务控制台左侧导航栏，选择“计算 > 函数工作流”，进入函数工作流控制台后，在左侧导航栏选择“函数 > 函数列表”，进入函数列表界面。
2. 单击“创建函数”，进入创建函数流程。
3. 填写函数配置信息，完成后单击“创建函数”。
   • 模板：选择“使用空白模板”。
   • 函数类型：事件函数。
   • 函数名称：输入您自定义的函数名称，例如：apig-test。
   • 委托名称：选择“未使用任何委托”。
   • 运行时语言：选择“python 2.7”。
4. 进入函数详情页，在“代码”页签，进行代码在线编辑，复制header中的请求参数定义代码示例中的代码并单击“部署”，更新函数。
5. 配置测试事件，测试用于前端自定义认证的函数。单击“配置测试事件”，选择事件模板。根据实际情况修改后保存测试模板(本示例在"headers"中添加"auth":"abc"），完成后单击“创建”。
   图1 配置测试事件
   
6. 单击“测试”，执行结果为“成功”时，表示自定义认证函数创建成功。
   图2 查看执行结果
   

创建自定义认证

在apig中创建自定义认证，对接前端自定义认证的函数。

1. 在服务控制台左侧导航栏，选择“应用中间件 > api网关”登录apig控制台，在左侧导航栏选择“api管理 > api策略”，在“自定义认证”页签下，单击“创建自定义认证”，弹出“创建自定义认证”对话框。
2. 配置自定义认证基础信息，如下图所示。
   • 认证名称：输入您自定义的名称，例如authorizer_test。
   • 类型：选择“前端”。
   • 函数地址：请选择用于前端自定义认证的函数apig-test。
     图3 创建自定义认证
     
3. 完成后单击“确定”，完成自定义认证的创建。

创建后端业务函数

api网关（apig）支持选择functiongraph作为后端服务类型，当请求设置函数工作流为后端服务的api时，api网关会触发相应的函数，函数工作流会将执行结果返回给api网关（apig）。

1. 创建函数方法与上述创建自定义认证函数相同，只需修改函数名称，避免名称重复。
2. 在函数详情页的“代码”页签，进行代码在线编辑，并传入如下所示的代码，完成后单击“部署”，更新函数。

   # -*- coding:utf-8 -*-
   import json
   def handler (event, context):
       body = "
   hello, functiongraph!
   "
       print(body)
       return {
           "statuscode":200,
           "body":body,
           "headers": {
               "content-type": "text/html",
           },        
           "isbase64encoded": false
       }

请求参数代码定义示例

在functiongraph中开发函数，以python2.7语言为例，函数代码需要满足如下条件。

函数有明确的接口定义，如下所示：

其中，body字段的内容为字符串格式，json解码之后为：

{
	"status": "allow/deny",
	"context": {
		"user": "abc"
	}
}

“status”字段为必选，用于标识认证结果。只支持“allow”或“deny”，“allow”表示认证成功，“deny”表示认证失败。

“context”字段为可选，只支持字符串类型键值对，键值不支持json对象或数组。

context中的数据为您自定义的字段，认证通过后作为认证参数映射到api网关后端参数中，其中context中的参数名称与系统参数名称必须完全一致，且区分大小写，context中的参数名称必须以英文字母开头，支持英文大小写字母、数字、下划线和中划线，且长度为1 ~ 32个字符。

header中的请求参数定义代码示例：

# -*- coding:utf-8 -*-
import json
def handler(event, context):
    if event["headers"].get("auth")=='abc':
        resp = {
            'statuscode': 200,
            'body': json.dumps({
                "status":"allow",
                "context":{
                    "user":"success"
                }
            })
        }
    else:
        resp = {
            'statuscode': 200,
            'body': json.dumps({
                "status":"deny",
            })   
        }
    return json.dumps(resp)

query中的请求参数定义代码示例：

# -*- coding:utf-8 -*-
import json
def handler(event, context):
    if event["querystringparameters"].get("test")=='abc':
        resp = {
            'statuscode': 200,
            'body': json.dumps({
                "status":"allow",
                "context":{
                    "user":"abcd"
                }
            })
        }
    else:
        resp = {
            'statuscode': 200,
            'body': json.dumps({
                "status":"deny",
            })   
        }
    return json.dumps(resp)

用户数据定义代码示例：

# -*- coding:utf-8 -*-
import json
def handler(event, context):
    if event.get("user_data")=='abc':
        resp = {
            'statuscode': 200,
            'body': json.dumps({
                "status":"allow",
                "context":{
                    "user":"abcd"
                }
            })
        }
    else:
        resp = {
            'statuscode': 200,
            'body': json.dumps({
                "status":"deny",
            })   
        }
    return json.dumps(resp)