stozen / passport

This project provides you a basic auth2 server and client configuration powered by Spring Boot 2 with the ability to plug custom login page and using Mongo DB as datastore.

Passport

项目地址(URL)

https://github.com/pm6422/passport

概述(Overview)

本项目是以SpringBoot2为基础的标准OAuth2服务端程序，使用本项目可以快速创建企业内部的OAuth2服务器。其他Web或手机客户端可以使用本服务端做统一安全认证。 该服务端提供authorization_code，password，client_credentials，implicit等授权模式，适用于各种不同的使用场景。

本系统支持分布式多节点部署，分布式环境下session共享并没有使用常见的redis方案，而是采用了MongoDB存储。其优点是方便查看和管理session信息。

另外本项目提供用户管理，用户权限管理，单点登录客户端信息管理，系统菜单管理，以及应用健康状态监控，接口调用时间监控，工程配置信息查看等高级功能。

系统后端架构主要是以Spring相关组件为基础搭建的。

系统前端架构UI部分为Bootstrap定制主题，JavaScript部分采用了AngularJS的前端MVC架构，基于前后端分离**，前后端通信采用AJAX请求实现局部刷新页面。

本项目采用嵌入式MongoDB，原因是本例用作Demo，便于安装应用和还原数据库。大家在实际应用中可以替换成自己的MongoDB。

另外本项目采用国外最新的技术栈，也可以用作前后端学习资料。

应用配置(Configuration)

同时可以使用外部MongoDB，只需要按照以下两步骤操作即可：

1. 配置文件中增加如下配置，配置文件指的是application-XXX.yml。

spring:
    data:
        mongodb:
            database: dbname
            uri: mongodb://username:passport@ip:port/dbname

2. pom.xml中删除嵌入式Mongo的依赖

<dependency>
    <groupId>de.flapdoodle.embed</groupId>
    <artifactId>de.flapdoodle.embed.mongo</artifactId>
    <exclusions>
        <exclusion>
            <artifactId>slf4j-api</artifactId>
            <groupId>org.slf4j</groupId>
        </exclusion>
    </exclusions>
</dependency>

应用运行(Run)

本项目包含服务器端(passport-server)和客户端(passport-client)两个子模块。由于本项目采用嵌入式内存数据库，不需要依赖外部数据库，因此可以做到不修改一行代码就可以完成应用启动。

另外应用在第一次启动过程中会自动下载嵌入式数据库并自动完成安装，无需人工介入。下载过程中会使用到国外AWS服务器，有可能有部分人下载比较慢，请耐心等待，有条件的可以翻墙。

运行命令很简单就是mvn，自动进行maven clean install操作，并完成应用启动。

运行服务端(Run Passport Server)

cd passport-server
mvn

运行客户端(Run Passport Client)

cd passport-client
mvn

环境要求(Requirements)

• Java 8+
• Maven 3.0+

主要依赖(Major dependencies)

• Spring Boot 2.0.4
• Swagger and Springfox
• Spring boot starter actuator
• Spring boot starter data mongodb
• Spring boot starter security
• Spring security oauth2

系统截图(Screenshots)

联系方式(Contact)

微信WeChat: pm6422