社交登录

支持通过 Telegram、OAuth 或 OpenID 创建用户和登录

对于 OAuth，你必须为特定提供商创建应用。如果指定了应用 ID，登录按钮将出现在登录页面上。设置位于设置页面的"社交登录"部分。

安装

以管理员身份登录到你的 NextCloud 安装，在"应用"下点击"社交登录"应用旁边的"下载并启用"。

请参阅下面的设置和配置说明。

自定义 OAuth2/OIDC 群组

你可以使用自定义提供商的群组。为此，你应该在自定义 OAuth2/OIDC 提供商设置中指定"群组声明"。该声明应该由提供商在 id_token 中返回或在用户信息端点返回。格式应为 array 或逗号分隔的字符串。例如（使用名为 roles 的声明）

{"roles": ["admin", "user"]}

或

{"roles": "admin,user"}

还支持嵌套声明。例如 resource_access.client-id.roles 用于

"resource_access": {
   "client-id": {
     "roles": [
       "client-role-1",
       "client-role-2"
     ]
   }
}

还支持设置显示名称：

{"roles": [{gid: 1, displayName: "admin"}, {gid: 2, displayName: "user"}]}

你可以通过两种方式使用提供商群组：

将提供商群组映射到现有的 nextcloud 群组
在 nextcloud 中创建提供商群组并将其关联到用户（如果指定了相应选项）

如果你想在每次登录时同步群组，请不要忘记勾选"每次登录时更新用户资料"设置

群组示例

你可以在这里找到如何配置 WSO2IS 以使用 OIDC 返回角色声明的示例
GitLab OIDC 允许特定 GitLab 群组

内置 OAuth 提供商

你可以复制特定登录按钮的链接以获取 OAuth 应用设置的正确"重定向 URL"。

Google
Amazon
Facebook
Twitter
GitHub
Discord
Telegram
PlexTv - 你可以使用任何标题作为应用 ID
Codeberg

关于 Google 设置中"仅允许指定域名登录"的详细信息，你可以在这里找到 #44 你可以使用逗号分隔列表来指定多个域名

配置

你可以在 config.php 中使用 'social_login_auto_redirect' => true 设置，以便在只配置了一个提供商时自动将未授权用户重定向到社交登录。如果你想临时禁用此功能（例如，以本地管理员身份登录），你可以在登录页面的 URL 中添加 noredir=1 查询参数。例如 https://cloud.domain.com/login?noredir=1

要为 HTTP 客户端设置选项，你可以在 config.php 中使用

  'social_login_http_client' => [
    'timeout' => 45,
    'proxy' => 'socks4://127.0.0.1:9050', // 查看 https://curl.se/libcurl/c/CURLOPT_PROXY.html 了解允许的变体
  ],

通过命令行配置提供商

你可以使用 occ 实用程序从命令行配置所有内容。要设置 oidc 提供商，请将变量和 URL 替换为与你的部署匹配的值。

php occ config:app:set sociallogin custom_providers --value='{"custom_oidc": [{"name": "gitlab_oidc", "title": "Gitlab", "authorizeUrl": "https://gitlab.my-domain.org/oauth/authorize", "tokenUrl": "https://gitlab.my-domain.org/oauth/token", "userInfoUrl": "https://gitlab.my-domain.org/oauth/userinfo", "logoutUrl": "", "clientId": "$my_application_id", "clientSecret": "$my_super_secret_secret", "scope": "openid", "groupsClaim": "groups", "style": "gitlab", "defaultGroup": ""}]}'

要在 Docker 中执行此操作，只需在命令前面添加 docker exec -t -uwww-data CONTAINER_NAME，或从 docker exec -it -uwww-data CONTAINER_NAME sh 交互式运行

要了解如何配置其他提供商，只需在 GUI 中配置它们，然后查看数据库：

mysql -u nextcloud -p nextcloud
Password: <yourpassword>

> SELECT * FROM oc_appconfig WHERE appid='sociallogin';

或者只需运行

docker exec -t -uwww-data CONTAINER_NAME php occ config:app:get sociallogin custom_providers

配置 Discord

要正确配置 Discord，你必须：

在 DiscordApp 开发者上创建新的 Discord 应用
打开 Settings -> OAuth2 -> General 标签。在 Redirects 中添加新的重定向链接，如：https://nextcloud.mydomain.com/apps/sociallogin/oauth/discord。
复制 CLIENT ID 并生成并复制 CLIENT SECRET
在 Nextcloud 中打开 Settings -> Social Login，将 CLIENT ID 粘贴到 App id 字段，将 CLIENT SECRET 粘贴到 Secret 字段。
选择以这种方式创建的用户的默认群组。
关于群组映射，请查看 #395

提示

关于回调（回复）URL

你可以从登录页面上特定登录按钮复制链接，并将其粘贴到提供商的网站上作为回调 URL。要使正确的按钮可见，只需用随机数据填写特定提供商设置，然后稍后更改。

即使你粘贴了正确的 URL，一些用户可能仍会从提供商那里收到奇怪的回复（回调）URL 错误，这是因为你的 nextcloud 服务器可能会生成 http URL，而你实际上使用的是 https。请在你的 config.php 文件中设置 'overwriteprotocol' => 'https'。