推薦一個小而全的第三方登錄開源組件

来源:https://www.cnblogs.com/codechen8848/archive/2023/12/14/17900940.html
-Advertisement-
Play Games

大家好，我是 Java陳序員。 我們在企業開發中，常常需要實現登錄功能，而有時候為了方便，就需要集成第三方平臺的授權登錄。如常見的微信登錄、微博登錄等，免去了用戶註冊步驟，提高了用戶體驗。 為了業務考慮，我們有時候集成的不僅僅是一兩個第三方平臺，甚至更多。這就會大大的提高了工作量，那麼有沒有開源框架 ...


大家好，我是 Java陳序員。

我們在企業開發中，常常需要實現登錄功能，而有時候為了方便，就需要集成第三方平臺的授權登錄。如常見的微信登錄、微博登錄等，免去了用戶註冊步驟，提高了用戶體驗。

為了業務考慮，我們有時候集成的不僅僅是一兩個第三方平臺，甚至更多。這就會大大的提高了工作量，那麼有沒有開源框架來統一來集成這些第三方授權登錄呢？

答案是有的，今天給大家介紹的項目提供了一個第三方授權登錄的工具類庫！

項目介紹

JustAuth —— 一個第三方授權登錄的工具類庫，可以讓你脫離繁瑣的第三方登錄 SDK，讓登錄變得So easy!

JustAuth

JustAuth 集成了諸如：Github、Gitee、微博、釘釘、百度、Coding、騰訊雲開發者平臺、OSChina、支付寶、QQ、微信、淘寶、Google、Facebook、抖音、領英、小米、微軟、今日頭條、Teambition、StackOverflow、Pinterest、人人、華為、企業微信、酷家樂、Gitlab、美團、餓了麽、推特、飛書、京東、阿裡雲、喜馬拉雅、Amazon、Slack和 Line 等第三方平臺的授權登錄。

功能特色：

  • 豐富的 OAuth 平臺：支持國內外數十家知名的第三方平臺的 OAuth 登錄。
  • 自定義 state：支持自定義 State 和緩存方式，開發者可根據實際情況選擇任意緩存插件。
  • 自定義 OAuth：提供統一介面，支持接入任意 OAuth 網站，快速實現 OAuth 登錄功能。
  • 自定義 Http：介面 HTTP 工具，開發者可以根據自己項目的實際情況選擇相對應的HTTP工具。
  • 自定義 Scope：支持自定義 scope，以適配更多的業務場景，而不僅僅是為了登錄。
  • 代碼規範·簡單：JustAuth 代碼嚴格遵守阿裡巴巴編碼規約，結構清晰、邏輯簡單。

安裝使用

回顧 OAuth 授權流程

參與的角色

  • Resource Owner 資源所有者，即代表授權客戶端訪問本身資源信息的用戶（User），也就是應用場景中的“開發者A”
  • Resource Server 資源伺服器，托管受保護的用戶賬號信息，比如 Github
    Authorization Server 授權伺服器，驗證用戶身份然後為客戶端派發資源訪問令牌，比如 Github
  • Resource Server 和 Authorization Server 可以是同一臺伺服器，也可以是不同的伺服器，視具體的授權平臺而有所差異
  • Client 客戶端，即代表意圖訪問受限資源的第三方應用

授權流程

OAuth 授權流程

使用步驟

1、申請註冊第三方平臺的開發者賬號

2、創建第三方平臺的應用，獲取配置信息(accessKey, secretKey, redirectUri)

3、使用 JustAuth 實現授權登陸

引入依賴

<dependency>
    <groupId>me.zhyd.oauth</groupId>
    <artifactId>JustAuth</artifactId>
    <version>{latest-version}</version>
</dependency>

調用 API

// 創建授權request
AuthRequest authRequest = new AuthGiteeRequest(AuthConfig.builder()
        .clientId("clientId")
        .clientSecret("clientSecret")
        .redirectUri("redirectUri")
        .build());
// 生成授權頁面
authRequest.authorize("state");
// 授權登錄後會返回code（auth_code（僅限支付寶））、state，1.8.0版本後，可以用AuthCallback類作為回調介面的參數
// 註：JustAuth預設保存state的時效為3分鐘，3分鐘內未使用則會自動清除過期的state
authRequest.login(callback);

說明：
JustAuth 的核心就是一個個的 request，每個平臺都對應一個具體的 request 類。
所以在使用之前，需要就具體的授權平臺創建響應的 request.如示例代碼中對應的是 Gitee 平臺。

集成國外平臺

國外平臺需要額外配置 httpConfig

AuthRequest authRequest = new AuthGoogleRequest(AuthConfig.builder()
                .clientId("Client ID")
                .clientSecret("Client Secret")
                .redirectUri("應用回調地址")
                // 針對國外平臺配置代理
                .httpConfig(HttpConfig.builder()
                        // Http 請求超時時間
                        .timeout(15000)
                        // host 和 port 請修改為開發環境的參數
                        .proxy(new Proxy(Proxy.Type.HTTP, new InetSocketAddress("127.0.0.1", 10080)))
                        .build())
                .build());

SpringBoot 集成

引入依賴

<dependency>
  <groupId>com.xkcoding.justauth</groupId>
  <artifactId>justauth-spring-boot-starter</artifactId>
  <version>1.4.0</version>
</dependency>

配置文件

justauth:
  enabled: true
  type:
    QQ:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/qq/callback
      union-id: false
    WEIBO:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/weibo/callback
    GITEE:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/gitee/callback
    DINGTALK:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/dingtalk/callback
    BAIDU:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/baidu/callback
    CSDN:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/csdn/callback
    CODING:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/coding/callback
      coding-group-name: xx
    OSCHINA:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/oschina/callback
    ALIPAY:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/alipay/callback
      alipay-public-key: MIIB**************DAQAB
    WECHAT_OPEN:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/wechat_open/callback
    WECHAT_MP:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/wechat_mp/callback
    WECHAT_ENTERPRISE:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/wechat_enterprise/callback
      agent-id: 1000002
    TAOBAO:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/taobao/callback
    GOOGLE:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/google/callback
    FACEBOOK:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/facebook/callback
    DOUYIN:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/douyin/callback
    LINKEDIN:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/linkedin/callback
    MICROSOFT:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/microsoft/callback
    MI:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/mi/callback
    TOUTIAO:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/toutiao/callback
    TEAMBITION:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/teambition/callback
    RENREN:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/renren/callback
    PINTEREST:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/pinterest/callback
    STACK_OVERFLOW:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/stack_overflow/callback
      stack-overflow-key: asd*********asd
    HUAWEI:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/huawei/callback
    KUJIALE:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/kujiale/callback
    GITLAB:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/gitlab/callback
    MEITUAN:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/meituan/callback
    ELEME:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/eleme/callback
    TWITTER:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/twitter/callback
    XMLY:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/xmly/callback
      # 設備唯一標識ID
      device-id: xxxxxxxxxxxxxx
      # 客戶端操作系統類型，1-iOS系統，2-Android系統，3-Web
      client-os-type: 3
      # 客戶端包名，如果 clientOsType 為1或2時必填。對Android客戶端是包名，對IOS客戶端是Bundle ID
      #pack-id: xxxx
    FEISHU:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/feishu/callback
    JD:
      client-id: 10**********6
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: http://oauth.xkcoding.com/demo/oauth/jd/callback
  cache:
    type: default

代碼使用

@Slf4j
@RestController
@RequestMapping("/oauth")
@RequiredArgsConstructor(onConstructor_ = @Autowired)
public class TestController {
    private final AuthRequestFactory factory;

    @GetMapping
    public List<String> list() {
        return factory.oauthList();
    }

    @GetMapping("/login/{type}")
    public void login(@PathVariable String type, HttpServletResponse response) throws IOException {
        AuthRequest authRequest = factory.get(type);
        response.sendRedirect(authRequest.authorize(AuthStateUtils.createState()));
    }

    @RequestMapping("/{type}/callback")
    public AuthResponse login(@PathVariable String type, AuthCallback callback) {
        AuthRequest authRequest = factory.get(type);
        AuthResponse response = authRequest.login(callback);
        log.info("【response】= {}", JSONUtil.toJsonStr(response));
        return response;
    }

}

總結

JustAuth 集成的第三方授權登錄平臺，可以說是囊括了業界中大部分主流的應用系統。如國內的微信、微博、Gitee 等，還有國外的 Github、Google 等。可以滿足我們日常的開發需求，開箱即用，可快速集成！

最後，貼上項目地址：

https://github.com/justauth/JustAuth

線上文檔：

https://www.justauth.cn/

最後

推薦的開源項目已經收錄到 GitHub 項目，歡迎 Star：

https://github.com/chenyl8848/great-open-source-project

或者訪問網站，進行線上瀏覽：

https://chencoding.top:8090/#/

大家的點贊、收藏和評論都是對作者的支持，如文章對你有幫助還請點贊轉發支持下，謝謝！


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • Chrome擴展的核心：manifest 文件（中）
    在 Chrome 擴展開發中，manifest 文件是項目的核心，其中 "content_scripts"，"background"，"permissions" 配置項又至關重要！ ...
  • 京東哥倫布即時設計平臺ChatGPT落地實踐
    即時設計平臺是一個即時搭建c端樓層的開發平臺，支持通過導入relay設計稿url完成Ui2Code，在此基礎上完成前端可視化搭建，同時支持通過ChatGPT完成一句話需求，搭建後的樓層自動同步ihub樓層市場，提供到通天塔、哥倫布等搭建平臺使用。 ...
  • 你寫的防止任意文件上傳漏洞的代碼，不一定安全
    說明：任意文件上傳漏洞，很多PHP開發者也會做一些簡單的防護，但是這個防護有被繞過的可能。 原生漏洞PHP示例代碼： $file = $_FILES['file'] ?? []; //檢測文件類型 $allow_mime = ['image/jpg', 'image/jpeg', 'image/pn ...
  • 消息通知(Notification)/用戶觸達系統設計
    近年來，通知功能已經成為許多應用程式中突出的特性。構建一個能每天發送數百萬通知的可擴展系統絕非易事。這正是為什麼我覺得有必要記錄我在這方面踩坑之路。也叫用戶觸達系統。 完成這項任務要求對通知生態系統有深刻的理解，否則需求很容易變得模糊和不明確。 1 瞭解通知系統並確定設計範圍 通知是用於向用戶提供重 ...
  • C 語言註釋和變數詳解
    C 語言中的註釋 C語言中可以使用註釋來解釋代碼並使其更具可讀性。它還可以在測試替代代碼時防止執行。 單行註釋 單行註釋以兩個斜杠 (//) 開頭。 // 和行末之間的任何文本都會被編譯器忽略（不會被執行）。 此示例在代碼行之前使用單行註釋： // 這是一個註釋 printf("Hello Worl ...
  • Selenium系列知識點整理--個人總結
    Selenium系列知識點整理 https://www.cnblogs.com/yoyoketang/ 本文摘錄於‘上海-悠悠’的博客，網址如上 新手學習selenium路線圖（老司機親手繪製)-學前篇 學習selenium主要分六個階段，自己在哪個層級，可以對號入座下。第 一階段：幼兒園 1.選語 ...
  • C++和QML混合編程
    在Qt中，ComboBox（組合框）是一種常用的用戶界面控制項，它提供了一個下拉列表，允許用戶從預定義的選項中選擇一個。該組件提供了一種方便的方式讓用戶從預定義的選項中進行選擇，一般來說`ComboBox`會以按鈕的形式顯示在界面上，用戶點擊按鈕後，會彈出一個下拉列表，其中包含預定義的選項。當然`Co... ...
  • 別再重覆造反射輪子了，Spring 中的 ReflectionUtils 工具類，應有盡有！
    作者：策馬踏清風 鏈接：https://www.jianshu.com/p/756778f5dc87 ReflectionUtils是spring針對反射提供的工具類。 handleReflectionException異常處理 推薦一個開源免費的 Spring Boot 實戰項目： https:/ ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類