You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
---
title: 在 LobeChat 中配置 Github 身份验证服务
description: 学习如何在 LobeChat 中配置 Github 身份验证服务，包括创建新的 Github App、设置权限和环境变量。
tags:
- Github 身份验证
- Github App
- 环境变量配置
- 单点登录
- LobeChat
---
# 配置 Github 身份验证服务
## Github 配置流程
< Steps >
### 创建 Github 提供应用
点击 [这里 ](https://github.com/settings/apps/new ) 创建一个新的 Github App。
填写 Github App name、Homepage URL、Callbak URL
< Image
alt = "创建 Github 提供程序"
inStep
src = "https://github.com/lobehub/lobe-chat/assets/64475363/2f919f99-2aaa-4fa7-9938-169d3ed09db7"
/>
按照自己所需设置Webhook回调地址
< Image
alt = "填写其他字段"
inStep
src = "https://github.com/lobehub/lobe-chat/assets/64475363/d7ef5ad1-b1a3-435e-b1bc-4436d2b6fecd"
/>
设置读取邮件地址权限
< Image
alt = "设置所需权限"
inStep
src = "https://github.com/lobehub/lobe-chat/assets/64475363/23131ca1-9e84-4a89-a840-ef79c4bc0251"
/>
< Image
alt = "设置读取邮件地址权限"
inStep
src = "https://github.com/lobehub/lobe-chat/assets/64475363/358bca8d-3d82-4e76-9a5e-90d16a39efde"
/>
设置公开访问还是仅自己访问
< Image
alt = "设置公开访问还是仅自己访问"
inStep
src = "https://github.com/lobehub/lobe-chat/assets/64475363/995780cb-9096-4a36-ab17-d422703ab970"
/>
点击「Create Github App」
创建成功后，
< Image
alt = "创建新的客户端密钥"
inStep
src = "https://github.com/lobehub/lobe-chat/assets/64475363/6d69bdca-7d18-4cbc-b3e0-220d8815cd29"
/>
创建成功后， 将 `客户端 ID` 和 `客户端 Secret` 保存下来。
< Image
alt = "创建新的客户端密钥"
inStep
src = "https://github.com/lobehub/lobe-chat/assets/64475363/c6108133-a918-48b0-ab1a-e3fa607572a4"
/>
### 配置环境变量
在部署 LobeChat 时，你需要配置以下环境变量：
| 环境变量 | 类型 | 描述 |
| --- | --- | --- |
| `NEXT_AUTH_SECRET` | 必选 | 用于加密 Auth.js 会话令牌的密钥。您可以使用以下命令生成秘钥： `openssl rand -base64 32` |
| `NEXT_AUTH_SSO_PROVIDERS` | 必选 | 选择 LoboChat 的单点登录提供商。使用 Github 请填写 `github` 。 |
| `AUTH_GITHUB_ID` | 必选 | Github App详情页的 客户端 ID |
| `AUTH_GITHUB_SECRET` | 必选 | Github App详情页的 客户端 Secret |
| `NEXTAUTH_URL` | 必选 | 该 URL 用于指定 Auth.js 在执行 OAuth 验证时的回调地址，当默认生成的重定向地址发生不正确时才需要设置。`https://example.com/api/auth` |
< Callout type = {'tip'} >
前往 [📘 环境变量 ](/zh/docs/self-hosting/environment-variables/auth#github ) 可查阅相关变量详情。
</ Callout >
</ Steps >
< Callout type = {'info'} > 部署成功后， </ Callout >
