Conectar el inicio de sesión con Kakao

Para que sus clientes se registren con una cuenta de Kakao, primero tiene que registrar su servicio en Kakao y obtener dos valores. Son la REST API key y el Client Secret.

Esta página explica en qué orden se obtienen esos dos valores. Cómo introducir en WEEGLOO los valores obtenidos está en Introducir en WEEGLOO los valores obtenidos.

La dirección que debe copiar primero

Cuando el cliente termina de iniciar sesión en Kakao, Kakao devuelve el resultado a una dirección determinada. Esta dirección tiene que registrarla en Kakao, así que cópiela ahora. La pegará en el paso 5.

Si elige aquí abajo su Space, la dirección queda con el identificador ya puesto.

Space
https://auth.weegloo.com/v1/spaces/{spaceId}/login/oauth2/code/kakao

Si prefiere rellenarla a mano, ponga en el hueco de {spaceId} el identificador de su Space. Abra ese Space en el estudio de contenidos y mire la barra de direcciones del navegador: el valor que viene después de /spaces/ es el identificador.

Esta dirección no es la de su sitio, sino el lugar donde WEEGLOO recibe el resultado del inicio de sesión. Por eso queda fijada ya, aunque todavía no haya creado su sitio. Si activó Kakao en el estudio de contenidos, en el Step 1 aparece la misma dirección, así que también puede copiarla de ahí.

Obtener los dos valores en Kakao

Inicie sesión en Kakao y realice por orden los cinco pasos siguientes.

1

Crear la app

  1. Abra la pantalla de sus aplicaciones (https://developers.kakao.com/console/app).

  2. Pulse Create app (crear app).

  3. En App icon (icono de la app), suba una imagen.

  4. En App name (nombre de la app), escriba el nombre que verá el cliente (por ejemplo, Cozy Closet).

  5. En Company name (nombre de la empresa), escriba el nombre de su tienda o de su empresa. Puede ser el mismo que el nombre de la app.

  6. En Category (categoría), elija la que corresponda a su servicio (por ejemplo, Lifestyle).

  7. En App primary domain (dominio principal de la app), escriba la dirección de su sitio (por ejemplo, https://armario-acogedor.com).

  8. Marque la casilla de consentimiento de la política de operación que está al final.

  9. Pulse Save (guardar).

    Ventana de Create app. En App icon hay una imagen subida, en App name y Company name está "Cozy Closet" y en App primary domain está la dirección del sitio

2

Convertir la app en Biz app

Si no hace la conversión a Biz app, no podrá poner el correo electrónico como elemento de consentimiento obligatorio.

  1. Abra la app que acaba de crear y vaya a App Settings → App → General (ajustes de la app → app → general).

  2. Busque la sección Business information (información de la empresa).

    Sección Business information. Están el botón Register business information y el aviso "This app is not a Biz app", y debajo el botón Switch to Biz app for an individual

El camino se divide en dos según si tiene o no número de registro de empresa. Siga solo el que corresponda a su situación.

  1. Pulse Register business information (registrar la información de la empresa).
  2. En Business Type (tipo de empresa), elija Domestic business (Korea) (empresa nacional de Corea). Si su empresa no está en Corea, elija Overseas business (outside Korea) (empresa de fuera de Corea).
  3. Escriba el Business registration number (número de registro de empresa).
  4. Pulse Confirm (confirmar).

Ventana de Business information. En Business Type está seleccionado Domestic business (Korea) y debajo hay tres casillas para el Business registration number

  1. Complete la verificación de identidad.
  2. Pulse Switch to Biz app for an individual (convertir en Biz app siendo particular).
  3. En Purpose (finalidad), elija To set email to Required consent item (poner el correo electrónico como elemento de consentimiento obligatorio).
  4. Pulse Save.

Ventana de Switch to Biz app for an individual. En Purpose está seleccionado To set email to Required consent item

Si nunca ha aceptado los términos del servicio integrado de Kakao Business, al pulsar Save se abre la pantalla de aceptación de esos términos. Si los acepta, la conversión continúa.

Por cualquiera de los dos caminos, cuando la conversión termina, la etiqueta que hay encima del nombre de la app cambia a Biz app.

3

Activar el inicio de sesión con Kakao

  1. Vaya a Product Settings → Kakao Login → General (ajustes de producto → inicio de sesión con Kakao → general).

  2. Active el interruptor State (estado) de Usage settings (ajustes de uso).

  3. En el cuadro de diálogo de confirmación, pulse Activate (activar).

    Pantalla de Product Settings → Kakao Login → General. El interruptor State de Usage settings está activado y debajo está el interruptor de OpenID Connect

Al activar el interruptor, debajo aparece el interruptor OpenID Connect. Deje ese interruptor como está.

4

Configurar los elementos de consentimiento

Tiene que cambiar los tres elementos siguientes a Required consent (consentimiento obligatorio).

NombrePropósito del consentimiento
EmailMember identification
NicknameDisplay member name
Profile imageDisplay member profile

  1. Vaya a Product Settings → Kakao Login → Consent Items (ajustes de producto → inicio de sesión con Kakao → elementos de consentimiento).

  2. En la tabla Personal information (información personal), pulse Set (configurar) en la fila Email (correo electrónico).

  3. Elija Required consent.

  4. En Purpose of consent (propósito del consentimiento), escriba Member identification.

  5. Pulse Save.

    Ventana de configuración del elemento de consentimiento. En Email está seleccionado Required consent y en Purpose of consent está escrito "Member identification"

  6. Cambie también Nickname (apodo) de la misma manera, desde el punto 2. Su Purpose of consent es Display member name.

  7. Cambie también Profile image (foto de perfil) de la misma manera, desde el punto 2. Su Purpose of consent es Display member profile.

  8. Compruebe que el State de los tres elementos es Required consent.

    Tabla Personal information de la pantalla de elementos de consentimiento. El State de Nickname, Profile image y Email es Required consent y el resto de los elementos está en Unauthorized

Tiene que cambiar los tres elementos

Si deja alguno sin cambiar, el cliente se queda bloqueado en una pantalla de error de Kakao antes incluso de empezar a iniciar sesión.

5

Copiar la REST API key y el Client Secret

  1. Vaya a App Settings → App → Platform Key (ajustes de la app → app → clave de plataforma).

    Pantalla de App Settings → App → Platform Key. Las tres tarjetas de REST API key, JavaScript key y Native app key están una al lado de la otra

  2. Pulse la tarjeta de la REST API key.

    Pantalla Edit REST API key. Arriba del todo está el valor de la REST API key, más abajo se ve la casilla de Kakao Login Redirect URI vacía y, debajo, las filas de Kakao Login y Business Authentication de Client Secret

  3. Copie el valor de la REST API key.

  4. En la casilla Kakao Login Redirect URI (URI de redirección del inicio de sesión con Kakao), pegue la dirección que copió en La dirección que debe copiar primero.

  5. Copie el Code (código) que hay en la fila Kakao Login de Client Secret.

  6. Pulse Save.

Las claves aparecen en tres tipos, REST API key, JavaScript key (clave de JavaScript) y Native app key (clave de app nativa), y la que va a usar es la REST API key. En Client Secret el código también aparece en dos filas, Kakao Login (inicio de sesión con Kakao) y Business Authentication (autenticación de empresa), y la que va a usar es la fila Kakao Login.

Con una sola casilla de dirección es suficiente. El botón + que hay al lado sirve para registrar más direcciones, así que no lo pulse. El Secret es un valor secreto, así que no se lo dé a nadie ni lo escriba en un sitio público.

Introducir en WEEGLOO los valores obtenidos

Ahora tiene en la mano los dos valores. Estas son las casillas del estudio de contenidos en las que va cada uno de los dos valores.

Pantalla de KakaoEstudio de contenidos
REST API keyREST API key
Code de Kakao Login en Client SecretClient Secret - Kakao Login Code

A partir de aquí el camino se divide según cómo haya venido trabajando hasta ahora.

Si estaba configurándolo directamente en el estudio de contenidos, siga estos pasos.

  1. Vuelva a la sección Activar el inicio de sesión social de Inicio de sesión de miembros del servicio.
  2. Active Kakao.
  3. Introduzca la REST API key en la casilla REST API key del Step 2.
  4. Introduzca el código de Kakao Login del Client Secret en la casilla Client Secret - Kakao Login Code.
  5. Pulse Guardar.

Si dejó la integración en manos de un agente de IA y este le indicó que fuera a obtener los valores, pegue tal cual los dos valores obtenidos en la ventana de chat y siga con lo que estaba haciendo. El resto de la configuración lo continúa el agente.

Qué hacer a continuación

  • Inicio de sesión de miembros del servicio: introduzca los valores obtenidos en el estudio de contenidos y termine el resto de la configuración del inicio de sesión de miembros.
  • Roles y permisos de miembros: cree el ServiceUserRole que define qué puede ver y usar un miembro registrado.
  • Auth API: trata especificaciones técnicas, como el formato de las solicitudes, que necesita para integrar el inicio de sesión en el código de su sitio.