OIDC 认证接入

下面以 keycloak 为例，介绍在觅思文档中接入 OIDC 认证。

## Keycloak 配置

### 领域

在此演示环境中，我们新建了一个名为「mrdoc」的领域：

![](http://file.mrdoc.pro/mrdoc-oss/img/2025/02/26/8c66e0594f474950a63ae96754bca95d7632.png)

### 客户端

然后在「mrdoc」这个领域里面新建一个「OpenID Connect」类型的客户端，客户端ID设置为「mrdoc-oidc」

![](http://file.mrdoc.pro/mrdoc-oss/img/2025/02/26/719825e1f7514824914f9fa604b798501520.png)

然后对 mrdoc-oidc 这个客户端进行配置。

在「访问设置」中填入你的觅思文档相关URL

![](http://file.mrdoc.pro/mrdoc-oss/img/2025/02/26/346b6d4f145c4658814e12747c42a0a33804.png)

在「功能设置」中，启用「客户端认证」和「授权」

![](http://file.mrdoc.pro/mrdoc-oss/img/2025/02/26/d1d1bff76f764b21a0a231aeaafaec8a8335.png)

设置好之后，进行保存。

### 客户端凭证

在 mrdoc-oidc 客户端配置页面切换到「凭证」选项卡，获取「客户端密码」以备用：

![](http://file.mrdoc.pro/mrdoc-oss/img/2025/02/26/18b08592a9cc4f098692209db2a04d194145.png)

## 觅思文档配置

进入后台管理页面的「第三方登录」切换到「OIDC」选项卡，点击「新增OIDC提供商」按钮：

![](http://file.mrdoc.pro/mrdoc-oss/img/2025/02/26/b5e7cc8723ee4589a0640732163e820b5092.png)

在弹出框内输入 OIDC 提供商的相应信息：

![](http://file.mrdoc.pro/mrdoc-oss/img/2025/02/26/3314d5b922a24a1fb1d3ea789c72994e8401.png)

其中：

- 名称：用来标识 OIDC提供商，在觅思文档内需唯一。
- 客户端ID：就是 keycloak 内新建的客户端ID。
- 客户端密钥，就是 keycloak 内客户端「凭证」选项卡里面的「客户端密码」。
- 元数据URL：在 keycloak 中元数据URL通常为：`{OIDC服务URL}/realms/{领域名称}/.well-known/openid-configuration`

所以，根据上面 keycloak 的配置，在此配置 OIDC 提供商的信息为：

![](http://file.mrdoc.pro/mrdoc-oss/img/2025/02/26/0c93c7efb88e4be0bacab313822792875543.png)

配置好之后，在觅思文档的登录页面会显示一个 OIDC 登录图标：

![](http://file.mrdoc.pro/mrdoc-oss/img/2025/02/26/64272fe3c2684654920aed00aa26682e6040.png)

点击它就会跳转到 OIDC 提供商的认证地址：

![](http://file.mrdoc.pro/mrdoc-oss/img/2025/02/26/cd842148b08c4609a235013fae3939343955.png)

输入 OIDC 服务中的账号信息即可进行登录并跳转回觅思文档。