Parámetros de autenticación de Lock

Documentación de Lock sobre cómo configurar parámetros de autenticación.

Puede enviar parámetros al iniciar sesión añadiéndolos al objeto de opciones. En el siguiente ejemplo, se agrega un parámetro state con el valor 'foo'.

var options = {
  auth: {
    params: {state: 'foo'},
  }
};

El ejemplo anterior sería equivalente a iniciar el inicio de sesión con https://{yourDomain}/authorize?state=foo&....

Se admiten los siguientes parámetros: scope, device, nonce y state.

Parámetros admitidos

scope

var options = {
  auth: {
    params: {scope: 'openid email user_metadata app_metadata picture'},
  }
};

Hay distintos valores admitidos para scope. Tenga en cuenta que los JWTs se envían en cada solicitud a la API, por lo que conviene mantenerlos lo más pequeños posible.

El valor predeterminado de scope en Lock es openid profile email. Este valor mínimo de scope es necesario para que la funcionalidad Última vez que inició sesión con funcione correctamente.

Ejecutar Lock localmente

Si no especifica manualmente al menos el valor predeterminado de scope, openid profile email, al inicializar Lock, y ejecuta su sitio web desde http://localhost o http://127.0.0.1, verá el siguiente error en la consola del navegador:

Consent required. When using getSSOData, the user has to be authenticated with the following scope: openid profile email

Eso no ocurrirá cuando ejecute su aplicación en producción o si especifica el scope openid profile email. Puede obtener más información en el documento Consentimiento del usuario y aplicaciones de terceros.

Para obtener más información sobre los alcances, consulte la página de documentación sobre alcances.

Ejemplo: obtener un token

En Lock, si desea recibir un token con capacidad para obtener los datos del perfil del usuario, debe agregar el parámetro scope.

var options = {
  auth: {
    params: {
        scope: 'openid profile'
    }
  }
};

También existe una opción de configuración connectionScopes para Lock que le permite especificar alcances para una conexión concreta. Esto resulta útil si quiere comenzar con un conjunto de alcances (definidos en el panel) y, más adelante, solicitar permisos o atributos adicionales de una conexión específica. Obtenga más información en la página Opciones de configuración de Lock.

state

El parámetro state es un valor arbitrario que se mantiene durante las redirecciones. Es útil para mitigar los ataques XSRF y para conservar información contextual, como una URL de retorno, que puedas necesitar cuando haya finalizado el proceso de autenticación. Si no se proporciona un parámetro state personalizado, Lock generará uno automáticamente. Para obtener más información, consulta State Parameter.

nonce

El parámetro nonce se utiliza para ayudar a prevenir ataques de repetición, y Lock lo generará automáticamente si no se proporciona un valor personalizado.

device

El parámetro device indica el nombre del dispositivo o navegador que solicita la autenticación.