Authing 文档文档
快速开始
概念
使用指南
开发集成 V2 arrow
  • V2 文档
  • V3 文档
应用集成
加入 APN
开发集成
多租户(内测版)
控制台文档
多租户控制台
租户控制台
Saas 应用 Demo
快速开始
概念
使用指南
开发集成 V2 arrow
  • V2 文档
  • V3 文档
应用集成
加入 APN
开发集成
多租户(内测版)
控制台文档
多租户控制台
租户控制台
Saas 应用 Demo
旧版
开发集成
  • JavaScript SDK 索引
  • 单点登录(SSO)
  • 登录组件 (Guard)

  • JavaScript / Node.js

  • Java / Kotlin

  • Python

  • C#

  • PHP

  • Go

  • Ruby
  • Delphi
  • Android

    • 快速开始
    • 托管页
    • 超组件

    • APIs

    • 第三方身份源

      • 微信登录
      • 支付宝登录
      • 手机号一键登录
      • Google 登录
      • Facebook 登录
      • APP 拉起微信小程序登录
      • 腾讯 QQ 登录
      • 新浪微博登录
      • 百度登录
      • Linkedin 登录
      • Github 登录
      • Gitee 登录
      • 企业微信登录
      • 飞书登录
      • 钉钉登录
    • 典型场景

    • 私有化部署
    • Android Guard 更新日志
    • 返回码对照表
  • iOS

  • Flutter

  • 微信小程序
  • 微信网页授权
  • React Native
  • 框架集成

  • Radius
  • 错误代码

¶ 飞书登录

更新时间: 2023-03-19 15:57:17
编辑

¶ 准备工作

企业自建应用在飞书开发者后台 (opens new window) 及 Authing Console 控制台 (opens new window)进行配置,请参阅飞书企业自建应用 (opens new window)。


¶ 集成飞书登录步骤

¶ 第一步:添加依赖

  • 下载飞书授权 sdk 库 (opens new window);
  • 将下载的 sdk aar 文件拷贝到 app/libs 目录下;
  • 在 app 的 build.gradle 文件中引入该 aar,引入相关依赖项。
implementation 'cn.authing:guard:+'
implementation files ('libs/larksso-3.0.8.aar')
implementation 'com.alibaba:fastjson:1.1.58.android'

Guard 只是 compileOnly 依赖飞书,这样可以让 App 按需引入,防止 Guard aar 包随着支持的第三方登录增加而越来越大。所以每增加一个第三方身份源,都需要 App 手动加上该身份源的依赖

¶ 第二步:初始化 Guard Android SDK

在应用启动的时候初始化:

// context is application or initial activity
// ”AUTHING_APP_ID“ is obtained from the Authing console
Authing.init(context, "AUTHING_APP_ID");
Authing.setAuthProtocol(Authing.AuthProtocol.EOIDC)

通过以上步骤即可简单快速的通过 Authing 管理控制台配置后自动获取飞书身份源,登录入口会在 Guard 内置登录界面的社会化登录按钮列表中体现

  • 接下来,如果使用我们提供的飞书登录按钮,则在布局文件里面加上(或者代码初始化添加)
<cn.authing.guard.social.view.LarkLoginButton
    android:id="@+id/btn_lark_login"
    android:layout_width="48dp"
    android:layout_height="48dp" />

然后在 java 代码里面处理事件

LarkLoginButton button = findViewById(R.id.btn_lark_login);
button.setOnLoginListener(new AuthCallback<UserInfo>() {
    @Override
    public void call(int code, String message, UserInfo data) {
      	if (code == 200) {
        	// 登录成功,data 是用户信息
       	} else {
        	// 登录失败
      	}
    }
});

  • 如果不想使用我们内置的按钮,则可以在自己按钮的点击事件里面调用 Authing 飞书登录授权类
Lark lark = new Lark();
lark.login(appContext, new AuthCallback<UserInfo>() {
    @Override
    public void call(int code, String message, UserInfo data) {
        if (code == 200) {
          // 登录成功,data 是用户信息
        } else {
          // 登录失败
        }
    }
});

data 包含 idToken 以及用户信息(用户名、昵称、姓名等)。

注意:使用飞书登录按钮或者飞书登录授权类时,需要在 Activity 的 onResume、onNewIntent、onActivityResult 函数中加入如下代码:

@Override
protected void onResume() {
    super.onResume();
    try {
        Class.forName("com.ss.android.larksso.LarkSSO");
        LarkSSO.inst().parseIntent(this, getIntent());
    } catch( ClassNotFoundException e ) {
    }
}

@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    try {
        Class.forName("com.ss.android.larksso.LarkSSO");
        LarkSSO.inst().parseIntent(this, intent);
    } catch( ClassNotFoundException e ) {
    }
}

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    try {
        Class.forName("com.ss.android.larksso.LarkSSO");
        LarkSSO.inst().parseIntent(this, data);
    } catch( ClassNotFoundException e ) {
    }
}

  • 如果想完全自己实现飞书登录,拿到授权码后,可以调用下面 API 换取用户信息
public static void loginByLark(String authCode, @NotNull AuthCallback<UserInfo> callback)

参数

authCode 飞书授权码

示例

如果你只需要获取到用户信息(用户名、昵称、姓名等)和 idToken,调用:

AuthClient.loginByLark(authCode, new AuthCallback<UserInfo>() {
    @Override
    public void call(int code, String message, UserInfo data) {
        if (code == 200) {
          // 登录成功,data 是用户信息, 包含 idToken。
        } else {
          // 登录失败
        }
    }
});

如果你需要获取到用户信息(用户名、昵称、姓名等)、idToken、accessToken 和 refreshToken,调用:

OIDCClient oidcClient = new OIDCClient();
oidcClient.loginByLark(authCode, new AuthCallback<UserInfo>() {
    @Override
    public void call(int code, String message, UserInfo data) {
        if (code == 200) {
          // 登录成功,data 是用户信息, 包含 idToken、accessToke and refreshToken。
        } else {
          // 登录失败
        }
    }
});
上一篇: 企业微信登录 下一篇: 钉钉登录
  • 准备工作
  • 集成飞书登录步骤

用户身份管理

集成第三方登录
手机号闪验 (opens new window)
通用登录表单组件
自定义认证流程

企业内部管理

单点登录
多因素认证
权限管理

开发者

开发文档
框架集成
博客 (opens new window)
GitHub (opens new window)
社区用户中心 (opens new window)

公司

400 888 2106
sales@authing.cn
北京市朝阳区北辰世纪中心 B 座 16 层(总)
成都市高新区天府五街 200 号 1 号楼 B 区 4 楼 406 室(分)

京ICP备19051205号

beian京公网安备 11010802035968号

© 北京蒸汽记忆科技有限公司