Autenticação do ID Apple

Adicionar "Login with Apple" ao seu aplicativo

Seu aplicativo deve ter o direito Login with Apple para usar esse recurso.

1. Selecione o destino da aplicação no Xcode.

2. Go para a aba Signing & Capabilities e selecione + Capability.

3. Procure e selecione a opção Fazer login com a Apple.

Em seguida, confirme se está habilitado no Apple Developer Portal.

1. Navegue até a página Certificates, Identifiers and Profiles do Apple Developer Portal.

2. Selecione o identificador da sua aplicação no menu suspenso. Isso levará você ao painel App ID Configuration.

3. Role para baixo até ver a caixa de seleção para Sign In with Apple. Se essa caixa de seleção não estiver marcada, selecione-a. Se você fez alterações, pressione o botão Save.

Anote o Bundle ID da aplicação. Você precisa do ID do pacote para criar um o segredo do cliente e para configurar o Início de sessão com a Apple no App Services.

Crie uma Chave Privada

O segredo do cliente para conectar-se com a Apple é um JSON web token que você cria e assina com uma chave privada. Você precisa gerar a chave privada por meio do Portal do programador da Apple.

1. Clique em Keys no menu de navegação esquerdo.

2. Clique no ícone de adição azul ao lado de Keys.

3. Na página Register a New Key, insira um Key Name descritivo e role para baixo para encontrar a linha Sign in with Apple. Marque a caixa de seleção para ativar a opção "Login with Apple" e clique em Configure.

4. Na página Configure Key, selecione o ID da aplicação para a aplicação como Primary App ID e clique em Save.

5. Clique em Continue para revisar sua configuração de chave. Quando estiver certo de que configurou a chave corretamente, clique em Register.

6. Copie o valor Key ID em algum lugar que você possa acessá-lo mais tarde e clique em Download para baixar a chave como um arquivo de texto .p8 . You will use these to generate the client secret.

   Importante

   Salve a Chave

   Você só pode baixar a chave uma vez. Certifique-se de salvar a chave em algum lugar seguro, caso você precise dela novamente. Se você perder a chave, precisará gerar uma nova.

Criar o JWT do segredo do cliente

Agora você pode criar o JWT secreto do cliente para o fornecedor de autenticação do ID Apple. Certifique-se de que tem as seguintes informações:

• O Bundle ID da aplicação. Você usará isso como client_id no roteiro abaixo.

• O Key ID da chave que você criou e o arquivo .p8 que contém a chave.

• Seu ID de equipe da Apple. Você pode encontrar essa opção no canto superior direito do Portal do programador Apple.

Depois de confirmar que tem todas as informações necessárias, é possível utilizar um script para gerar o JWT. Você pode definir seu próprio script ou usar o script desta etapa.

Para gerar o JWT, usaremos a joia jwt. Para instalá-lo, execute o seguinte:

gem install jwt

Crie um novo arquivo chamado generate_client_secret.rb e copie o seguinte bloco de código para o arquivo.

# 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

Atualize os valores de team_id, client_id, key_id e key_file para corresponder às informações do seu aplicativo e então salve o arquivo. Quando estiver pronto para gerar o JWT, execute o script em seu shell:

ruby generate_client_secret.rb >> client_secret.txt

Configurar o provedor no App Services

Neste ponto, você já configurou um aplicativo Apple e gerou as credenciais OAuth 2.0 necessárias. Agora você pode configurar o fornecedor de autenticação da ID Apple com as credenciais, permitindo assim que os usuários do aplicativo de clientes do App Services façam login.

{
  "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>

Criar um ID de aplicativo

Um ID Apple App representa sua aplicação e permite que você acesse serviços como Iniciar sessão com a Apple. Para configurar o fornecedor de ID Apple, crie um novo ID do aplicativo.

1. Navegue até a página Certificates, Identifiers and Profiles do Apple Developer Portal.

2. Clique em Identifiers no menu de navegação esquerdo.

3. Clique no ícone de adição azul ao lado de Identifiers.

4. Na página Register a New Identifier , selecione App IDs e clique em Continue.

5. Na Register an App ID página , selecione o Platform em que seu aplicativo é executado e, em seguida, insira um breve Description e uma notação Bundle ID de DNS reversa .

6. Role a página Register an App ID para baixo até ver o recurso Sign in with Apple . Marque a caixa de seleção para habilitar o recurso.

7. Pressione o botão Continue na parte superior da página. Conclua as outras etapas de configuração aplicáveis ao seu aplicativo e pressione o botão Register .

Criar um ID de serviços

Um ID de Serviços Apple representa um único aplicação e permite que você configure um URL de chamada de resposta de chamada de autorização e defina uma chave privada para o aplicação.

1. Clique em Identifiers no menu de navegação esquerdo.

2. Clique no ícone de adição azul ao lado de Identifiers.

3. Na página Register a New Identifier , selecione Services IDs e clique em Continue.

4. Na Register a Services ID página , insira um breve Description e uma notação de DNS Identifier reversa .

   Importante

   Salvar o Identificador

   O valor Identifier da ID do Services é o Client ID do seu aplicativo. Você precisará deste valor posteriormente para configurar o fornecedor de ID Apple no Atlas App Services.

   Pressione o botão Continue . Confirme os detalhes e pressione Register.

5. Clique no serviço que você acabou de criar. Marque a caixa de seleção para ativar Sign in with Apple e clique em Configure. Selecione a ID do aplicativo que você criou como Primary App ID.

6. Insira seus domínios, subdomínios e URLs de retorno para o ID de serviços. Pressione o botão Next .

7. Clique em Continue e depois, em Save. Confirme que você configurou corretamente o ID de Serviços e clique em Register.

Crie uma Chave Privada

O segredo do cliente para conectar-se com a Apple é um JSON web token que você cria e assina com uma chave privada. Você precisa gerar a chave privada por meio do Portal do programador da Apple.

1. Clique em Keys no menu de navegação esquerdo.

2. Clique no ícone de adição azul ao lado de Keys.

3. Na página Register a New Key, insira um Key Name descritivo e role para baixo para encontrar a linha Sign in with Apple. Marque a caixa de seleção para ativar a opção "Login with Apple" e clique em Configure.

4. Na página Configure Key , selecione o ID do aplicativo que você criou como Primary App ID e clique em Save.

   

5. Clique em Continue para revisar sua configuração de chave. Quando estiver certo de que configurou a chave corretamente, clique em Register.

6. Copie o valor Key ID em algum lugar que você possa acessá-lo mais tarde e clique em Download para baixar a chave como um arquivo de texto .p8. Você os usará para gerar o segredo do cliente.

   Importante

   Salve a Chave

   Você só pode baixar a chave uma vez. Certifique-se de salvar a chave em algum lugar seguro, caso você precise dela novamente. Se você perder a chave, precisará gerar uma nova.

Criar o JWT do segredo do cliente

Agora você pode criar o JWT secreto do cliente para o fornecedor de autenticação do ID Apple. Certifique-se de que tem as seguintes informações:

• O Services ID que você criou. Você usará isso como client_id no roteiro abaixo.

• O Key ID da chave que você criou e o .p8

  que contém a chave.

• Seu ID da equipe Apple. Você pode encontrar isso no canto superior direito do painel da Apple

  Portal do Desenvolvedor.

Depois de confirmar que tem todas as informações necessárias, é possível utilizar um script para gerar o JWT. Você pode definir seu próprio script ou usar o script desta etapa.

Para gerar o JWT, usaremos a joia jwt. Para instalá-lo, execute o seguinte:

gem install jwt

Crie um novo arquivo chamado generate_client_secret.rb e copie o seguinte bloco de código para o arquivo.

# 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

Atualize os valores de team_id, client_id, key_id e key_file para corresponder às informações do seu aplicativo e então salve o arquivo. Quando estiver pronto para gerar o JWT, execute o script em seu shell:

ruby generate_client_secret.rb >> client_secret.txt

Configurar o provedor no App Services

Neste ponto, você já configurou um aplicativo Apple e gerou as credenciais OAuth 2.0 necessárias. Agora você pode configurar o fornecedor de autenticação da ID Apple com as credenciais, permitindo assim que os usuários do aplicativo de clientes do App Services façam login.

{
  "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>