nodes sso

节点单点登录 ?

？安装

将NodesSSO添加到包依赖项（在Package.swift文件中）：

dependencies: [
    ... ,
    . package ( url : " https://github.com/nodes-vapor/nodes-sso.git " , from : " 1.0.0 " )
]

以及您的目标（例如“应用程序”）：

targets: [
    ...
    . target (
        name : " App " ,
        dependencies : [ ... " NodesSSO " ... ]
    ) ,
    ...
]

安装资源

从此存储库中复制Resources/Views和Public中的NodesSSO文件夹，并将它们粘贴到项目的相同目录中。您可以将此存储库下载为 zip 格式，然后将文件移动到上述目录中。

入门

首先确保您已在需要的地方导入 NodesSSO：

import NodesSSO

添加提供商

 public func configure ( _ config : inout Config , _ env : inout Environment , _ services : inout Services ) throws {
    try services . register ( NodesSSOProvider < MyNodesSSOAuthenticatableUser > ( config : NodesSSOConfig (
        projectURL : " https://myproject.com " ,
        redirectURL : " https://url-for-sso.com " ,
        salt : " MY-SECRET-HASH-FOR-SSO " ,
        environment : env
    ) ) )
}

还有一些参数用于设置应在项目中启用 SSO 的路由。查看NodesSSOConfig的签名以获取更多信息。

添加 SSO 路由

确保添加相关的节点 SSO 路由，例如在您的configure.swift或routes.swift中：

services . register ( Router . self ) { container -> EngineRouter in
    let router = EngineRouter . default ( )
    try router . useNodesSSORoutes ( MyNodesSSOAuthenticatableUser . self , on : container )
    return router
}

添加叶子标签

为了渲染嵌入 SSO 按钮，您需要添加 NodesSSO Leaf 标签：

 public func configure ( _ config : inout Config , _ env : inout Environment , _ services : inout Services ) throws {
    services . register { _ -> LeafTagConfig in
        var tags = LeafTagConfig . default ( )
        tags . useNodesSSOLeafTags ( )
        return tags
    }
}

嵌入 SSO 按钮

在您希望显示 NodesSSO 按钮的页面上，嵌入sso-button叶文件：

 #embed("NodesSSO/sso-button")

符合NodesSSOAuthenticatable

NodesSSOProvider是通用的，需要符合NodesSSOAuthenticatable的类型。该协议有一个在 SSO 成功完成时被调用的方法：

 public static func authenticated ( _ user : AuthenticatedUser , req : Request ) -> Future < Response >

有了这个AuthenticatedUser实施者就可以查找email并创建用户（如果不存在），或者如果存在，则自动让用户登录。

？制作人员

该包由 Nodes 的 Vapor 团队开发和维护。

？执照

该软件包是根据 MIT 许可证授权的开源软件