@555platform/author.js 中文文档教程

Question

Author.js

OAuth 2.0 的同构 Javascript 工具包和 555 平台

完整的 API 文档在这里

Install

来自 npm

npm install @555platform/Author.js

Initialize - client

import { WebAuth } from '@555platform/Author.js';

const webAuth = WebAuth({
      domain: config.domain,
      clientID: config.clientID,
      responseType: 'code',
      redirectURI: config.redirectURI,
      scope: 'everything',
      authServer: config.authServer
    });

以上是示例客户端SDK的典型初始化。 authServer 字段是可选的，默认为 555 平台生产服务器。

可用的响应类型有 code、token、id_token 和 id_token token。

Initialize - server

服务器端的示例初始化。 请注意，目前 SDK 辅助函数仅支持 express.js。

serverAuth = ServerAuth({
  domain: config.domain,
  clientID: config.clientID,
  clientSecret: config.clientSecret,
  redirectURI: config.redirectURI,
  authServer: config.authServer
});

Using response type code

使用响应类型代码时，您需要从客户端启动登录，这将带您进入 555 平台登录屏幕。 登录成功后，555 平台将重定向到应在应用服务器上实现的 URI。 为了实现这个流程，我们需要客户端和服务器端的代码。 让我们先从客户端代码开始。

const webAuth = WebAuth({
      domain: config.domain,
      clientID: config.clientID,
      responseType: 'code',
      redirectURI: config.redirectURI,
      scope: 'everything',
      authServer: config.authServer
    });
    webAuth.login({ state: 'xyz' });

上面的代码将初始化 SDK 的客户端并使用响应类型代码启动登录流程。

现在在服务器端，我们需要使用 express.js 创建基本设置。 在 index.js 文件中：

const express = require('express');
const bodyParser = require('body-parser');
const cookieSession = require('cookie-session');
const cors = require('cors');

const app = express();
app.use(cors());
app.use(bodyParser.json());
app.use(
  cookieSession({
    maxAge: 30 * 24 * 60 * 60 * 1000,
    keys: ['victor is a cool cat']
  })
);

require('./routes/authRoutes')(app);

const PORT = process.env.PORT || 3033;
app.listen(PORT);

由于我们将使用 cookie 来存储 555 平台访问令牌，因此我们还包含了 cookie-session 模块。

接下来我们需要创建处理从登录页面重定向的路由。 在文件 routes/authRoutes.js 中添加以下代码：

const { ServerAuth } = require('@555platform/Author.js');
const config = require('./config');

serverAuth = ServerAuth({
  domain: config.domain,
  clientID: config.clientID,
  clientSecret: config.clientSecret,
  redirectURI: config.redirectURI,
  authServer: config.authServer
});

serverAuth.serializeUser(payload => {
  return payload.access_token;
});

serverAuth.deserializeUser(payload => {
  return payload;
});

module.exports = app => {
  app.use(serverAuth.session);

  app.get(
    '/auth/555/callback',
    serverAuth.authenticate({
      successRedirect: config.loginSuccess,
      failureRedirect: config.loginFailure,
      state: 'xyz',
      nonce: '123'
    })
  );
}

我们做的第一件事是使用客户端 ID/密码、重定向 URI、域和可选的身份验证服务器 URL 初始化服务器端 SDK。

两次调用 serializeUser 和 deserializeUser 用于从 req.user 和 req.session.user。

我们还提供将用户对象附加到请求的 session 中间件。

最后，我们处理从 555 平台接收到 code 的 /auth/555/callback URI。 辅助函数 authenticate 负责访问令牌的整个代码交换，它将重定向到上面指定的成功或失败 URL。

还可以控制 authenticate 完成访问令牌的代码交换后发生的情况。 如果您不想自动重定向，请使用以下示例代码来引入您自己的逻辑：

app.get(
    '/auth/555/callback',
    serverAuth.authenticate({
      state: 'xyz',
      nonce: '123'
    }), (req, res) => {
    console.log('AUTH CHECK: ', req.auth)
    if (req.auth) {
      res.send({message: 'authed'})
      return
    }

    res.status(401).send({message: 'unauthorized'})
  }
);

注意：为了在 req.auth 中接收授权数据，请不要将函数传递给 serializeUser和 反序列化用户。 如果您这样做，req.auth 将不包含任何数据，而是 req.user 将包含您选择的反序列化信息。

Using response type implicit

对于隐式流程，您启动调用以从客户端登录并直接接收带有访问令牌和/或 ID 令牌的重定向 URL，而无需交换代码。 如果您想直接在客户端中处理身份验证，这将很有用。

使用以下示例代码使用隐式流调用 SDK 启动登录：

import { WebAuth } from '@555platform/Author.js';

.
.
.

const webAuth = WebAuth({
      domain: config.domain,
      clientID: config.clientID,
      responseType: 'id_token token',
      redirectURI: config.implicitRedirectURI,
      scope: 'openid email',
      authServer: config.authServer
    });
    webAuth.login({ state: 'xyz' });

在这种情况下，登录完成后 555 平台将重定向到 redirectURI 中指定的 URL，示例值如下：

/implicit#access_token=<access_token>&expires_in=216000&id_token=<id_token>&scope=openid+email&state=xyz&token_type=Bearer