创建你的第一个 Pipeline 函数
Pipeline 函数是 Authing 认证流程中执行的自定义 JavaScript 代码。借助 Pipeline,开发者可以轻易自定义和扩展 Authing 的能力。
本文介绍如何使用 Authing 控制台创建一个 Pipeline 函数。如果你想使用 SDK 创建,请见:
pageNode SDK非 JS 开发者请见:
pageGraphQL API0. 注册 Authing 开发者账号
如果你还没有 Authing 开发者账号,请点击这里注册 Authing 账号,注册完成后系统会引导你创建你的第一个用户池。同时了解一下有关用户池的基础概念。
1. 选择一个 Pipeline 模版
Authing 提供了很多开箱即用的模版,帮助你快速上手。
你也可以在这里查看 Pipeline 模版函数列表:https://github.com/authing/pipeline。同时欢迎你发挥才智,为我们贡献 Pipeline 模版函数。
首先进入控制台的 用户池 - 扩展能力 - 自定义 Pipeline 页面,你会看到一些提示:
点击右上角 “创建 Pipeline 函数“,进入选择模版页:
这里,我们选择访问控制中的 "注册邮箱域名白名单"。
2. 创建一个 Pipeline 函数
这里我们设置的域名白名单是 "example.com",你也可以改成自己的。
点击左下角的“保存“按钮,我们会将此函数部署到云端,需要一定时间,请耐心等待。
回到 Pipeline 函数列表页面,可以看到我们刚刚添加的那个函数。
如果你有多个 Pipeline 函数,可以拖拽进行排序。
3. 验证白名单是否有效
这里我们使用 Authing 提供的表单进行登录,进入 用户池 - 社会化登录- OIDC 应用页面,你可以看到你的所有 OIDC 应用。
点击右边第一个按钮 “体验登录”,你会跳转到 Authing 的登录表单 Guard 的页面。
了解更多 Guard 信息,请见:
pageGuard for Web首先使用非 example.com
后缀邮箱,看到返回了 "Access Denied." 提示,这是我们在自定义 Pipeline 函数中自己指定的提示信息。
之后再使用后缀为 example.com
的邮箱注册,注册成功!
4. 接下来 ...
你可以:
详细阅读 Pipeline 函数的开发文档。
了解可以在 pipe 函数中获取那些请求信息:user 对象 和 context 对象。
了解如何在 pipe 函数中使用环境变量。
了解在 pipe 函数中可以使用哪些开箱即用的 Node Modules。你可以直接使用 authing-js-sdk !
我们提供了很多丰富的 Pipeline 函数模板,点击这里查看。
我们还提供了方便的在线调试手段,方便开发者在线调试。
你还可以使用 Node SDK 管理自己的 Pipeline 资源。
非 JS 开发者,可以使用我们的 GraphQL 调试器,上面有详细的文档说明。
Last updated