README.zh.md

快速实现网页应用免登

如果需要开发一款在浏览器获取已登录飞书用户信息的网页应用，可以参考本示例。本示例作为网页应用入门示例，介绍如何使用飞书开放平台提供的身份验证能力完成第三方网页免登、获取已登录用户信息。

运行环境

• Python 3

准备工作

1、在开发者后台 点击创建企业自建应用，创建成功之后，点击应用名称打开应用，点击凭证与基础信息切换页面，拿到 App ID 和 App Secret 信息。

2、点击安全设置切换页面，添加重定向 URL，配置重定向 url 白名单为 http://127.0.0.1:3000/callback 即可。 注意：此处配置的重定向URL列表是该应用的重定向 url 白名单，重定向 URL 未配会在登录重定向时报错。

3、点击网页切换页面，打开启用网页按钮，修改网页配置，填写桌面端主页和移动端主页都为 http://127.0.0.1:3000 即可。

4、点击版本管理与发布，创建版本并发布上线

• 点击创建版本，填写发版必须内容，点击保存 注意：仅可用性范围内用户能够打开应用。

• 点击申请发布，应用即时上线生效。

5、拉取最新代码到本地，并进入对应目录

git clone https://github.com/larksuite/lark-samples.git
cd lark-samples/web_app_with_auth/python

6、修改环境值

修改.env文件中应用凭证数据为真实数据。

APP_ID=cli_9fxxxx00b
APP_SECRET=EX6xxxxOF

以上两个参数可以在开发者后台 点击凭证与基础信息查看。

重定向 url 配置需要包含 .env 文件中CALLBACK_URL的值，否则登录成功后重定向会报错。

CALLBACK_URL=http://127.0.0.1:3000/callback

docker 运行

运行之前需要确保 Docker 已经安装。docker运行与下方本地运行二选一即可。

mac/linux

sh exec.sh

windows

.\exec.ps1

运行起来之后直接访问 http://127.0.0.1:3000 ，按照链接指示扫码/授权登录即可，登录成功之后，即可看到用户信息。

本地运行

1、创建并激活一个新的虚拟环境

mac/linux

python3 -m venv venv
. venv/bin/activate

windows

python3 -m venv venv
venv\Scripts\activate

激活后，终端会显示虚拟环境的名称

(venv) **** python %

2、安装依赖

pip install -r requirements.txt

3、运行

python3 server.py

运行起来之后直接访问 http://127.0.0.1:3000 ，按照链接指示扫码/授权登录即可，登录成功之后，即可看到用户信息。

飞书客户端内体验网页应用

飞书>工作台> 搜索应用名称> 打开应用。