jap/README.md
yadong.zhang 27357f2408 📝 Writing docs.
2021-01-22 10:50:33 +08:00

111 lines
7.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<p align="center">
<img src="https://images.gitee.com/uploads/images/2021/0115/230947_5eb9e00d_784199.png" width="300">
</p>
<p align="center">
<strong>Just auth into any app</strong>
</p>
<p align="center">
<a target="_blank" href="https://gitee.com/fujieid/jap">
<img src="https://img.shields.io/badge/Maven%20Central-未发布到中央仓库-blue" ></img>
</a>
<a target="_blank" href="https://gitee.com/yadong.zhang/JustAuth/blob/master/LICENSE">
<img src="https://img.shields.io/badge/license-LGPL%203.0-red" ></img>
</a>
<a target="_blank" href="https://www.oracle.com/technetwork/java/javase/downloads/index.html">
<img src="https://img.shields.io/badge/JDK-1.8+-green.svg" ></img>
</a>
<a target="_blank" href="https://gitee.com/fujieid/jap" title="API文档">
<img src="https://img.shields.io/badge/Api%20Docs-未发布-orange" ></img>
</a>
<a target="_blank" href="https://jap.fujieid.com" title="开发文档">
<img src="https://img.shields.io/badge/Docs-latest-blueviolet.svg" ></img>
</a>
<a target="_blank" href='https://gitee.com/fujieid/jap/stargazers'>
<img src="https://gitee.com/fujieid/jap/badge/star.svg" alt='star'></img>
</a>
<a target="_blank" href='https://github.com/fujieid/jap/stargazers'>
<img src="https://img.shields.io/github/stars/fujieid/jap?style=social" alt='star'></img>
</a>
</p>
<p align="center">
<strong>开源地址:</strong> <a target="_blank" href='https://gitee.com/fujieid/jap'>Gitee</a> | <a target="_blank" href='https://github.com/fujieid/jap'>Github</a>
</p>
<p align="center">
<strong>官方网站:</strong> <a target="_blank" href='https://jap.fujieid.com'>https://jap.fujieid.com</a>
</p>
## 🎨 JAP 是什么?
JAP 是**一款开源的认证中间件**,基于模块化设计,并且与业务高度解耦,使用起来非常灵活,开发者可以毫不费力地将 JAP 集成到任何 web 应用程序中,就像集成 JA 一样,简单方便。
JAP 要做的是为所有需要身份认证的应用提供一套标准的解决方案,集成所有 APP。方便开发者无缝对接任何第三方应用或者自有系统。
- JAP 口号Just auth into any app!
- JAP 目标:让身份链接无处可藏
- JAP 价值:方便开发者无缝对接任何第三方应用或者自有系统,提高开发效率,减少代码维护成本
- JAP 愿景:以开源的方式,受惠于开源社区,赋能于开发者。使之成为开发者生态内必不可少的“基础设施”,以期形成新的技术标准。
**ps我们要让开发者可以基于 JAP 开发出自己的 IAM 或者 IDaaS 系统。**
## ✨ JAP 有什么特点?
- 单点登录:一处登录,处处通行
- 开箱即用API 设计趋近于白话,类似并参考 JustAuth
- 多平台:
- 国内外数十家第三方平台(基于 JustAuth
- OAuthOIDC 协议的平台,内置国内外常见平台
- SAML 协议的平台,内置国内外常见平台
- 业务解耦JAP 不深入具体的业务,只将授权认证方面的功能抽象出一套标准的组件,方便任意系统快速对接
- 模块化JAP 基于模块开发,基本做到,用哪种引哪种
- 统一标准:一切内置实现或者自定义的实现,都基于标准的策略
- 多语言支持Java、Python、Go、Node等
## 💥 适用于哪些场景?
- 新项目立项,你们需要研发一套包含登录、认证的系统
- 现有登录模块为自研,但是新一轮的技术规划中,你们想将登录认证模块重构,以更加灵活的架构适应后面的新需求,比如:集成 MFA 登录、集成 OAuth 登录等
- 你们的项目太多,每个项目都需要登录认证模块,想解决这种重复劳动的问题
- 从长远方面考虑,公司或组织或个人需要一套标准的、灵活的、功能全面的登录认证功能
- 你们不想将研发成本放到登录认证这种必须但想做完善又需要花费大量时间成本、人力成本的事情上,希望有一个中间件可以完美集成登录认证功能,使研发人员有更多的时间和精力投入到业务开发中,提高研发产能和研发效率
- 你们除了需要对接标准的身份提供商外,还有一些非标准的身份提供商,需要投入研发人员单独定制开发
- 你们企业种用到的开发语言较多比如Java、Python、Node等每种语言对应的系统都要使用不同语言实现相同的登录认证功能
- 你们需要研发一个支持 OAuth 登录的 Web 应用程序
- 你们想让自己的系统支持对外提供 OAuth 服务
- 你们需要研发一个支持 SAML 登录的 Web 应用程序,但又苦于 SAML 那庞大而繁琐的业务流程和配置
- 你们想让自己的系统支持对外提供 SAML 服务
- 你们想研发一个支持 LDAP 登录的程序,但又不知道如何入手
- 你们觉得传统的账号密码非常脆弱,所想让用户使用一次性的手机验证码或邮箱验证码进行登录
- 你们企业希望联合其现有的企业用户目录,以允许员工使用其现有的企业凭据登录各种内部和第三方应用程序。
- ...
## ❓ JAP 常见问题有哪些?
### ❔ JAP 不支持具体的业务操作吗?
JAP 针对用户、应用等业务数据只提供标准的业务接口不提供数据库层面的支持。JAP 要做的是为广大开发者提供一套技术标准,既然是标准,那就不能依赖于任何和具体业务相关的逻辑。不管你们的系统是用的 MySQL、Oracle、SQLlite、Redis、MongoDB 还是其他的JAP 通通不关心。JAP 对外提供标准接口,业务端只需要按需实现 JAP 的接口即可,这种设计能在最大程度上增加它的灵活性,使它不受限于某一具体的数据库实现方案。
### ❔ JAP 可以用到企业级项目吗?
当然JAP 的价值就在于:**方便开发者无缝对接任何第三方应用或者自有系统,提高开发效率,减少代码维护成本**。所以对于企业来说这是一个降本增效的功能。JAP 基于模块化开发,并且不侵入业务系统,可以十分方便的集成到企业内部各个系统或者统一的登录认证网关中。
### ❔ JAP 可以商用吗?
JAP 基于 LGPL 3.0 协议。商用分为以下两种情况:
- LGPL **允许商业软件通过类库引用(link)方式使用**而不需要开源商业软件的代码。这使得**采用 LGPL 协议的开源代码可以被商业软件作为类库引用并发布和销售**
- 如果修改 LGPL 协议的代码或者衍生,则所有修改的代码,涉及修改部分的额外代码和衍生的代码都必须采用 LGPL 协议。因此 LGPL 协议的开源代码**不适合通过修改和衍生的方式做二次开发的商业软件采用**。
## 🚀 开源推荐
- `JustAuth` 开箱即用的整合第三方登录的开源组件: [https://github.com/justauth/JustAuth](https://github.com/justauth/JustAuth)
- `spring-boot-demo` 深度学习并实战 spring boot 的项目: [https://github.com/xkcoding/spring-boot-demo](https://github.com/xkcoding/spring-boot-demo)
- `mica` SpringBoot 微服务高效开发工具集: [https://github.com/lets-mica/mica](https://github.com/lets-mica/mica)
- `pig` 宇宙最强微服务认证授权脚手架(架构师必备): [https://gitee.com/log4j/pig](https://gitee.com/log4j/pig)
- `SpringBlade` 完整的线上解决方案(企业开发必备): https://gitee.com/smallc/SpringBlade
## 🏘️ 加入社群
![输入图片说明](https://images.gitee.com/uploads/images/2021/0121/093259_625dbb61_784199.png "JAP 入群邀请二维码.png")
## 🏘️ 加入开发者组织
[参考文章](https://jap.fujieid.com/community/weneed.html)