Cómo habilitar el inicio de sesión con Google y Apple

Aprenda a preparar las credenciales de desarrollador de Google y Apple para que sus clientes puedan iniciar sesión o registrarse en B2CORE usando su cuenta de Google o Apple

Esta guía está dirigida a brókeres que desean que sus clientes puedan iniciar sesión o registrarse usando su cuenta de Google o Apple, además de (o en lugar de) correo electrónico y contraseña. Explica qué debe preparar por su parte y qué sucede una vez que entrega la información a B2Broker.

Esta es una configuración conjunta: usted es propietario de las cuentas y credenciales de desarrollador de Google/Apple, y B2Broker las integra en su instancia de B2CORE. No se habilita nada hasta que ambas partes hayan terminado.

Esta función tiene una tarifa única de configuración. Póngase en contacto con su gestor de cuenta o con nuestro equipo de soporte para confirmar la tarifa y la disponibilidad antes de solicitar acceso.

Lo que obtiene

  • Un botón de "Iniciar sesión con Google" y/o "Iniciar sesión con Apple" en sus páginas de inicio de sesión y registro.
  • Los nuevos usuarios que se registren de esta forma se crean automáticamente; no se requiere un formulario de registro independiente.
  • Los usuarios que ya tienen una cuenta con contraseña también pueden vincular una cuenta de Google/Apple más adelante (la vinculación se realiza mediante la dirección de correo electrónico).

Antes de comenzar

  • Confirme con su gestor de cuenta de B2Broker que el inicio de sesión social está disponible para su instancia de B2CORE. Esto depende de que ya esté utilizando la plataforma de identidad actual.
  • Decida qué proveedores desea: solo Google, solo Apple o ambos. Apple requiere una cuenta de pago de Apple Developer, así que téngalo en cuenta si lo desea.
  • Necesitará a alguien de su lado con acceso a las cuentas de Google Cloud / Apple Developer de su empresa (o con la capacidad de crear otras nuevas).

Lo que necesita preparar — Google

  1. Un proyecto de Google Cloud. Use un proyecto existente de la empresa o cree uno nuevo dedicado al inicio de sesión.
  2. Pantalla de consentimiento de OAuth. Configure:
    • Nombre de la aplicación, correo electrónico de soporte, logotipo (esto es lo que verán sus usuarios en la solicitud de consentimiento de Google).
    • Ámbitos: openid, email, profile.
    • Estado de publicación: mientras la aplicación esté en Testing, solo los usuarios de prueba añadidos explícitamente podrán iniciar sesión; cualquier otra persona recibirá access_denied. Mueva la aplicación a Published antes de la puesta en producción.
  3. Un Client ID de OAuth 2.0 (tipo de aplicación: Web application).
    • Le proporcionaremos el Authorized redirect URI exacto que debe registrar; está vinculado al nombre de host de su instancia de B2CORE y tiene este aspecto:

      https://<your-api-host>/srvsz/auth/clients/v1/self-service/methods/oidc/callback/google
    • Añada el mismo host (sin ruta) como Authorized JavaScript origin.

  4. Copie el Client ID y el Client secret resultantes.

Lo que necesita preparar — Apple

La configuración de Apple tiene más elementos y requiere una membresía activa del Apple Developer Program.

  1. Un App ID con la capacidad Sign In with Apple habilitada (reutilice un App ID existente si tiene uno o cree uno nuevo).
  2. Un Services ID: este es el cliente OAuth real que utiliza Apple. Al configurarlo:
    • Domain: el host de API de su instancia de B2CORE (sin esquema ni ruta).
    • Return URL: la URL de callback de Apple que le proporcionamos, con la misma estructura que la de Google anterior, pero terminando en /apple.
  3. Una clave privada de "Sign in with Apple" (archivo .p8) generada en la sección Keys de Apple, con la capacidad Sign In with Apple vinculada a su App ID.

Este archivo solo se puede descargar una vez; guárdelo inmediatamente en un lugar seguro.

  1. Su Team ID (alfanumérico de 10 caracteres, mostrado en el encabezado de su cuenta de Apple Developer).
  2. El Key ID de la clave que creó en el paso 3.

Terminará con cinco datos: Services ID (client ID), Team ID, Key ID, el archivo de clave privada .p8 y, a diferencia de Google, no hay un "client secret" independiente que copiar; el secreto de Apple se deriva de los otros cuatro.

Entrega de credenciales a B2Broker

Envíenos:

  • Google: Client ID + Client secret.
  • Apple: Services ID, Team ID, Key ID y el archivo de clave privada .p8.

Trátelos como secretos; especialmente la clave privada de Apple. Envíelos a través de un canal seguro proporcionado por su gestor de cuenta (un enlace para compartir secretos o un archivo adjunto cifrado), no por correo electrónico o chat sin cifrar. Confirmaremos una vez que se almacenen de forma segura de nuestro lado y le informaremos cuando los botones estén activos.

Qué sucede después

Una vez que tengamos sus credenciales, habilitaremos la función en su instancia de B2CORE e implementaremos los cambios.

Esto normalmente provoca un breve reinicio del servicio de inicio de sesión; no se espera tiempo de inactividad, pero evite programarlo durante las horas punta.

Pruebas después de la puesta en producción

  1. Abra su página de inicio de sesión; debería ver los botones de Google/Apple.
  2. Inicie sesión con una cuenta real para cada proveedor habilitado.
  3. Confirme que el usuario accede con la sesión iniciada y que su correo electrónico/nombre se muestran correctamente en su panel de administración.
  4. Si Google sigue en modo Testing, solo los usuarios de prueba que añadió a la pantalla de consentimiento podrán iniciar sesión; todos los demás verán access_denied. Publique la aplicación antes de promocionar la función a usuarios reales.

Información útil

Apple solo comparte el nombre y el correo electrónico del usuario durante su primer consentimiento. Si un usuario revoca su aplicación en la configuración de su Apple ID y vuelve a iniciar sesión más adelante, Apple solo devolverá un identificador anónimo; es posible que el nombre falte a partir de entonces. Esta es una limitación de Apple, no un error de nuestro lado.

Los correos electrónicos de Apple pueden ser direcciones de "private relay" (...@privaterelay.appleid.com). Son direcciones reales y funcionales; simplemente se enrutan a través de Apple. Trátelas como el correo electrónico canónico del usuario; no coincidirán automáticamente con una cuenta con contraseña existente que use el correo electrónico real del usuario.

Google requiere un correo electrónico verificado. Si el correo electrónico de una cuenta de Google no está verificado, el inicio de sesión fallará por diseño; esto protege su base de usuarios de identidades no verificadas.

Los ID de proveedores son fijos (google, apple). Si alguna vez necesita rotar las credenciales (por ejemplo, por un secreto filtrado), póngase en contacto con B2Broker; podemos actualizarlas sin cambiar las URL de inicio de sesión que sus usuarios ya utilizan.

Preguntas / soporte

Póngase en contacto con su gestor de cuenta de B2Broker o canal de soporte e indique el nombre de su bróker y qué proveedor(es) está configurando.

Última actualización

En esta página