子系统接入门户方法

不论子系统实现采用何种语言何种框架，都可以通过调用门户 API 来接入，步骤如下：

  • 首先，需要确保子系统跟门户系统部署在同一个一级域名下。比如：

  • 其次，在子系统的用户鉴权中间件(拦截器/过滤器)中调用 /api/isLoggedIn 接口，判断用户是否登录，若未登录，重定向到门户登录页。

  • 最后，在子系统的退出动作中调用 /api/logout 接口。

Enhancer 平台开发应用接入步骤

如果您的系统使用 Enhancer 平台来开发，只需要以下两步即可接入：

  • 第一步，在工作台->全局配置->用户登录->单点登录配置中，开启单点登录校验，贴入以下代码并根据实际情况做相关修改：
function (Enhancer, user, done) {

    // TODO: 本系统部署的地址，根据实际情况修改。
    var siteUrl = 'http://app1.site.com'
    // TODO: 门户登录地址。
    var loginUrl = 'http://portal.site.com/login'
    // TODO: 门户登录内网校验地址，由门户建设方负责提供。
    var ssoCheckUrl = 'http://xxx.xxx.xxx.xxx/api/isLoggedIn';

    var axios = require('axios');
    var logger = Enhancer.getLogger();
    var req = Enhancer.getContextRequest();

    // 从 cookie 中拿到单点登录门户设置的令牌。
    var accessToken = req.cookies.access_token;

    // 将门户设置的令牌，发给门户提供的接口做校验。
    axios.post(ssoCheckUrl, {access_token: accessToken})
    .then(function(response) {
         if (response.status !== 200) {
            var err = new Error('Failed to check user access token.');
            console.error(err.message);
            console.error(response.body);
            done(err)
            return;
         }
         var result = response.data;
         if (!result || !result.success || !result.isLoggedIn) {
             // 若校验不合法，返回重定向登录的地址，并且包含登录成功后返回的跳转地址。
             var url = loginUrl + '?redirect=' + encodeURIComponent(siteUrl);
             done(null, url);
             return;
         }

         var isDataInitialized = user.getVariable('IS_DATA_INITIALIZED');
         // 如果当前用户数据已初始化过，则直接返回 true。
         if (isDataInitialized) {
             done(null, true);
             return;
         }

         // TODO: 否则，给首次访问本系统的用户注入所需要的账户，角色，以及变量信息。
         // 这些信息可以来自约定的单点登录系统返回的信息，也可以查询本子系统数据库或
         // 其他 IO 操作，进一步获取用户相关信息。此处直接赋值示意。
         user.setRoles(['employee']);         // 用户必须有角色。
         user.setId(result.userInfo.id);      // 用户必须有 ID。
         user.setName(result.userInfo.name);  // 用户必须有名字，显示在登录状态栏。
         user.setVariable('DEPART','总经办');  // 其他变量根据需要设置。
         user.setVariable('DEPART_ID', 100);  // 部门 ID。

         /******
          * 注意：result.userInfo 字段包含从门户系统中带入的用户其他信息，该信息的来源可以是门户系统中
          * 配置的登录表，也可以是门户系统自定义登录实现过程中设置给 session.user 对象的字段。可以根据
          * 需要，将它们设定给本系统的 user 对象作为变量使用。
          ******/

         // 标记此用户数据已经初始化完成。
         user.setVariable('IS_DATA_INITIALIZED', true); 

         done(null, true);
    }).catch(function(err) {
         // 若有系统级错误，将错误对象作为第一个参数，传递给 done 方法，并返回。
         done(err);
         return;
    });
}
  • 第二步，在工作台->全局配置->用户登录->注销登录配置中，开启选项，贴入以下代码并根据实际情况做相关修改：
function (Enhancer, user) {
    var axios = require('request');
    var logger = Enhancer.getLogger();
    var req = Enhancer.getContextRequest();

    // 从 cookie 中拿到单点登录门户设置的令牌。
    var accessToken = req.cookies.access_token;

    // 注销用户接口 url。
    var logoutUrl = 'http://xxx.xxx.xxx/api/logout';

    axios.post(logoutUrl, {access_token: accessToken})
    .then(function(response) {
        var result = response.data;
        if (!result.success) {
            logger.info('Logout failed! Caused by:' + result.message);
        }
    }).catch(function(err) {
        logger.error('Logout failed! Caused by:');
        logger(err);
    });
}

results matching ""

    No results matching ""