Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/justauth/JustAuth

🏆Gitee 最有价值开源项目 🚀:100: 小而全而美的第三方登录开源组件。目前已支持Github、Gitee、微博、钉钉、百度、Coding、腾讯云开发者平台、OSChina、支付宝、QQ、微信、淘宝、Google、Facebook、抖音、领英、小米、微软、今日头条、Teambition、StackOverflow、Pinterest、人人、华为、企业微信、酷家乐、Gitlab、美团、饿了么、推特、飞书、京东、阿里云、喜马拉雅、Amazon、Slack和 Line 等第三方平台的授权登录。 Login, so easy!
https://github.com/justauth/JustAuth

googlelogin justauth oauth2 qqlogin weixinlogin

Last synced: about 2 months ago
JSON representation

Host: GitHub
URL: https://github.com/justauth/JustAuth
Owner: justauth
License: mit
Created: 2019-01-31T09:42:20.000Z (almost 6 years ago)
Default Branch: master
Last Pushed: 2024-06-23T15:06:03.000Z (6 months ago)
Last Synced: 2024-07-11T14:03:08.029Z (5 months ago)
Topics: googlelogin, justauth, oauth2, qqlogin, weixinlogin
Language: Java
Homepage: https://www.justauth.cn
Size: 9.13 MB
Stars: 16,215
Watchers: 333
Forks: 2,741
Open Issues: 57
Metadata Files:
- Readme: README.en-US.md
- Changelog: CHANGELOGS.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

awesome - justauth/JustAuth - 🏆Gitee 最有价值开源项目 🚀:100: 小而全而美的第三方登录开源组件。目前已支持Github、Gitee、微博、钉钉、百度、Coding、腾讯云开发者平台、OSChina、支付宝、QQ、微信、淘宝、Google、Facebook、抖音、领英、小米、微软、今日头条、Teambition、StackOverflow、Pinterest、人人、华为、企业微信、酷家乐、Gitlab、美团、饿了么、推特、飞书、京东、阿里云、喜马拉雅、Amazon、Slack和 Line 等第三方平台的授权登录。 Login, so easy! (Java)
awesome-list - JustAuth
my-awesome - justauth/JustAuth - 09 star:16.6k fork:2.8k 🏆Gitee 最有价值开源项目 🚀:100: 小而全而美的第三方登录开源组件。目前已支持Github、Gitee、微博、钉钉、百度、Coding、腾讯云开发者平台、OSChina、支付宝、QQ、微信、淘宝、Google、Facebook、抖音、领英、小米、微软、今日头条、Teambition、StackOverflow、Pinterest、人人、华为、企业微信、酷家乐、Gitlab、美团、饿了么、推特、飞书、京东、阿里云、喜马拉雅、Amazon、Slack和 Line 等第三方平台的授权登录。 Login, so easy! (Java)
awesome-hacking-lists - justauth/JustAuth - 🏆Gitee 最有价值开源项目 🚀:100: 小而全而美的第三方登录开源组件。目前已支持Github、Gitee、微博、钉钉、百度、Coding、腾讯云开发者平台、OSChina、支付宝、QQ、微信、淘宝、Google、Facebook、抖音、领英、小米、微软、今日头条、Teambition、StackOverflow、Pinterest、人人、华为、企业微信、酷家乐、Gitlab、美团、饿了么、 (Java)

README

        


	





	Login, so easy.





	

		

	

	

		

	

	

		

	

	

		

	

	

		

	

	

		

	

	

	  

	

	

		

	



-------------------------------------------------------------------------------







-------------------------------------------------------------------------------

`JustAuth`, as you see, It is just a Java library of third-party authorized login, It's smaller and easier to use. JustAuth is the best third-party login tool written in JAVA.

Source Code：[gitee](https://gitee.com/yadong.zhang/JustAuth) | [github](https://github.com/zhangyd-c/JustAuth)    

Docs：[Reference Doc](https://www.justauth.cn)

## Features

1. **Multiple platform**: Has integrated more than a dozen third-party platforms.([plan](https://gitee.com/yadong.zhang/JustAuth/issues/IUGRK))

2. **Minimalist**: The minimalist design is very simple to use.

## Quick start

### Add maven dependency

- Add JustAuth dependency

These artifacts are available from Maven Central:

```xml

    me.zhyd.oauth

    JustAuth

  {latest-version}

```

> **latest-version** ：

> - CURRENT: ![](https://img.shields.io/github/v/release/justauth/JustAuth?style=flat-square)

> - SNAPSHOT: ![](https://img.shields.io/nexus/s/https/oss.sonatype.org/me.zhyd.oauth/JustAuth.svg?style=flat-square)

- Add http dependency（Only need one）

  

> If there is already in the project, please ignore it. In addition, you need to pay special attention. If the low version of the dependency has been introduced in the project, please exclude the low version of the dependency first, and then introduce the high version or the latest version of the dependency

- hutool-http

  ```xml

  

      cn.hutool

      hutool-http

      5.2.5

  

  ```

- httpclient

  ```xml

  

  	org.apache.httpcomponents

    	httpclient

    	4.5.12

  

  ```

- okhttp

  ```xml

  

    com.squareup.okhttp3

    okhttp

    4.4.1

  

  ```

### Using JustAuth API

#### Simple

```java

// Create authorization request

AuthRequest authRequest = new AuthGiteeRequest(AuthConfig.builder()

        .clientId("clientId")

        .clientSecret("clientSecret")

        .redirectUri("redirectUri")

        .build());

// Generate authorization page url

authRequest.authorize("state");

// Get token and userinfo

authRequest.login(callback);

```

#### Builder 1. Use unchanging `AuthConfig`

```java

// Create authorization request

AuthRequest authRequest = AuthRequestBuilder.builder()

    .source("github")

    .authConfig(AuthConfig.builder()

        .clientId("clientId")

        .clientSecret("clientSecret")

        .redirectUri("redirectUri")

        .build())

    .build();

```

#### Builder 2. Use dynamic `AuthConfig`

```java

// Create authorization request

AuthRequest authRequest = AuthRequestBuilder.builder()

    .source("gitee")

    .authConfig((source) -> {

        // Use source to dynamically get AuthConfig

        // Here you can flexibly take the configuration from sql or take the configuration from the configuration file

        return AuthConfig.builder()

            .clientId("clientId")

            .clientSecret("clientSecret")

            .redirectUri("redirectUri")

            .build();

    })

    .build();

```

#### Builder 3. Support custom platform

```java

AuthRequest authRequest = AuthRequestBuilder.builder()

    // Key point: configure the custom implementation of AuthSource

    .extendSource(AuthExtendSource.values())

    // Enum name in AuthExtendSource

    .source("other")

    // ... Do other things

    .build();

```

## Contributions

1. Fork this project to your repository

2. Clone the project after fork.

3. Modify the code (either to fix issue, or to add new features)

4. Commit and push code to a remote repository

5. Create a new PR (pull request), and select `dev` branch

6. Waiting for author to merge

I look forward to your joining us.

## Contributors

[contributors](https://www.justauth.cn/contributors.html)

## Change Logs

[CHANGELOGS](https://www.justauth.cn/update.html)

## Recommend

- `spring-boot-demo` In-depth study and actual combat of spring boot projects: [https://github.com/xkcoding/spring-boot-demo](https://github.com/xkcoding/spring-boot-demo)

- `mica` Efficient Development of scaffolding by Spring Cloud: [https://github.com/lets-mica/mica](https://github.com/lets-mica/mica)

- `pig` Cosmic strongest Micro Services Certified authorized scaffolding (essential for Architects): [https://gitee.com/log4j/pig](https://gitee.com/log4j/pig)

- `SpringBlade` Complete online solution (necessary for enterprise development): https://gitee.com/smallc/SpringBlade

## References

- [The OAuth 2.0 Authorization Framework](https://tools.ietf.org/html/rfc6749)

- [OAuth 2.0](https://oauth.net/2/)