Este módulo, brinda la posibilidad de incorporar en un sitio web un registro de usuario administrado por Mediastream, a través de una breve y segura integración con nuestro player, así es mas sencillo identificar el usuario final mediante el consumo de contenidos; el concepto de federaciones permite agrupar usuarios acorde al dominio y/o marca dentro de una misma cuenta.
La configuración de los formularios se destaca por usar principalmente los email, dns, RRSS y diferentes estilos en los widgets.
Federation Email Domains
Para la configuración de los login, debe configurarse previamente una federación, esta se encuentra en Customers> Federation Email Domains, esto determina el contexto al cual se están relacionando los usuarios que se registren usando este método.
En este grupo, se debe oprimir +Create New Domain, una vez se despliega la nueva interfaz, se añade el referrer del dominio y se indica Save, al hacerlo, platform genera de forma automática las llaves para configurar los respectivos registros TXT dentro del servidor DNS, una vez creadas, tardan hasta 72 horas en verificarse (recuadro rojo)
Cuando estas llaves están verificadas, se indicara con un icono verde en la columna status.
En caso de no ser aprobadas, se marcaran con una X.
Federation Group
En este módulo, se pueden ingresar la cantidad de grupos de federaciones, marcas o registros como sea necesario, los usuarios registrados dentro de cada grupo serán independientes y se crearan con diferentes customer_id.
Para crear un nuevo grupo, se oprime en +Create New Federation Group, esto cambia la interfaz de la siguiente manera:
A continuación, los campos se deben diligenciar de la siguiente manera:
1- Basic Information
Se ingresa un nombre y una descripción para el grupo de federación
2- Register Form
En esta sección se ingresan los campos de registro, por defecto, platform entrega 4 campos, esto son: email, password, first name y last name.
Los tipos de campo siempre se asignan a texto, área de texto, checkbox o fecha.
Se puede asignar un orden (1), el nombre del campo creado (2), indicar el tipo de campo (3), asignar el label que vera el usuario al desplegar el formulario de registro (4), se da también la opción de asignarlo como requerido y si este será o no editable en cara al usuario final (5), adicional, los campos se pueden eliminar simplemente con hacer click en el icono rojo con la papelera de la derecha
Nota, Los campos email y password siempre se ajustan como requeridos, únicamente es editable el password, NO PUEDEN SER BORRADOS.
En el caso de requerirse mas campos, basta con hacer click en +Add Field ubicado arriba a la izquierda, al hacerlo aparecerá el campo en el listado en el cual se pueden agregar las opciones birthday (fecha de nacimiento) que se asigna al tipo fecha, gender (genero) asignado a selección por defecto y metadata, en este ultimo se da la opción de agregar X cantidad de campos como sean necesarios.
Imagen de ejemplo:
3- Social Integration
Como indica su nombre, permite integrar un login por redes sociales, en este caso Google y Facebook, para hacerlo se debe hacer lo siguiente:
Google: Para obtener el Client ID y el Client Secret debe hacerse desde la página de desarrolladores de google https://console.developers.google.com/, desde allí se obtienen las respectivas claves desde el apartado Credenciales, recuerda hacer el proceso completo de creación del proyecto para obtener los ID requeridos.
Facebook: al igual que con Google, las credenciales requeridas, Public Key (App ID) y Private Key (App Secret) se obtienen desde la página de desarrolladores de Meta https://developers.facebook.com/apps, desde la configuración, en las opciones Básicas.
4- Security
Responde a la sección en donde se deben configurar los diferentes dominios donde funcionaran los widgets. Se pueden ver los siguientes campos:
Domains: los dominios permitidos para el Federation group, basta con anotar el mismo y oprimir enter.
Register options: sirve para seleccionar si se desea o no la validación de email antes del login.
Session options: en esta casilla indicamos la cantidad de días en que las sesiones inactivas expiren, por defecto se muestran inicialmente 30 días.
ReCaptcha v2 Integration: si deseas activar la opción de captcha para evitar que bots completen los formularios, puedes hacerlo en esta sección, en donde debes indicar el tipo de captcha Invisible o checkbox, así como ingresar la Site Key y Secret Key que obtienes desde la cuenta de Google.
reCAPTCHA Invisible |
 |
reCAPTCHA checkbox |
 |
Password options: acá configuras las diferentes opciones requeridas para la generación de contraseñas, como el mínimo y máximo de caracteres, letras mayusculas y minúsculas, números y caracteres especiales, se puede configurar a gusto.
5- Callbacks
En esta sección se configuran los endpoint en donde se desean recibir las acciones Login y Logout, las cuales entregan un token como respuesta mediante una solicitud GET, junto con el parámetro que indica si es login o logout, este es enviado a la API en donde se obtiene la información del usuario que se autenticó.
6- Email
Esta sección sirve para configurar los mensajes de bienvenida, confirmación y de recuperación de contraseña enviados al usuario autenticado, los email no serán enviados mientras el dominio no este verificado.
Inicialmente debes agregar el correo asociado en Federation Email Domains para que se pueda llevar a cabo el envío, junto con el nombre del remitente, el correo emisor debe contener exactamente el mismo dominio asignado a la federación, incluyendo mayúsculas y minúsculas:
Los correos se pueden editar desde email templates acorde a las siguientes palabras clave:
{first_name}
{last_name}
{email}
{url}
{federation_name}
Estos tags se interpretaran según los valores del registro de usuario y Federación, acorde a la sección seleccionada, se puede editar el texto en html dando la posibilidad de ingresar links, estilos, etc.
Al finalizar el proceso de configuración con los campos requeridos, no olvides guardar los cambios.
Si tienes alguna duda adicional, no dudes en consultarnos a través del chat.
Att: El equipo de Mediastream
