Autenticación Apple ID

Añade Iniciar sesión con Apple a tu aplicación

Su aplicación debe tener el derecho de Iniciar sesión con Apple para poder utilizar esta capacidad.

1. Selecciona el destino de tu aplicación en Xcode.

2. Ir a la Signing & Capabilities pestaña y seleccione + Capability.

3. Busque la función Iniciar sesión con Apple y selecciónela.

Luego, confirme que esté habilitado en el Portal para desarrolladores de Apple.

1. Vaya a la Certificates, Identifiers and Profiles página del Portal para desarrolladores de Apple.

2. Selecciona el identificador de tu aplicación en el menú desplegable. Esto te llevará al panel App ID Configuration.

3. Desplácese hacia abajo hasta que vea la casilla Sign In with Apple. Si no está seleccionada, selecciónela. Si ha realizado cambios, pulse el botón Save.

Toma nota del Bundle ID de tu aplicación. Necesitarás el Bundle ID cuando crees un secreto de cliente y cuando configures Sign in con Apple en Servicios de aplicación.

Crear una clave privada

La clave secreta para Iniciar sesión con Apple es un JSON Web Token que tú creas y firmas con una llave privada. Debes generar la clave privada a través del Portal de desarrolladores de Apple.

1. Haga clic en Keys en el menú de navegación de la izquierda.

2. Haga clic en el ícono más azul junto a Keys.

3. En la página Register a New Key, introduce un Key Name descriptivo y desplázate hacia abajo hasta encontrar la fila Sign in with Apple. Marca la casilla para activar "Iniciar sesión con Apple" y haz clic en Configure.

4. En la página Configure Key, seleccione el ID de la aplicación para su aplicación como Primary App ID y luego haga clic en Save.

5. Haz clic en Continue para revisar tu configuración de claves. Cuando estés seguro de haber configurado la clave correctamente, haz clic en Register.

6. Copie el valor Key ID en algún lugar al que pueda acceder más tarde y luego haga clic en Download para descargar la clave como .p8 Archivo de texto. Lo usarás para generar el secreto del cliente.

   Importante

   Guardar la clave

   Solo puedes descargar la clave una vez. Asegúrate de guardarla en un lugar seguro por si la necesitas de nuevo. Si la pierdes, tendrás que generar una nueva.

Crear el JWT secreto del cliente

Ahora puedes crear el JWT secreto de cliente para el proveedor de autenticación de Apple ID. Asegúrate de tener la siguiente información:

• El Bundle ID de tu aplicación. Lo usarás como client_id en el script a continuación.

• La Key ID de la clave que creaste y el archivo .p8 que contiene la clave.

• Tu ID de equipo de Apple. Lo encontrarás en la esquina superior derecha del Portal para desarrolladores de Apple.

Una vez que hayas confirmado que tienes toda la información requerida, puedes usar un script para generar el JWT. Puedes definir tu propio script o utilizar el script en este paso.

Para generar el JWT, utilizaremos la gema jwt. Para instalarlo, ejecuta lo siguiente:

gem install jwt

Cree un nuevo archivo llamado generate_client_secret.rb y copie el siguiente bloque de código en el archivo.

# 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

Actualice los valores de team_id, client_id, key_id y key_file para que coincidan con la información de su aplicación y guarde el archivo. Cuando esté listo para generar el JWT, ejecute el script en su shell:

ruby generate_client_secret.rb >> client_secret.txt

Configurar el proveedor en App Services

En este punto, ha configurado una aplicación de Apple y generado las credenciales OAuth 2.0 necesarias. Ahora puede configurar el proveedor de autenticación de ID de Apple con las credenciales para permitir que los usuarios de la aplicación cliente de App Services inicien sesión.

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

Crea una ID de la aplicación

Un ID de la aplicación de Apple representa tu aplicación y te permite acceder a servicios como Iniciar sesión con Apple. Para configurar el proveedor de ID de Apple, debes crear un nuevo ID de la aplicación.

1. Vaya a la Certificates, Identifiers and Profiles página del Portal para desarrolladores de Apple.

2. Haga clic en Identifiers en el menú de navegación de la izquierda.

3. Haga clic en el ícono más azul junto a Identifiers.

4. En la página Register a New Identifier, seleccione App IDs y luego haga clic en Continue.

5. En la Register an App ID página, seleccione el Platform en el que se ejecuta su aplicación y luego ingrese un breve Description y una notación DNS Bundle ID inversa.

6. Desplácese por la página Register an App ID hasta ver la función Sign in with Apple. Marque la casilla para activarla.

7. Pulsa el botón Continue en la parte superior de la página. Completa cualquier otro paso de configuración que aplique a tu aplicación y luego pulsa el botón Register.

Crear un ID de servicios

Un ID de servicios de Apple representa una sola aplicación y le permite configurar una URL de devolución de llamada de autorización y definir una clave privada para la aplicación.

1. Haga clic en Identifiers en el menú de navegación de la izquierda.

2. Haga clic en el ícono más azul junto a Identifiers.

3. En la página Register a New Identifier, seleccione Services IDs y luego haga clic en Continue.

4. En la Register a Services ID página, ingrese un breve Description y una notación DNS Identifier inversa.

   Importante

   Guardar el identificador

   El valor Identifier del ID de servicios es el Client ID de tu aplicación. Necesitarás este valor más adelante para configurar el proveedor Apple ID en Atlas App Services.

   Press the Continue button. Confirm the details, and then press Register.

5. Click into the service you just created. Check the checkbox to enable Sign in with Apple and then click Configure. Select the App ID that you created as the Primary App ID.

6. Enter your domains, subdomains, and return URLs for the Services ID. Press the Next button.

7. Click Continue and then click Save. Confirm that you have correctly configured the Services ID and then click Register.

Crear una clave privada

La clave secreta para Iniciar sesión con Apple es un JSON Web Token que tú creas y firmas con una llave privada. Debes generar la clave privada a través del Portal de desarrolladores de Apple.

1. Haga clic en Keys en el menú de navegación de la izquierda.

2. Haga clic en el ícono más azul junto a Keys.

3. En la página Register a New Key, introduce un Key Name descriptivo y desplázate hacia abajo hasta encontrar la fila Sign in with Apple. Marca la casilla para activar "Iniciar sesión con Apple" y haz clic en Configure.

4. En la página Configure Key, seleccione el ID de la aplicación que creó como Primary App ID y luego haga clic en Save.

   

5. Haz clic en Continue para revisar tu configuración de claves. Cuando estés seguro de haber configurado la clave correctamente, haz clic en Register.

6. Copia el valor de Key ID en un lugar que puedas acceder más adelante y luego haz clic en Download para descargar la clave como un archivo de texto .p8. Los utilizarás para generar el secreto del cliente.

   Importante

   Guardar la clave

   Solo puedes descargar la clave una vez. Asegúrate de guardarla en un lugar seguro por si la necesitas de nuevo. Si la pierdes, tendrás que generar una nueva.

Crear el JWT secreto del cliente

Ahora puedes crear el JWT secreto de cliente para el proveedor de autenticación de Apple ID. Asegúrate de tener la siguiente información:

• El Services ID que creaste. Vas a utilizar esto como el client_id en el siguiente script.

• El Key ID de la clave que creaste y el .p8

  file that contains the key.

• Your Apple Team ID. You can find this in the top right of the Apple

  Portal de desarrolladores.

Una vez que hayas confirmado que tienes toda la información requerida, puedes usar un script para generar el JWT. Puedes definir tu propio script o utilizar el script en este paso.

Para generar el JWT, utilizaremos la gema jwt. Para instalarlo, ejecuta lo siguiente:

gem install jwt

Cree un nuevo archivo llamado generate_client_secret.rb y copie el siguiente bloque de código en el archivo.

# 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

Actualice los valores de team_id, client_id, key_id y key_file para que coincidan con la información de su aplicación y guarde el archivo. Cuando esté listo para generar el JWT, ejecute el script en su shell:

ruby generate_client_secret.rb >> client_secret.txt

Configurar el proveedor en App Services

En este punto, ha configurado una aplicación de Apple y generado las credenciales OAuth 2.0 necesarias. Ahora puede configurar el proveedor de autenticación de ID de Apple con las credenciales para permitir que los usuarios de la aplicación cliente de App Services inicien sesión.

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