Apple ID 身份验证

将 Sign-in With Apple 添加到您的应用程序中

您的应用程序必须具有通过 Apple 登录权限才能使用此功能。

1. 在 Xcode 中选择您的应用程序目标。

2. Go Signing & Capabilities标签页，然后选择+ Capability 。

3. 搜索通过 Apple 登录功能，然后选择该功能。

然后，确认在 Apple Developer 门户中已启用。

1. 导航到 Apple Developer 门户的 Certificates, Identifiers and Profiles 页面。

2. 从下拉列表中选择应用的标识符。这会打开 App ID Configuration 窗格。

3. 向下滚动，直到看到 Sign In with Apple 的复选框。如果未选中该复选框，请将其选中。如果进行了更改，请按 Save 按钮。

注意您的应用的 Bundle ID。创建客户端密钥以及在 App Services 中配置“通过 Apple 登录”时，需要 Bundle ID。

创建私钥

通过 Apple 登录的客户端密钥是您创建并使用私钥签名的 JSON Web 令牌。您需要通过 Apple Developer 门户生成私钥。

1. 单击左侧导航菜单中的 Keys（函数）。

2. 单击 Keys 旁边的蓝色加号图标。

3. 在 Register a New Key 页面，输入描述性 Key Name，然后向下滚动，找到 Sign in with Apple 行。选中复选框，启用“通过 Apple 登录”，然后单击 Configure。

4. 在 Configure Key 页面上，选择您的应用的 App ID 作为 Primary App ID，然后单击 Save。

5. 单击 Continue 以查看您的密钥配置。当您确定已正确配置密钥后，请单击 Register。

6. 将Key ID值复制到以后可以访问权限的地方，然后单击Download将密钥下载为 .p8文本文件。 您将使用它们来生成客户端密钥。

   重要

   保存密钥

   密钥只能下载一次。确保将密钥保存在安全的位置，以备不时之需。如果丢失了密钥，则需要生成一个新密钥。

创建客户端密钥 JWT

现在，您可以为 Apple ID 身份验证提供者创建客户端密钥 JWT。确保您拥有以下信息：

• 您的应用的 Bundle ID。您将在下面的脚本中使用它作为 client_id。

• 您创建的密钥的 Key ID 以及包含该密钥的 .p8 文件。

• 您的 Apple Team ID。您可以在 Apple Developer 门户的右上角找到它。

确认您拥有所有必需的信息后，您可以使用脚本生成 JWT。您可以定义自己的脚本或使用此步骤中的脚本。

为了生成 JWT，我们将使用 jwt gem。要安装它，请运行以下程序：

gem install jwt

创建一个名为 generate_client_secret.rb 的新文件，并将以下代码区块复制到该文件中。

# Source: https://developer.okta.com/blog/2019/06/04/what-the-heck-is-sign-in-with-apple
require 'jwt'
# Update these values with your app's information
team_id = '<Apple Team ID>'
client_id = '<Bundle ID or Services ID>'
key_id = '<Apple Key ID>'
key_file = '<Key File Path>'
# Define the JWT's headers and claims
headers = {
  # The token must be signed with your key
  'kid' => key_id
}
claims = {
  # The token is issued by your Apple team
  'iss' => team_id,
  # The token applies to Apple ID authentication
  'aud' => 'https://appleid.apple.com',
  # The token is scoped to your application
  'sub' => client_id,
  # The token is valid immediately
  'iat' => Time.now.to_i,
  # The token expires in 6 months (maximum allowed)
  'exp' => Time.now.to_i + 86400*180,
}
# Read in the key and generate the JWT
ecdsa_key = OpenSSL::PKey::EC.new IO.read key_file
token = JWT.encode claims, ecdsa_key, 'ES256', headers
# Print the JWT to stdout
puts token

更新 team_id、client_id、key_id 和 key_file 的值，使其与应用程序的信息相匹配，然后保存文件。准备好生成 JWT 后，请在 Shell 中运行脚本：

ruby generate_client_secret.rb >> client_secret.txt

在 App Services 中配置提供者

此时，您已配置 Apple 应用程序并生成所需的 OAuth 2.0 凭证。您现在可以使用凭证配置 Apple ID 身份验证提供者，以允许 App Services 客户端应用程序用户登录。

{
  "oauth2-apple": {
     "name": "oauth2-apple",
     "type": "oauth2-apple",
     "disabled": <boolean>,
     "config": {
        "clientId": "<Bundle ID>"
     },
     "secret_config": {
        "clientSecret": "<Secret Name>"
     },
     "redirect_uris": ["<string>", ...]
  }
}

appservices push

git add ./auth/providers.json
git commit -m "Configure and Enable Apple ID Authentication"
git push origin <branch name>

创建 App ID

Apple App ID代表您的应用程序，并允许您访问权限“通过 Apple 登录”等服务。 要配置 Apple ID提供商，您必须创建新的 App ID。

1. 导航到 Apple Developer 门户的 Certificates, Identifiers and Profiles 页面。

2. 单击左侧导航菜单中的 Identifiers（函数）。

3. 单击 Identifiers 旁边的蓝色加号图标。

4. 在Register a New Identifier页面上，选择App IDs ，然后单击Continue 。

5. 在Register an App ID 页面上，选择运行应用的Platform ，然后输入简短的Description 和 反向 DNS 表示法Bundle ID 。

6. 向下滚动Register an App ID页面，直到看到Sign in with Apple功能。 选中复选框以启用该功能。

7. 按页面顶部的Continue按钮。 完成应用于您的应用的所有其他设置步骤，然后按Register按钮。

创建服务ID

Apple Services ID代表单个应用程序，允许您配置授权回调URL并为应用程序定义私钥。

1. 单击左侧导航菜单中的 Identifiers（函数）。

2. 单击 Identifiers 旁边的蓝色加号图标。

3. 在Register a New Identifier页面上，选择Services IDs ，然后单击Continue 。

4. 在Register a Services ID 页面上，输入简短的Description 和 反向 DNS 表示法Identifier 。

   重要

   保存标识符

   服务ID的Identifier值是应用程序的Client ID 。 稍后您将需要此值在Atlas App Services中配置 Apple ID提供商。

   按Continue按钮。 确认详细信息，然后按Register 。

5. 单击进入刚刚创建的服务。 选中复选框以启用Sign in with Apple ，然后单击Configure 。 选择您创建的应用程序ID作为Primary App ID 。

6. 输入您的域、子域，并返回 Services ID的 URL。 按Next按钮。

7. 单击Continue ，然后单击Save 。 确认您已正确配置服务ID ，然后单击Register 。

创建私钥

通过 Apple 登录的客户端密钥是您创建并使用私钥签名的 JSON Web 令牌。您需要通过 Apple Developer 门户生成私钥。

1. 单击左侧导航菜单中的 Keys（函数）。

2. 单击 Keys 旁边的蓝色加号图标。

3. 在 Register a New Key 页面，输入描述性 Key Name，然后向下滚动，找到 Sign in with Apple 行。选中复选框，启用“通过 Apple 登录”，然后单击 Configure。

4. 在Configure Key页面上，选择您创建的应用程序ID作为Primary App ID ，然后单击Save 。

   

5. 单击 Continue 以查看您的密钥配置。当您确定已正确配置密钥后，请单击 Register。

6. 将 Key ID 值复制到以后可以访问的地方，然后单击 Download 将密钥下载为 .p8 文本文件。您将使用这些文件来生成客户端密钥。

   重要

   保存密钥

   密钥只能下载一次。确保将密钥保存在安全的位置，以备不时之需。如果丢失了密钥，则需要生成一个新密钥。

创建客户端密钥 JWT

现在，您可以为 Apple ID 身份验证提供者创建客户端密钥 JWT。确保您拥有以下信息：

• 您创建的Services ID 。 您将在以下脚本中将其用作client_id 。

• 您创建的密钥的Key ID和.p8

  包含密钥的文件。

• 您的 Apple Team ID。 您可以在 Apple

  开发者门户。

确认您拥有所有必需的信息后，您可以使用脚本生成 JWT。您可以定义自己的脚本或使用此步骤中的脚本。

为了生成 JWT，我们将使用 jwt gem。要安装它，请运行以下程序：

gem install jwt

创建一个名为 generate_client_secret.rb 的新文件，并将以下代码区块复制到该文件中。

# Source: https://developer.okta.com/blog/2019/06/04/what-the-heck-is-sign-in-with-apple
require 'jwt'
# Update these values with your app's information
team_id = '<Apple Team ID>'
client_id = '<Bundle ID or Services ID>'
key_id = '<Apple Key ID>'
key_file = '<Key File Path>'
# Define the JWT's headers and claims
headers = {
  # The token must be signed with your key
  'kid' => key_id
}
claims = {
  # The token is issued by your Apple team
  'iss' => team_id,
  # The token applies to Apple ID authentication
  'aud' => 'https://appleid.apple.com',
  # The token is scoped to your application
  'sub' => client_id,
  # The token is valid immediately
  'iat' => Time.now.to_i,
  # The token expires in 6 months (maximum allowed)
  'exp' => Time.now.to_i + 86400*180,
}
# Read in the key and generate the JWT
ecdsa_key = OpenSSL::PKey::EC.new IO.read key_file
token = JWT.encode claims, ecdsa_key, 'ES256', headers
# Print the JWT to stdout
puts token

更新 team_id、client_id、key_id 和 key_file 的值，使其与应用程序的信息相匹配，然后保存文件。准备好生成 JWT 后，请在 Shell 中运行脚本：

ruby generate_client_secret.rb >> client_secret.txt

在 App Services 中配置提供者

此时，您已配置 Apple 应用程序并生成所需的 OAuth 2.0 凭证。您现在可以使用凭证配置 Apple ID 身份验证提供者，以允许 App Services 客户端应用程序用户登录。

{
  "oauth2-apple": {
     "name": "oauth2-apple",
     "type": "oauth2-apple",
     "disabled": <boolean>,
     "config": {
        "clientId": "<Apple Services ID>"
     },
     "secret_config": {
        "clientSecret": "<Secret Name>"
     },
     "redirect_uris": ["<string>", ...]
  }
}

appservices push

git add ./auth/providers.json
git commit -m "Configure and Enable Apple ID Authentication"
git push origin <branch name>