# 创建你的第一个 Pipeline 函数
Pipeline 函数是 Authing 认证流程中执行的自定义 JavaScript 代码。借助 Pipeline,开发者可以轻易自定义和扩展 Authing 的能力。
# 注册 Authing 开发者账号
如果你还没有 Authing 开发者账号,请点击这里注册 Authing 账号 (opens new window),注册完成后系统会引导你创建你的第一个用户池。同时了解一下有关用户池的基础概念。
# 选择一个 Pipeline 模版
Authing 提供了很多开箱即用的模版,帮助你快速上手。
你也可以在这里查看 Pipeline 模版函数列表:https://github.com/authing/pipeline (opens new window)。同时欢迎你发挥才智,为我们贡献 Pipeline 模版函数。
首先进入控制台的扩展能力 - 自定义 Pipeline 页面,你会看到一些提示:
选择某个触发场景,点击 「+」按钮,我们有 20 余种模版供选择:
这里,我们选择访问控制中的 "注册邮箱后缀白名单"。
# 创建一个 Pipeline 函数
这里我们设置的域名白名单是 "example.com",你也可以改成自己的。
点击左下角的“保存“按钮,我们会将此函数部署到云端,需要一定时间,请耐心等待。
回到 Pipeline 函数列表页面,可以看到我们刚刚添加的那个函数。
如果你有多个 Pipeline 函数,可以拖拽进行排序。
# 验证白名单是否有效
首先使用非 example.com
后缀邮箱,看到返回了 "Access Denied." 提示,这是我们在自定义 Pipeline 函数中自己指定的提示信息。
之后再使用后缀为 example.com
的邮箱注册,注册成功!
# 接下来你可能还需要
你可以:
- 详细阅读 Pipeline 函数的开发文档。
- 了解可以在 pipe 函数中获取那些请求信息:user 对象 和 context 对象。
- 了解如何在 pipe 函数中使用环境变量。
- 了解在 pipe 函数中可以使用哪些开箱即用的 Node Modules。你可以直接使用 authing-js-sdk !
- 我们提供了很多丰富的 Pipeline 函数模板,点击这里查看 (opens new window)。
- 我们还提供了方便的在线调试手段,方便开发者在线调试。