# Páginas configurables Algunas páginas predefinidas para tareas comunes admiten parámetros en la URL para configurar su comportamiento. ## Inicio de sesión Url: ```https://api.induxsoft.net/auth/login/form/``` Parámetros de URL admitidos (todos son opcionales) * uid - Cadena (sin codificar), con el Id de un usuario que de ser válido hace que la página únicamente solicite contraseña * success - Cadena codificada con el algoritmo de la función DKL ```url_encode``` que contiene una URL de salida (si el usuario se ha autenticado exitosamente) en la que se puede indicar la posición en la que se insertará el token (id) de sesión. * msg - Cadena codificada con el algoritmo de la función DKL ```url_encode``` que contiene un mensaje a mostrar en la página Ejemplos: ``` https://api.induxsoft.net/auth/login/form/?uid=ID_DE_USUARIO&success=CADENA_CODIFICADA_CON_UNA_URL&msg=MENSAJE_CODIFICADO ``` Para generar la cadena de la URL de salida, use la función DKL ```url_encode```. Debe incluir en la URL de salida, el marcador donde se incluirá el id (token de sesión), las macros para el marcador (equivalentes)son: @token y @ids Por ejemplo, si quiere redirigir con sesión iniciada hacia el sitio docs.induxsoft.net, deberá formar la url así: ``` https://docs.induxsoft.net/?ids=@token ``` ## Confirmación de dirección de correo electrónico Esta URL se envía por correo electrónico incluyendo el 'Código de registro' (signup code) ``` Url: https://api.induxsoft.net/auth/signup/verify.dkl?signup_code=CODIGO_DE_REGISTRO&success=URL_CODIFICADA&fail=URL_CODIFICADA ``` Parámetros de URL admitidos (todos son opcionales) * signup_code - Cadena (sin codificar), con el código de registro de un usuario nuevo (vea el servicio signup) * success - Cadena codificada con el algoritmo de la función DKL ```url_encode``` que contiene una URL de salida (si hay éxito) * fail - Cadena codificada con el algoritmo de la función DKL ```url_encode``` que contiene una URL de salida (si fracasa la confirmación) La URL de salida exitosa admite los siguientes marcadores de posición: * @signup_code - Contiene el código de registro del usuario * @uid - Contiene el ID del usuario registrado La URL de salida por error, admite el marcador @last_error que contiene el mensaje de error codificado con el algoritmo de DKL url_encode ## Alta de empresa mexicana Url: ```https://induxsoft.net/?idpf=862864cdd2cd46aaa7fb98f555a7baa6``` Muestra el formulario para crear la cuenta de una empresa mexicana, admite el parámetro de URL induxsoft_ids para indicar un token (id) de sesión válido Ejemplo: ``` https://induxsoft.net/?idpf=862864cdd2cd46aaa7fb98f555a7baa6&induxsoft_ids=TOKEN_DE_SESION ``` ## Creación de perfil a partir de un Lead de induxsoft URL: ```https://marketing.induxsoft.net/es/mx/interface/loginfromlead.dkl``` Crea un usuario o recupera su uid a partir de un lead y lo redirige Requiere que se proporcionen los siguientes parámetros GET: * email=EMAIL o mobile=NUMERO * signup=url de redirección si se crea un nuevo usuario, codificada con DKL url_encode * exist=url de redirección si ya existe un usuario con el correo o teléfono, codificada con DKL url_encode del lead creado. * url=URL de salida predeterminada Importante: Todas las URL en los parámetros (signup, exist o url) deben estar codificadas con la función de Devkron ```url_encode```. Lógica * Si se omite signup y exist, se redirigirá a la URL predeterminada * Si se omite signup o exist (una pero no ambas), se redirigirá en todos los casos a la que se haya indicado * Si no encuentra el lead u ocurre un error, la página mostrará un mensaje informativo La url predeterminada de redirección es: ```https://api.induxsoft.net/auth/login/form/?uid=@uid&last_action=@last_action```, pero puede cambiarse a través del parámetro url. ## Registro de usuario Url: ```https://api.induxsoft.net/auth/signup/form/``` Muestra el formulario para registrar un nuevo usuario. Parámetros de URL admitidos (todos son opcionales) * signup-mode - 0 (predeterminada) muestra los campos de nombre, correo y teléfono en el formulario. 1 muestra además de los anteriores el campo de contraseña. 2 muestra además de los anteriores mencionados el campo de confirmar contraseña. * success - Cadena codificada con el algoritmo de la función DKL ```url_encode``` que contiene una URL de salida (si el usuario se ha autenticado exitosamente) en la que se puede indicar la posición en la que se insertará el token (id) de sesión. Si se omite lo redirige a la página de inicio de sessión * signup-leadsubj - Texto del asunto del lead, si se omite tomará como predeterminado "Nuevo usuario" ## Solicitar recuperación de contraseña Url: ```https://api.induxsoft.net/auth/login/signup/pwd-recovery.dkl``` Muestra el formulario para recupera la contraseña del usuario mediante su correo o móvil. Este formulario envía un 'Código de solicitud' a la dirección de correo del usuario y un 'Código de seguridad' al teléfono móvil para solicitar el cambio de contraseña. Configuración * Se puede configurar la página de redirección si se tiene exito en la solicitud. De forma predeterminada nos redirige a una página con el mensaje 'Se ha enviado un mensaje de correo electrónico con las instrucciones de recuperación de contraseña'. ## Cambio de contraseña Url: ```https://api.induxsoft.net/auth/signup/pwd-recovery.dkl``` Muestra el formulario para cambiar de contraseña ingresando el código de seguridad enviado por la página de 'Solicitud de recuperación de contraseña'. Al realizar el proceso exitosamente redirige a la página de 'Inicio de sesión'. Requiere que se proporcionen los siguientes parámetros GET: * rcode - Código de solicitud de recuperación de contraseña (normalmente viene incluido en la url que llega al correo al solicitar el cambio de contraseña) # Herramienta de codificación de URLs Si no dispone de una instalación de Devkron para ejecutar un programa que le permita codificar las URLs puede utilizar la siguiente página: ``` https://intranet.induxsoft.net/devops/desarrollo/herramientas/encode.dkl ```