O2OA使用手册
第一章 服务器部署及管理
  • 1.1 O2OA基于nginx的SSL跳转、转发配置
  • 1.2 平台服务器下载及安装部署 For WindowsServer(适用于V7.2之后的版本)
  • 1.3 平台服务器下载及安装部署 For Linux Server(适用于V7.2之后的版本)
  • 1.4 平台服务器主机架构配置推荐
  • 1.5 平台服务器下载及安装部署 For WindowsServer(适用于V7.2之前的版本)
  • 1.6 平台服务器下载及安装部署 For Linux Server(适用于O2OA V7.2之前的版本)
  • 1.7 华为云服务器部署O2OA-麒麟操作系统
  • 1.8 密码管理-超级管理员密码修改
  • 1.9 密码管理-普通用户初始化密码设置
  • 1.10 密码管理-用户重置密码操作
  • 1.11 系统配置-如何访问和操作内置数据库-H2
  • 1.12 系统配置-第三方数据库配置-MySQL
  • 1.13 日志管理-访问日志相关配置
  • 1.14 日志管理-审计日志相关配置@日志管理
  • 1.15 日志管理-平台日志文件说明
  • 1.16 系统配置-主要配置文件说明
  • 1.17 系统配置-配置服务器连接O2云
  • 1.18 系统配置-流程催办提醒配置
  • 1.19 系统配置-自定义消息提醒
  • 1.20 系统配置-消息提醒配置说明
  • 1.21 系统配置-文件存储服务器配置
  • 1.22 系统配置-工作日节假日配置
  • 1.23 系统配置-开机自动启动O2Server
  • 1.24 系统架构-集群部署配置及操作说明
  • 1.25 系统架构-基于nginx快速集群部署-上下文分发
  • 1.26 系统架构-基于nginx快速集群部署-端口分发
  • 1.27 平台维护-流转中工作数据的查询、操作和管理
  • 1.28 平台维护-待办待阅数据的查询操作和管理
  • 1.29 平台维护-自动执行平台数据的备份与恢复
  • 1.30 平台维护-备份和恢复平台数据操作
  • 1.31 平台服务器版本升级操作说明
  • 1.32 o2server无法正常显示验证码解决办法
  • 1.33 在宝塔面板中安装O2OA(For Linux)
  • 1.34 系统安全-启用HTTPS(百度云版)
  • 1.35 系统安全-启用HTTPS(腾讯云版)
  • 1.36 系统安全-自签名SSL证书验证HTTPS功能
  • 1.37 系统安全-加密登录-登录密码RSA加密
  • 1.38 功能部署-为平台增加全文检索功能
  • 1.39 平台维护-在线部署自定义应用的WAR包和JAR包
  • 1.40 平台维护-使用Web端运行服务器管理命令
  • 第十五章 开发知识及常见问题
  • 15.1 常见问题-7.2及以上版本开启web代理后请求中没有正确使用web端口问题解决方式
  • 15.2 linux环境libreoffice安装及使用
  • 15.3 在O2OA中使用网络会议(二):Openmeetings与O2OA认证配置
  • 15.4 在O2OA中使用网络会议(一):Openmeetings-5.1.0亲手安装整理 Step-By-Step
  • 15.5 藕粉社区问答系列1
  • 15.6 藕粉社区问答系列2
  • 15.7 藕粉社区问答系列3
  • 15.8 快速入门-平台相关资料汇总
  • 15.9 快速入门-服务器总体介绍汇总
  • 15.10 快速入门-流程表单载入基础数据
  • 15.11 快速入门-常用表单脚本样例汇总
  • 15.12 快速入门-自定义表数据分页样例
  • 15.13 OEM白标-如何修改平台中的Logo图标和文字
  • 15.14 云服务器-阿里云ECS服务器的端口启用
  • 15.15 开发知识-React篇:在O2OA平台框架中使用React
  • 15.16 开发知识-React篇:在O2OA门户页面中使用React
  • 15.17 开发知识-Vue篇:在Vue应用中集成O2OA
  • 15.18 开发知识-Vue篇:使用Vue-CLI开发O2应用
  • 15.19 开发知识-Vue篇:在O2门户页面中使用Vue
  • 15.20 平台中使用Druid数据库连接及监控
  • 15.21 开发知识-在PAAS平台上部署O2OA开发平台
  • 15.22 开发知识-如何使用Tomcat架设webdav服务器
  • 15.23 开发知识-单个端口模式的Nginx和系统配置
  • 15.24 开发知识-Linux非root用户如何使用80端口启动O2OA
  • 15.25 开发知识-O2OA平台启用Eruda进行移动端调试
  • 15.26 开发知识-神通数据库安装
  • 15.27 开发知识-人大金仓数据安装
  • 15.28 开发知识-中标麒麟安装达梦数据库(DM8)
  • 15.29 开发知识-中标麒麟安装人大金仓详细步骤
  • 15.30 开发知识-使用VNC连接中标麒麟V7操作系统
  • 15.31 开发知识-鲲鹏(ARM)麒麟操作系统如何替换yum源?
  • 15.32 开发知识-数据优化知识点
  • 15.33 水印安全-附件水印|加密|文档格式转换图片|PDF
  • 15.34 消息队列-配置activeMQ、kafka消息队列
  • 15.35 常见问题-数据导出或者导入时发生OOM异常
  • 15.36 常见问题-如何让用户在首次登录时,必须对初始密码进行修改
  • 15.37 常见问题-如何在模块部署中控制模块的访问权限
  • 15.38 常见问题-如何在平台中开发Ftp文件上传文件的服务?
  • 15.39 常见问题-如何使用服务管理调用WebService
  • 15.40 常见问题-如何使用脚本调用外部服务
  • 15.41 常见问题-如何使用脚本控制流程自动流转
  • 15.42 常见问题-如何通过脚本调用系统内服务
  • 15.43 常见问题-接口代码疑惑解答汇总
  • 15.44 常见问题:Maven编译o2server错误: Java Heap Space
  • 15.45 常见问题-集群配置后启动报错:NullPointerException
  • 15.46 常见问题-服务器错误:can not decrypt token
  • 15.47 常见问题-IOS移动办公无法收到验证码
  • 15.48 常见问题-服务器和日志时间相差12小时的问题
  • 15.49 常见问题-为什么127.0.0.1可以访问但其他IP无法访问
  • 15.50 藕粉社区问答系列4
  • 15.51 开发知识-React篇:在React应用中集成O2OA

  • 服务集成-发送用户名使用SSO进行登录认证

    时间:2022-08-03   

    O2OA提供多种SSO单点认证方式,比如约定密钥,OAuth2,SMAP等等。本文主要演示如何通过登录用户名,和SSO相关的配置,使用单点认证的方式进行O2Server的登录认证,获取xtoken信息


    此示例演示如何通过登录用户名,和SSO相关的配置,使用单点认证的方式进行O2Server的登录认证,获取xtoken信息

    注意:涉及到加密解密,请使用非中文的唯一标识进行登录 ,中文登录 有可能会有找不到用户的问题。

    一、o2Server平台SSO配置

    1、使用管理员(或者xadmin)登录O2OA

    2、打开系统菜单->控制面板->系统设置->SSO配置

    1577326915632-17923b68-fea0-4cf1-ae2a-94a1948a8f3d.png

    1577326917724-3e38161e-c82c-493a-9e01-94a6d3d695ca.png


    1577326917721-ced2d2ed-6081-4e6d-9ddf-ed2aec775e79.png


    3、添加SSO配置

    1577326919374-2ee055e8-a93c-4999-a6a8-5b7c95244ad1.png


    添加一个SSO配置

    4、重启o2server

    二、编写登录代码

    部分代码内容,LoginWithSSO.java

    package net.o2oa.demos;
    import java.io.BufferedReader;
    import java.io.IOException;
    import java.io.InputStreamReader;
    import java.io.PrintWriter;
    import java.net.URL;
    import java.net.URLConnection;
    import java.util.Date;
    import org.apache.commons.codec.binary.StringUtils;
    import org.json.JSONObject;
    import net.o2oa.util.Crypto;
    /**
     * 此示例演示如何通过登录用户名,和SSO相关的配置,使用单点认证的方式进行O2Server的登录认证,获取xtoken信息
     * 涉及到加密解密,请使用非中文的唯一标识进行登录 ,中文登录 有可能会有找不到用户的问题。
     * @author O2OA
     */
    public class Demo_LoginWithSSO {
    	static final String  URL_SSOLOGIN="/x_organization_assemble_authentication/jaxrs/sso";
    	public static void main( String[] args ) {
    		String applicationServer = "127.0.0.1";
    		Integer applicationPort = 20020;
    		String userName = "13533441287";
    		String ssoClient = "sso_demo";
    		String key = "sso123456";
    		try {
    			LoginResult result = login(applicationServer, applicationPort, userName, ssoClient, key);
    			if( StringUtils.equals( "success", result.getType() )) {
    				System.out.println("xtoken=" + result.getToken() );
    			}else {
    				System.out.println("message:" + result.getMessage() );
    			}			
    		} catch (Exception e) {
    			// TODO Auto-generated catch block
    			e.printStackTrace();
    		}
    	}
        
    	//服务地址:http://127.0.0.1:20020/x_organization_assemble_authentication/jaxrs/sso
    	//{"token":"xadmin","client":"sso_demo"}
    	/**
    	 * 使用登录认证的接口进行服务器登录,获取xtoken信息
    	 * @param applicationServer  127.0.0.1
    	 * @param applicationPort     20020
    	 * @param userName             张三
    	 * @param client                    sso_demo
    	 * @param key                       sso123456
    	 * @return
    	 * @throws Exception
    	 */
        public static LoginResult login( String applicationServer, Integer applicationPort, String userName, String client, String key ) throws Exception {
        //参数
                String loginUrl = "http://" + applicationServer + ":" + applicationPort + URL_SSOLOGIN ;
                String xtoken = Crypto.encrypt( userName + "#" + new Date().getTime(), key );
                String loginParams = String.format("{'token':'%s','client':'%s'}", xtoken, client );
                String responseData = sendPost( loginUrl, loginParams );
            ......
        }
    }


    成功响应结果

    {
    			  "type": "success",
    			  "data": {
    			    "token": "Xb9XTOjIQJa5AVRfHfIbNMFvhYdVfLgaipZBZBiUF7aNHeLrQ4vOu9YgprWeK2E1YsxApE_z4f1mvqvStFQI5CW7Pk31ulroUVAeR5jUybQ",
    			    "roleList": [],
    			    "id": "1cb47e12-18ad-4363-a55f-4514edb76215",
    			    "genderType": "m",
    			    "signature": "",
    			    "pinyin": "lisi",
    			    "pinyinInitial": "ls",
    			    "description": "",
    			    "name": "李四",
    			    "employee": "",
    			    "unique": "c93b7fb8-6820-466c-ab9c-f0637b8a3682",
    			    "distinguishedName": "李四@c93b7fb8-6820-466c-ab9c-f0637b8a3682@P",
    			    "orderNumber": 56649305,
    			    "controllerList": [],
    			    "superior": "",
    			    "changePasswordTime": "2019-10-18",
    			    "mail": "",
    			    "weixin": "",
    			    "qq": "",
    			    "mobile": "13533441287",
    			    "officePhone": "",
    			    "createTime": "2019-10-18 15:55:05",
    			    "updateTime": "2019-10-18 15:55:05"
    			  },
    			  "message": "",
    			  "date": "2019-10-19 15:12:10",
    			  "spent": 141,
    			  "size": -1,
    			  "count": 0,
    			  "position": 0
    }


    失败响应结果

    {
    			    "readyState": 4,
    			    "responseText": "{
      "type": "error",
      "message": "用户不存在或者密码错误.",
      "date": "2019-10-19 14:34:34",
      "spent": 9,
      "size": -1,
      "count": 0,
      "position": 0,
      "prompt": "com.x.organization.assemble.authentication.jaxrs.authentication.ExceptionPersonNotExistOrInvalidPassword"
    }",
    			    "responseJSON": {
    			        "type": "error",
    			        "message": "用户不存在或者密码错误.",
    			        "date": "2019-10-19 14:34:34",
    			        "spent": 9,
    			        "size": -1,
    			        "count": 0,
    			        "position": 0,
    			        "prompt": "com.x.organization.assemble.authentication.jaxrs.authentication.ExceptionPersonNotExistOrInvalidPassword"
    			    },
    			    "status": 500,
    			    "statusText": "Internal Server Error"
    }


    获取响应的x-token信息

    JSONObject result = new JSONObject(responseData);
    String type = result.getString("type");
    if( StringUtils.equals( "success", type )) {
    	//登录成功
        JSONObject data = result.getJSONObject("data");
        String token = data.getString( "token" );
    	return new LoginResult("success", token, "登录成功!");
    }else {
    	//登录失败
    	return new LoginResult("error", null, "用户登录失败!");
    }


    sendPost代码:

    /**
         * 发送POST请求
    	 * @param url  地址
    	 * @param param   传入的数据
    	 * @return
    */
    public static String sendPost( String url, String param ) {
            PrintWriter out = null;
            BufferedReader in = null;
            String result = "";
        try {
            URL realUrl = new URL(url);
            URLConnection conn = realUrl.openConnection();
            conn.setRequestProperty("accept", "*/*");
            conn.setRequestProperty("connection", "Keep-Alive");
            conn.setRequestProperty("Content-Type", "application/json; charset=utf-8");
            conn.setRequestProperty("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");
            conn.setDoOutput(true);
            conn.setDoInput(true);
            out = new PrintWriter(conn.getOutputStream());
            out.print(param);
            out.flush();
            in = new BufferedReader( new InputStreamReader(conn.getInputStream()));
            String line;
            while ((line = in.readLine()) != null) {
                result += line;
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            try {
            if (out != null) {
                out.close();
            }
            if (in != null) {
                in.close();
            }
            } catch (IOException ex) {
                ex.printStackTrace();
            }
        }
        return result;
    }
    
    public static class LoginResult{
    	private String type;
    	private String token;
    	private String message;
    		public LoginResult(String type, String token, String message) {
    			super();
    			this.type = type;
    			this.token = token;
    			this.message = message;
    		}
    		public String getType() {
    			return type;
    		}
    		public void setType(String type) {
    			this.type = type;
    		}
    		public String getToken() {
    			return token;
    		}
    		public void setToken(String token) {
    			this.token = token;
    		}
    		public String getMessage() {
    			return message;
    		}
    		public void setMessage(String message) {
    			this.message = message;
    		}
    }
    }


    数据加密辅助类,Crypto.java

    package net.o2oa.util;
    import java.io.IOException;
    import java.net.URLDecoder;
    import java.net.URLEncoder;
    import java.security.SecureRandom;
    import javax.crypto.Cipher;
    import javax.crypto.SecretKey;
    import javax.crypto.SecretKeyFactory;
    import javax.crypto.spec.DESKeySpec;
    import org.apache.commons.codec.binary.Base64;
    import org.apache.commons.lang3.StringUtils;
    /**
     * 数据加密辅助类
     */
    public class Crypto {
    	private static final String utf8 = "UTF-8";
    	private final static String DES = "DES";
    	private final static String cipher_init = "DES";
    	public static String encrypt(String data, String key) throws Exception {
    		byte[] bt = encrypt(data.getBytes(), key.getBytes());
    		String str = Base64.encodeBase64URLSafeString(bt);
    		return URLEncoder.encode( str, utf8 );
    	}
    	public static byte[] encrypt(byte[] data, byte[] key) throws Exception {
    		// 生成一个可信任的随机数源
    		SecureRandom sr = new SecureRandom();
    		// 从原始密钥数据创建DESKeySpec对象
    		DESKeySpec dks = new DESKeySpec(key);
    		// 创建一个密钥工厂,然后用它把DESKeySpec转换成SecretKey对象
    		SecretKeyFactory keyFactory = SecretKeyFactory.getInstance(DES);
    		SecretKey securekey = keyFactory.generateSecret(dks);
    		// Cipher对象实际完成加密操作
    		Cipher cipher = Cipher.getInstance(cipher_init);
    		// 用密钥初始化Cipher对象
    		cipher.init(Cipher.ENCRYPT_MODE, securekey, sr);
    		return cipher.doFinal(data);
    	}
    	public static String decrypt(String data, String key) throws IOException, Exception {
    		if (StringUtils.isEmpty(data)) {
    			return null;
    		}
    		String str = URLDecoder.decode(data, utf8);
    		byte[] buf = Base64.decodeBase64(str);
    		byte[] bt = decrypt(buf, key.getBytes());
    		return new String(bt);
    	}
    	public static byte[] decrypt(byte[] data, byte[] key) throws Exception {
    		// 生成一个可信任的随机数源
    		SecureRandom sr = new SecureRandom();
    		// 从原始密钥数据创建DESKeySpec对象
    		DESKeySpec dks = new DESKeySpec(key);
    		// 创建一个密钥工厂,然后用它把DESKeySpec转换成SecretKey对象
    		SecretKeyFactory keyFactory = SecretKeyFactory.getInstance(DES);
    		SecretKey securekey = keyFactory.generateSecret(dks);
    		// Cipher对象实际完成解密操作
    		Cipher cipher = Cipher.getInstance(cipher_init);
    		// 用密钥初始化Cipher对象
    		cipher.init(Cipher.DECRYPT_MODE, securekey, sr);
    		return cipher.doFinal(data);
        }
    }


    pom.xml内容:

    <project xmlns="http://maven.apache.org/POM/4.0.0"
    	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    	<modelVersion>4.0.0</modelVersion>
    	<groupId>net.o2oa.demos</groupId>
    	<artifactId>test_o2oa_java_demo</artifactId>
    	<version>0.0.1-SNAPSHOT</version>
    	<packaging>jar</packaging>
    	<name>test_start_process_demo</name>
    	<url>http://maven.apache.org</url>
    	<properties>
    		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    	</properties>
    	<dependencies>
    		<!-- https://mvnrepository.com/artifact/org.apache.httpcomponents/httpclient -->
    		<dependency>
    			<groupId>org.apache.httpcomponents</groupId>
    			<artifactId>httpclient</artifactId>
    			<version>4.5.10</version>
    		</dependency>
    		<!-- https://mvnrepository.com/artifact/org.apache.httpcomponents/httpcore-nio -->
    		<dependency>
    			<groupId>org.apache.httpcomponents</groupId>
    			<artifactId>httpcore-nio</artifactId>
    			<version>4.4.12</version>
    		</dependency>
    		<!-- https://mvnrepository.com/artifact/org.apache.httpcomponents/httpcore -->
    		<dependency>
    			<groupId>org.apache.httpcomponents</groupId>
    			<artifactId>httpcore</artifactId>
    			<version>4.4.12</version>
    		</dependency>
    		<!-- https://mvnrepository.com/artifact/org.apache.httpcomponents/httpmime -->
    		<dependency>
    			<groupId>org.apache.httpcomponents</groupId>
    			<artifactId>httpmime</artifactId>
    			<version>4.5.10</version>
    		</dependency>
    		<dependency>
    			<groupId>org.apache.commons</groupId>
    			<artifactId>commons-lang3</artifactId>
    			<version>3.9</version>
    		</dependency>
    		<dependency>
    			<groupId>com.google.code.gson</groupId>
    			<artifactId>gson</artifactId>
    			<version>2.8.5</version>
    		</dependency>
    		<!-- https://mvnrepository.com/artifact/org.json/json -->
    		<dependency>
    			<groupId>org.json</groupId>
    			<artifactId>json</artifactId>
    			<version>20190722</version>
    		</dependency>
    		<dependency>
    			<groupId>junit</groupId>
    			<artifactId>junit</artifactId>
    			<version>3.8.1</version>
    			<scope>test</scope>
    		</dependency>
    	</dependencies>
    </project>