Conectar el inicio de sesión con GitHub
Para que sus clientes se registren con una cuenta de GitHub, primero tiene que registrar su servicio en GitHub y obtener dos valores. Son el Client ID 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 GitHub, GitHub devuelve el resultado a una dirección determinada. Esta dirección tiene que registrarla en GitHub, así que cópiela ahora. La pegará en el paso 1.
Si elige aquí abajo su Space, la dirección queda con el identificador ya puesto.
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ó GitHub 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 GitHub
Inicie sesión en GitHub y realice por orden los dos pasos siguientes. Lo que se hace aquí no tiene coste.
Registrar la OAuth App
OAuth, que aparece en las pantallas, es el nombre del método que permite iniciar sesión con una cuenta de GitHub. Los dos valores están dentro de la única app que registra aquí.
-
Abra la pantalla de configuración de desarrollador (https://github.com/settings/developers).
-
En el menú de la izquierda, pulse OAuth Apps.
-
Pulse New OAuth app.
-
En Application name, escriba el nombre que verá el cliente (por ejemplo,
Armario Acogedor). -
En Homepage URL, escriba la dirección de su sitio (por ejemplo,
https://armario-acogedor.com). -
En la casilla Redirect URI, pegue la dirección que copió en La dirección que debe copiar primero.
-
Pulse Register application.
Si todavía no tiene un sitio, escriba en Homepage URL la dirección que vaya a usar más adelante. Podrá modificarla después. Application description es opcional y, si escribe algo, se muestra tal cual al cliente, así que redáctelo como una frase que leerá el cliente.
Copiar el Client ID y el Client secret
Al pulsar Register application se abre la pantalla de configuración de la app que acaba de registrar. De los dos valores, el Client ID ya aparece aquí, y el client secret lo genera ahora pulsando un botón.
-
Copie el valor que figura en Client ID.
-
Pulse Generate a new client secret, a la derecha del título Client secrets.
-
Pulse el icono de copiar que está a la derecha del valor generado para copiar el client secret.
Si sale de esta pantalla no podrá volver a ver el client secret
El Client ID se queda en esta pantalla, así que puede volver a verlo cuando quiera, pero con el client secret no ocurre lo mismo. Si lo perdió, genere uno nuevo con Generate a new client secret e introduzca de nuevo en WEEGLOO el valor recién obtenido. El client secret es un valor secreto, tal como dice su nombre. No se lo dé a nadie ni lo escriba en un sitio público.
El correo electrónico tiene que ser público para iniciar sesión
El inicio de sesión con GitHub lleva una condición. La cuenta de GitHub con la que se inicia sesión tiene que tener el correo electrónico público.
Cuando el cliente inicia sesión con GitHub, WEEGLOO recibe también el correo público de esa cuenta y lo guarda en el miembro. En un mismo Space solo se puede registrar una vez con un mismo correo. En las cuentas que no han indicado un correo público ese valor no llega, y entonces el registro se detiene ahí.
Cuando se detiene, el cliente ve una pantalla de aviso que muestra WEEGLOO. En ella está escrito, en el idioma del cliente, que no se ha podido obtener el correo y qué puede hacer, y además hay un botón para volver a su sitio.
En ese caso el resultado del inicio de sesión no llega hasta su sitio. Por eso el código de su sitio no puede detectar esta situación ni resolverla en su lugar.
Quien lo resuelve es el cliente. Si el cliente abre Public profile en la configuración de su cuenta de GitHub (https://github.com/settings/profile), encontrará el apartado Public email. Al elegir ahí el correo que quiere mostrar, el inicio de sesión ya se completa a partir de la siguiente vez. En las cuentas que todavía no lo han elegido solo pone Select a verified email to display.
Lo que puede hacer en su sitio es escribir esta condición de antemano en el lugar donde se inicia sesión con GitHub, para que el cliente lo sepa antes de quedarse bloqueado.
Introducir en WEEGLOO los valores obtenidos
Ahora tiene en la mano los dos valores. 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.
- Vuelva a la sección Activar el inicio de sesión social de Inicio de sesión de miembros del servicio.
- Active GitHub.
- Introduzca el Client ID en la casilla Client ID del Step 2.
- Introduzca el Client secret en la casilla Client Secret.
- 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.