# 第三方登录

从 Blessing Skin v5 起，我们提供了基于 OAuth2 的第三方登录功能，并以插件的形式实现。借助这些插件，您的用户不需要注册，也不需要输入密码登录，而是利用他们在其它网站或平台上的账号即可直接访问皮肤站。

# 基本

首先要在插件市场安装「OAuth 客户端核心」插件，所有的第三方登录功能都依赖于这个插件。

# Microsoft Live

# 注册应用

打开 Microsoft Azure (opens new window)，点击「更多服务」：

随后搜索「应用注册」，并点击进入：

点击页面中的「注册应用程序」：

然后填写「名称」和「重定向 URI」：

其中「名称」可以填写为您的皮肤站名称；「重定向 URI」则根据您的皮肤站地址相应地修改域名，但后面的 /auth/login/live/callback 不需要改变。

在添加「品牌打造和属性」的页面有一个「验证发布者域」的东西，需要在 Web 服务器中创建 /.well-known/microsoft-identity-association.json 文件。对于 Apache 用户，要注意 public/.htaccess 文件声明了禁止对 . 开头的目录或文件的访问。因此需要编辑这个文件，在 RewriteRule (^\.|/\.) - [F] 上面加一行 RewriteRule ^\.well-known/microsoft-identity-association\.json$ - [L]：

<IfModule mod_rewrite.c>
    <IfModule mod_negotiation.c>
        Options -MultiViews -Indexes
    </IfModule>

    RewriteEngine On

    # You may need to uncomment the following line for some hosting environments,
    # if you have installed to a subdirectory, enter the name here also.
    #
    # RewriteBase /

    # Black list protected files
+   RewriteRule ^\.well-known/microsoft-identity-association\.json$ - [L]
    RewriteRule (^\.|/\.) - [F]
    RewriteRule ^storage/.* - [F]

    # 后面省略……

填写完成后点击页面下方的「注册」按钮，并稍等片刻。注册完成后，将得到「应用程序（客户端）ID」，将它复制下来。

# 创建密码

在随后出现的页面中，选择页面左侧的「证书和密码」，并点击「+ 新客户端密码」。

在表单中将「截止期限」设置为「从不」，「说明」可以填写也可以不填：

接着点击「添加」。此时将得到「客户端密码」：

注意：这个密码只会出现一次，所以必须把它复制下来。

# 安装插件

进入 Blessing Skin 的插件市场，下载安装并开启「使用 Microsoft Live 登录」插件。

# 配置插件

插件的配置通过修改 .env 文件来进行。在 .env 文件中添加以下三项配置：

LIVE_KEY - 应用程序（客户端）ID（注册时由 Azure 自动生成）
LIVE_SECRET - 客户端密码（我们已经在前面添加过一个）
LIVE_REDIRECT_URI - 与我们在注册应用程序时填写的「重定向 URI」相同

根据我们在前面操作的结果，可以像这样填写：（请根据您的实际情况进行修改）

LIVE_KEY=f53c3e81-5973-408d-80cd-e603c91caa34
LIVE_SECRET=uC00c-GnlIF199Nw34-K_A~T6sWQmQnW-S
LIVE_REDIRECT_URI=https://localhost/auth/login/live/callback

# 完成

用户在注册或登录时，即可选择「Microsoft Live」来登录：

# LittleSkin

# 创建应用

在「用户中心」点击「高级功能」菜单下的「OAuth2 应用」：

点击「创建应用」按钮，并填写表单：

其中「应用名」可以填写为您的皮肤站名称；「回调 URL」则根据您的皮肤站地址相应地修改域名，但后面的 /auth/login/littleskin/callback 不需要改变。

点击「确定」，随后可以看到刚刚创建的应用：

# 安装插件

进入 Blessing Skin 的插件市场，下载安装并开启「使用 LittleSkin 登录」插件。

# 配置插件

插件的配置通过修改 .env 文件来进行。在 .env 文件中添加以下三项配置：

LITTLESKIN_KEY - 客户端 ID
LITTLESKIN_SECRET - 客户端 Secret
LITTLESKIN_REDIRECT_URI - 回调 URL

根据我们在前面操作的结果，可以像这样填写：（请根据您的实际情况进行修改）

LITTLESKIN_KEY=53
LITTLESKIN_SECRET=bgkA4FJy8biGPX33XYMhbbhAIgXHwNhUNvFg6whU
LITTLESKIN_REDIRECT_URI=https://localhost/auth/login/littleskin/callback

# 完成

用户在注册或登录时，即可选择「LittleSkin」来登录：

# GitHub

# 注册应用

打开 GitHub，进入设置页面，然后点击左侧栏中的「Developer settings」：

在随后的页面中点击左侧栏的「OAuth Apps」：

点击「Register a new application」，并填写表单：

其中，「Application name」填写为您的皮肤站名称；「Homepage URL」为您的皮肤站首页 URL；「Authorization callback URL」则根据您的皮肤站地址相应地修改域名，但后面的 /auth/login/github/callback 不需要改变。

点击「Register application」并继续。此时将获得 Client ID 和 Client Secret：

# 安装插件

进入 Blessing Skin 的插件市场，下载安装并开启「使用 GitHub 登录」插件。

# 配置插件

插件的配置通过修改 .env 文件来进行。在 .env 文件中添加以下三项配置：

GITHUB_KEY - 对应 GitHub 提供的「Client ID」
GITHUB_SECRET - 对应 GitHub 提供的「Client Secret」
GITHUB_REDIRECT_URI - 对应我们刚刚填写的「Authorization callback URL」

根据我们在前面操作的结果，可以像这样填写：（请根据您的实际情况进行修改）

GITHUB_KEY=44551e99fbe2ad35d411
GITHUB_SECRET=65409736106e5fb47eace316dc1b62309f580e47
GITHUB_REDIRECT_URI=https://localhost/auth/login/github/callback

# 完成

用户在注册或登录时，即可选择「GitHub」来登录：

← 皮肤站 CDN 配置与 Flarum 联动 →