Configuring Well-Known OpenID Connect Providers

为了为 Apple 设置 OIDC，您需要创建一个开发者帐户并注册 99€/年的计划，但是您无法像大多数其他 OIDC 提供者那样在 localhost 上测试您的应用程序：您需要通过 HTTPS 运行它并使其公开可访问，因此，出于开发目的，您可能希望使用像 [role="bare"]https://ngrok.com 这样的服务。

转至 ` Create a new identifier` 并按 +

不要碰任何东西，保持 App IDs 选中，然后按 Continue：

不要碰任何东西，保持 App 选中，然后按 Continue：

输入描述和包 ID（使用您的应用程序包名称）：

然后向下滚动以查找 Sign in with Apple 功能，选择它，然后按 Continue：

记下您的应用程序 ID 前缀，然后按 Register：

回到 Identifiers 页面，按 +：

选择 Service IDs 并按 Continue：

输入描述和包 ID（使用您的应用程序包名称），然后按 Continue：

现在按 Register：

回到服务列表，单击您新创建的服务：

启用 Sign in with Apple 并按 Configure：

添加您的域名和返回 URL（设置为 <host>/_renarde/security/oidc-success）并按 Next：

现在按下 Done

现在按下 Continue

现在按下 Save

前往左侧菜单中的 Keys 页面，然后按下 +

填写一个键名称，启用 Sign in with Apple，然后按下 Configure

选择你的主要应用 ID，然后按下 Save

返回到该键页面，按下 Continue

现在按 Register：

写下你的 Key ID，下载你的键，然后将其保存在 src/main/resources/AuthKey_<KEYID>.p8 中的 Quarkus 应用程序中

你现在可以配置你的 application.properties

quarkus.oidc.provider=apple 将请求 Apple 将 openid、email 和 name 范围添加到颁发的访问令牌。关于覆盖这些范围或请求更多范围的信息，请参阅 Provider scopes 部分。

创建一个 Discord application

你现在可以获取你的客户端 ID 和 secret

你现在可以配置你的 application.properties

Facebook 与大多数其他 OIDC 提供商不同，它不允许你对应用程序在 localhost 上进行测试：你需要通过 HTTPS 来运行它，并使其面向公众开放访问，因此出于开发目的，你可能希望使用如下服务 [role="bare"][role="bare"]https://ngrok.com

为了开始设置 Facebook 的 OIDC，首先 Creating an application，选择 None 作为一种应用程序类型，然后按下 Next

现在，输入一个应用程序名称和联系电子邮箱，然后按下 Create app

在应用程序页面上，点击 Facebook login 产品中的 Set up

快速访问 Quickstarts 页面，然后点击左侧菜单中的 Facebook login > Settings

输入你的 Redirect URIs（设置为 <host>/_renarde/security/oidc-success），然后按下 Save changes

现在前往左侧菜单中的 Settings > Basic，然后写下你的 App ID 和 App secret

你现在可以配置你的 application.properties

quarkus.oidc.provider=facebook 将请求 Facebook 把 email 和 public_profile 范围添加到颁发的访问令牌。有关覆盖这些范围或请求更多范围的信息，请参见 Provider scopes 部分。

为了设置 GitHub 的 OIDC，你需要在 GitHub developer settings 中创建一个新的 OAuth 应用程序：

务必填写适当的详细信息，但更重要的是授权回调 URL，设置为 http://localhost:8080/_renarde/security/github-success（如果你打算使用 Quarkus 开发模式测试此功能）。

现在点击 Register application，你将看到你的应用程序页面：

你需要点击 Generate a new client secret，确认你的凭据，并写下你的客户端 ID 和客户端密钥（特别是客户端密钥，因为你以后无法再从该页面看到它，但你可以随时重新创建一个，所以不用太担心）：

现在将以下配置添加到你的 application.properties：

quarkus.oidc.provider=github 将请求 GitHub 将 user:email 范围添加到颁发的访问令牌。有关覆盖此范围或请求更多范围的信息，请参见 Provider scopes 部分。

为了设置 Google 的 OIDC，你需要在 Google Cloud Platform console 中创建一个新项目：

选择一个项目名称，然后点击 CREATE。

现在确保在顶部选择器中选择你的项目，然后点击左侧栏菜单中的 APIs and Services > OAuth consent screen：

选择 External 授权任何 Google 用户登录你的应用程序，然后按 CREATE：

现在你可以填写你的应用程序名称、支持电子邮件、开发人员联系人信息，然后按 SAVE AND CONTINUE：

不要在下一页添加任何范围，然后按 SAVE AND CONTINUE：

不要在下一页添加任何测试用户，然后按 SAVE AND CONTINUE：

点击顶部菜单 CREATE CREDENTIALS> OAuth client ID：

将 Application type 选择为 Web application，在 Authorised redirect URIs 列表中添加 http://localhost:8080/_renarde/security/oidc-success，然后按 CREATE：

复制你的客户端 ID 和客户端密钥：

你现在可以配置你的 application.properties

quarkus.oidc.provider=google 将请求 Google 把 openid 、 email 和 profile 范围添加到颁发的访问令牌。有关覆盖这些范围或请求更多范围的信息，请参见 Provider scopes 部分。

创建 LinkedIn application：

添加 Sign In with LinkedIn using OpenId Connect 产品：

您现在可以获取您的客户端 ID 和加密信息。别忘了还要为您的应用程序添加已授权的重定向 URL：

你现在可以配置你的 application.properties

创建 Mastodon account。例如，您必须 pick a server mastodon.social。在您的帐户中选择一个 Development 选项并注册一个应用程序，例如：

选择已注册的应用程序：

并记下其客户端 ID 和客户端加密信息属性，使用它们来配置您的 application.properties：

默认情况下，quarkus.oidc.provider=mastodon 将 quarkus.oidc.auth-server-url 设置为 https://mastodon.social Mastodon 服务器地址。

如果您在另一个 Mastodon 服务器中创建了您的帐户，您可以覆盖 quarkus.oidc.auth-server-url，例如：

为了设置微软的 OIDC，您需要转到您的 Microsoft Azure Portal，并搜索 Azure Active Directory，然后点击它：

进入之后，在左侧的 Manage 下，点击 App registrations，然后点击 New registration：

填写您的应用程序名称，选择 Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox) 允许任何人登录，并添加 Web 重定向 URI 为 http://localhost:8080/_renarde/security/oidc-success，然后点击 Register：

在结果页面上，复制 Client Id（在 Application (client) ID 下），然后点击 Add a certificate or secret：

现在，在 Client secrets (0) 下，点击 New client secret：

在该对话框中点击 Add，无需更改任何内容：

在结果页面上，复制您的 Secret Value：

你现在可以配置你的 application.properties

quarkus.oidc.provider=microsoft 将请求 Microsoft 为所发行的访问权限令牌添加 openid、email 和 profile 范围。有关覆盖这些范围或请求更多范围的信息，请参阅 Provider scopes 部分。

创建 Spotify application：

别忘了将 http://localhost:8080 添加为开发目的的测试重定向 URI。在 Spotify 应用程序设置完成后，您应该会获得一个已生成的客户端 ID 和密钥，例如：

你现在可以配置你的 application.properties

quarkus.oidc.provider=spotify 会请求 Spotify 将 user-read-private 和 user-read-email 范围添加到已颁发的访问令牌。有关覆盖这些范围或请求更多范围的信息，请参阅 Provider scopes 部分。

创建 Strava application：

例如，将 Category 设置为 SocialMotivation，并将 ApplicationCallbackDomain 设置为 localhost 或 Ngrok 提供的域名，有关详细信息，请参阅 HTTPS Redirect URI。

你现在可以配置你的 application.properties

创建 Twitch application：

你现在可以配置你的 application.properties

您可以使用 X (以前的 Twitter) 进行 OIDC 登录，但目前它限制了对用户电子邮件的访问，这意味着您必须自行获取并验证它。

要为 X 设置 OIDC，首先 Creating a project，输入一个项目名称，然后按 Next：

输入用例，然后按 Next：

输入项目说明，然后按 Next：

现在输入应用程序名称，然后按 Next：

记下您的密钥，因为它们不会再次显示，然后按 App Settings：

向下导航到 User authentication settings 部分，然后按 Set up：

选中 OAuth 2.0 复选框：

选择 Web App`作为应用程序类型，然后填写您的应用程序详细信息（在 `Callback URI 中使用 <host>/_renarde/security/twitter-success）。

现在按 Save：

你现在可以复制你的 Client ID 和 Client Secret，然后按下 Done：

你现在可以配置你的 application.properties

quarkus.oidc.provider=x 会要求 X 将 offline.access、tweet.read 和 users.read 范围添加到已颁发的访问令牌。有关覆写这些范围或请求更多范围的信息，请参阅 Provider scopes 部分。