Opciones de configuración de Lock

Lock tiene muchas opciones de configuración que te permiten cambiar el comportamiento, la apariencia y la conectividad del widget Lock; este recurso te ofrece información detallada sobre esas opciones.

Lock se puede configurar mediante el parámetro options que se envía al constructor. Estas opciones pueden modificar la forma en que se comporta el widget Lock, cómo gestiona las conexiones, los campos adicionales de registro que necesita para su proyecto, el idioma y los textos, los colores y las imágenes del widget, entre muchas otras cosas. Consulte el índice a continuación si sabe lo que está buscando o explore las opciones para obtener más información.

Interfaz de usuario

Opción	Descripción
allowAutocomplete	Habilita o deshabilita el autocompletado en los campos de correo electrónico o username
allowPasswordAutocomplete	Habilita o deshabilita el autocompletado en el campo de contraseña
allowShowPassword	Especifica si el usuario puede optar por mostrar la contraseña mientras la escribe
allowedConnections	Lista de conexiones disponibles para realizar la autenticación
autoclose	Especifica si Lock se cierra después de iniciar sesión
autofocus	Especifica si el foco se establece en el primer campo de entrada
avatar	Especifica si deben mostrarse un avatar y un username en el encabezado de Lock una vez que se haya introducido un correo electrónico o username, y cómo obtenerlo
closable	Determina si Lock puede cerrarse
container	El elemento HTML en el que se renderizará Lock. Esto hace que Lock aparezca integrado en la página en lugar de en una ventana modal
flashMessage	Muestra un mensaje flash de error o success cuando se muestra Lock
language	Especifica el idioma del widget
languageDictionary	Personaliza el texto usado para los elementos del widget (como etiquetas y marcadores de posición)
popupOptions	Personaliza la ubicación de la ventana emergente en la pantalla
rememberLastLogin	Indica si se debe mostrar una pantalla que te permita iniciar sesión rápidamente con la cuenta que usaste la última vez
scrollGlobalMessagesIntoView	Especifica si se debe desplazar un globalMessage hasta el área visible del usuario

Tema

Las opciones del tema se agrupan en la propiedad theme del objeto options.

Opción	Descripción
authButtons	Personaliza la apariencia de botones de conexión específicos
labeledSubmitButton	Indica si el botón de envío tiene texto o no
logo	Logotipo que se debe usar
primaryColor	Color del botón principal del widget

Autenticación

Las opciones de autenticación se agrupan en la propiedad auth del objeto options.

Opción	Descripción
audience	La API que consumirá tu Token de acceso
autoParseHash	Indica si se debe analizar automáticamente el hash y continuar
connectionScopes	Especifica los alcances de la conexión
params	Opción para enviar parámetros al iniciar sesión
redirect	Indica si se debe usar el modo de redirección
redirectUrl	La URL a la que redirigir después de la autenticación
responseMode	Opción para enviar la respuesta mediante POST
responseType	Respuesta como código o token
sso	Determina si el inicio de sesión único (SSO) está habilitado en Lock

Base de datos

Opción	Descripción
additionalSignUpFields	Campos adicionales recopilados durante el registro
allowLogin	Si se permite o no iniciar sesión en el widget
allowForgotPassword	Si se permite o no la opción de contraseña olvidada en el widget
allowSignUp	Si se permite o no registrarse en el widget
defaultDatabaseConnection	Conexión de base de datos que se muestra de forma predeterminada
initialScreen	Qué pantalla se mostrará al abrir el widget
loginAfterSignUp	Si se inicia sesión automáticamente después del registro
forgotPasswordLink	Enlace a una página personalizada de contraseña olvidada
showTerms	Especifica si deben mostrarse los términos de registro
mustAcceptTerms	Si es obligatorio aceptar los términos (casilla de verificación)
prefill	Valores precargados para los campos de correo electrónico/username
signUpLink	Establece una URL personalizada que se abrirá al hacer clic en “registrarse”
usernameStyle	Limita el campo username para aceptar solo valores de “username” o solo valores de “email”

Empresarial

Opción	Descripción
defaultEnterpriseConnection	Especifica una conexión si hay más de una disponible

Sin contraseña

Opción	Descripción
passwordlessMethod	Al usar Auth0LockPasswordless con una conexión de correo electrónico, puede usar esta opción para elegir si enviar un code o un enlace mágico para autenticar al usuario

Otros

Opción	Descripción
configurationBaseUrl	Anula la URL base de tu aplicación
languageBaseUrl	Anula la URL base de tu archivo de idioma
hashCleanup	Anula la eliminación predeterminada del hash de la URL
connectionResolver	Función de devolución de llamada opcional para elegir una conexión según la información del username

---

Opciones de la interfaz de usuario

allowAutocomplete

Indica si los campos de correo electrónico o username permitirán el autocompletado (<input autocomplete />). El valor predeterminado es false.

allowAutocomplete: true

allowPasswordAutocomplete

Determina si el campo de contraseña permitirá el autocompletado (<input autocomplete />). El valor predeterminado es false.

Establece allowPasswordAutocomplete en true para admitir gestores de contraseñas y evitar otros casos de comportamiento no deseado.

allowPasswordAutocomplete: true

allowShowPassword

Esta opción determina si se agrega o no una casilla de verificación en la interfaz de usuario que, al seleccionarla, permite al usuario mostrar su contraseña mientras la escribe. De forma predeterminada, esta opción es false.

allowShowPassword: true

Lock con allowShowPassword establecido en true y activado para mostrar la contraseña:

allowedConnections

Array de conexiones que se usarán para las acciones signin|signup|reset. De forma predeterminada, se usan todas las conexiones habilitadas.

allowedConnections: ['Username-Password-Authentication']

allowedConnections: ['twitter', 'facebook', 'linkedin']

allowedConnections: ['qraftlabs.com']

Ejemplos de allowedConnections:

autoclose

Determina si Lock se cerrará automáticamente después de iniciar sesión correctamente. El valor predeterminado es false. Si Lock no es closable, no se cerrará aunque esta opción esté configurada como true.

autoclose: true

autofocus

Si es true, el foco se sitúa en el primer campo del widget. El valor predeterminado es false cuando se renderiza en un dispositivo móvil o si se proporciona la opción container; en todos los demás casos, el valor predeterminado es true.

autofocus: false

avatar

De forma predeterminada, se usa Gravatar para obtener el avatar y el nombre para mostrar del usuario, pero puedes obtenerlos con la opción avatar desde cualquier origen.

var options = {
  avatar: {
    url: function(email, cb) {
      // Obtiene la URL del avatar para el correo electrónico ingresado por el usuario, Lock
      // precargará la imagen antes de mostrarla.
      // Ten en cuenta que en caso de error debes llamar a cb con el error en
      // el primer argumento en lugar de `null`.
      var url = obtainAvatarUrl(email);
      cb(null, url);
    },
    displayName: function(email, cb) {
      // Obtiene el nombre para mostrar del correo electrónico ingresado por el usuario.
      // Ten en cuenta que en caso de error debes llamar a cb con el error en
      // el primer argumento en lugar de `null`.
      var displayName = obtainDisplayName(email);
      cb(null, displayName);
    }
  }
};

O, si no quieres mostrar ningún avatar, simplemente pasa null.

avatar: null

Comportamiento predeterminado con Gravatar:

closable

Determina si Lock puede cerrarse o no. Cuando se proporciona la opción container, su valor siempre es false; de lo contrario, el valor predeterminado es true.

closable: false

container

El id del elemento HTML donde se mostrará el widget.

Esto hace que el widget aparezca integrado en tu div en lugar de en una ventana modal.

<div id="hiw-login-container"></div>

<script>
  var options = {
    container: 'hiw-login-container'
  };

  // inicializar
  var lock = new Auth0Lock('xxxxxx', '<account>.auth0.com', options);

  // renderizar
  lock.show();
</script>

flashMessage

Muestra un mensaje flash de error o success cuando se muestra Lock. Este objeto tiene las siguientes propiedades:

• type {String}: El tipo de mensaje; los tipos admitidos son error, info y success
• text {String}: El texto que se mostrará.

var options = {
  flashMessage: {
    type: 'success',
    text: 'Welcome!'
  }
};

language

Especifica el idioma del widget. El valor predeterminado es “en”. Consulta el directorio de internacionalización para obtener una lista actualizada de los idiomas disponibles.

language: 'es'

languageDictionary

Permite personalizar cada texto que se muestra en Lock. El valor predeterminado es . Consulta la especificación del diccionario de idioma en inglés para ver la lista completa de valores de languageDictionary que se pueden modificar con este objeto.

var options = {
  languageDictionary: {
    emailInputPlaceholder: "[e-mail]",
    title: "Log me in"
  },
};

Además, consulta la página Personalización de los mensajes de error o la página Internacionalización para obtener más información sobre el uso de la opción languageDictionary.

popupOptions

Permite personalizar la ubicación de la ventana emergente en la pantalla. Se acepta cualquier opción de posición y tamaño permitida por window.open. El valor predeterminado es .

Opciones para las características de window.open. Esto solo se aplica si redirect se establece en false.

var options = {
  auth: {
      redirect: false
  },
  popupOptions: { width: 300, height: 400, left: 200, top: 300 }
};

rememberLastLogin

Determina si se muestra una pantalla que permite iniciar sesión rápidamente con la cuenta que se usó la última vez. Solicita datos de inicio de sesión único (SSO) y habilita el mensaje La última vez iniciaste sesión con. El valor predeterminado es true. Esta información proviene de la sesión de Auth0 del usuario, por lo que esta funcionalidad estará disponible mientras dure su sesión de Auth0 (que es configurable).

rememberLastLogin: false

Los inquilinos nuevos tienen Seamless SSO habilitado automáticamente. Con esta opción habilitada, rememberLastLogin deja de ser relevante porque, si hay una sesión activa, la página de Universal Login no se mostrará en absoluto. Se recomienda encarecidamente usar Seamless SSO porque proporciona una experiencia de autenticación fluida: los usuarios inician sesión una vez y no tendrán que volver a introducir sus credenciales al navegar entre las aplicaciones que has creado o las de terceros. Si el usuario no ha iniciado sesión, se lo redirigirá a la pantalla de inicio de sesión, como es de esperar. Además, el mensaje La última vez iniciaste sesión con no estará disponible en las siguientes circunstancias:

• Usaste Lock en una página de inicio de sesión alojada con la sesión establecida mediante autenticación sin contraseña.
• Usaste Lock en un escenario de inicio de sesión integrado en el que se usa responseType: code (lo que indica el flujo de código de autorización, que se usa para aplicaciones web regulares).

scrollGlobalMessagesIntoView

Determina si globalMessage debe desplazarse hasta quedar visible para el usuario. El valor predeterminado es true.

scrollGlobalMessagesIntoView: false

Opciones de tema

Las opciones de tema se agrupan en la propiedad theme del objeto options.

var options = {
  theme: {
    labeledSubmitButton: false,
    logo: "https://example.com/assets/logo.png",
    primaryColor: "green",
    authButtons: {
      connectionName: {
        displayName: "...",
        primaryColor: "...",
        foregroundColor: "...",
        icon: "https://.../logo.png"
      }
    }
  }
};

authButtons

Permite personalizar los botones de Lock con conexiones OAuth2 personalizadas. Cada conexión personalizada cuyo botón quiera personalizar debe incluirse por nombre, cada una con su propio conjunto de parámetros. Los parámetros que se pueden personalizar se enumeran a continuación:

• displayName {String}: El nombre que se mostrará en lugar del nombre de la conexión al crear el título del botón, por ejemplo, LOGIN WITH MYCONNECTION para el inicio de sesión).
• primaryColor {String}: El color de fondo del botón. El valor predeterminado es #eb5424.
• foregroundColor {String}: El color del texto del botón. El valor predeterminado es #FFFFFF.
• icon {String}: La URL del icono de esta conexión. Por ejemplo: http://site.com/logo.png.

var options = {
  theme: {
    authButtons: {
      "testConnection": {
        displayName: "Test Conn",
        primaryColor: "#b7b7b7",
        foregroundColor: "#000000",
        icon: "http://example.com/icon.png"
      },
      "testConnection2": {
        primaryColor: "#000000",
        foregroundColor: "#ffffff",
      }
    }
  }
};

labeledSubmitButton

Esta opción indica si el botón de envío debe llevar una etiqueta y su valor predeterminado es true. Si se establece en false, se mostrará un icono en su lugar.

var options = {
  theme: {
    labeledSubmitButton: false
  }
};

Si la etiqueta está establecida en true, que es el valor predeterminado, el texto de la etiqueta se puede personalizar mediante la opción languageDictionary.

logo

El valor de logo es la URL de una imagen que se colocará en el encabezado de Lock y, de forma predeterminada, usa el logotipo de Auth0. Se recomienda una altura máxima de 58px para ofrecer una mejor experiencia de usuario.

var options = {
  theme: {
    logo: 'https://example.com/logo.png'
  }
};

primaryColor

La propiedad primaryColor define el color principal de Lock; todos los colores usados en el widget se calculan a partir de él. Esta opción resulta útil al proporcionar un logo personalizado, para garantizar que todos los colores combinen bien con la paleta del logo. El valor predeterminado es #ea5323.

var options = {
  theme: {
    logo: 'https://example.com/logo.png',
    primaryColor: '#31324F'
  }
};

Opciones de autenticación

Las opciones de autenticación se agrupan en la propiedad auth del objeto options.

El scope predeterminado que utiliza Lock es openid profile email.

var options = {
  auth: {
   params: {
    param1: "value1",
    scope: "openid profile email"
   },
   autoParseHash: true,
   redirect: true,
   redirectUrl: "some url",
   responseMode: "form_post",
   responseType: "token",
   sso: true,
   connectionScopes: {
    connectionName: [ 'scope1', 'scope2' ]
   }
  }
};

audience

La opción audience indica la API que consumirá el Token de acceso que se recibe después de la autenticación.

autoParseHash

Cuando autoParseHash se configura como true, Lock analizará la cadena window.location.hash al instanciarse. Si se configura como false, tendrás que reanudar manualmente la autenticación mediante el método resumeAuth.

var options = {
  auth: {
    autoParseHash: false
  }
};

connectionScopes

Esta opción permite establecer los alcances que se enviarán a la conexión oauth2/social para la autenticación.

var options = {
  auth: {
    connectionScopes: {
      'facebook': ['scope1', 'scope2']
    }
  }
};

Puede obtenerse del proveedor correspondiente una lista de alcances específicos para sus conexiones sociales. Por ejemplo, la documentación de Facebook for Developers incluye una lista de permisos individuales que se pueden solicitar para su conexión.

params

Puede enviar parámetros al iniciar sesión agregándolos al objeto de opciones. En el siguiente ejemplo, se agrega un parámetro state con el valor foo y también un parámetro scope (que incluye el scope y, a continuación, los atributos solicitados).

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

Para obtener más información sobre los parámetros compatibles, consulta Lock Authentication Parameters.

redirect

El valor predeterminado es true. Cuando se establece en true, se utiliza el modo de redirección. Si se establece en false, se usa el modo emergente.

var options = {
  auth: {
    redirect: false
  }
};

redirectUrl

La URL a la que Auth0 redirigirá tras la autenticación. El valor predeterminado es la cadena vacía "" (sin URL de redirección).

var options = {
  auth: {
    redirectUrl: 'http://testurl.com'
  }
};

Cuando se proporciona redirectUrl (es decir, se establece con un valor no vacío), la opción responseType tomará code como valor predeterminado si no se configura manualmente.

responseMode

Debe establecerse en "form_post" si quiere que el code o el token se transmitan mediante una solicitud HTTP POST a redirectUrl, en lugar de incluirse en los componentes de consulta o fragmento de la URL.

De lo contrario, esta opción debe omitirse; de forma predeterminada, se omite.

var options = {
  auth: {
    responseMode: 'form_post'
  }
};

responseType

El valor de responseType debe establecerse como “token” para las aplicaciones de una sola página y como “code” en caso contrario. El valor predeterminado es “code” cuando se proporciona redirectUrl y, en caso contrario, “token”.

var options = {
  auth: {
    responseType: 'token'
  }
};

Cuando responseType se establece en code, Lock nunca mostrará el mensaje La última vez que iniciaste sesión con, y siempre pedirá al usuario que introduzca sus credenciales.

sso

El valor predeterminado es true. Cuando se establece en true, habilita el inicio de sesión único (SSO) en Lock.

var options = {
  auth: {
    sso: false
  }
};

Opciones de la base de datos

additionalSignUpFields

Se pueden añadir campos de entrada adicionales a la pantalla de registro con la opción additionalSignUpFields. Cada opción que se añada de esta forma se incorporará al user_metadata del usuario. Para obtener más información, consulte Cómo funcionan los metadatos en los perfiles de usuario. Cada campo debe tener un name y un placeholder, y también puede proporcionarse una URL para icon. Además, puede indicarse un valor inicial con la opción prefill, que puede ser una cadena con el valor o una función que lo obtenga. Las demás opciones dependen del tipo de campo, que se define mediante la opción type y cuyo valor predeterminado es “text”.

Opción additionalSignUpFields pensada para usarse solo con el registro en base de datos

Los additionalSignUpFields están pensados para usarse solo con registros en base de datos. Si también tiene registros sociales, puede solicitar la información adicional después de que los usuarios se registren (consulte esta página sobre registro personalizado para obtener más detalles). Puede usar la clave de i18n databaseAlternativeSignupInstructions para mostrar estas instrucciones.

Los nuevos campos se muestran debajo de los campos de entrada habituales del registro, en el orden en que se proporcionan.

Campos de texto

Los campos de texto son el tipo predeterminado de campo adicional para el registro. Tenga en cuenta que también puede proporcionarse una función validator.

var options = {
  additionalSignUpFields: [{
    name: "address",
    placeholder: "enter your address",
    // Las siguientes propiedades son opcionales
    icon: "https://example.com/assests/address_icon.png",
    prefill: "street 123",
    validator: function(address) {
      return {
         valid: address.length >= 10,
         hint: "Must have 10 or more chars" // opcional
      };
    }
  },
  {
    name: "full_name",
    placeholder: "Enter your full name"
  }]
}

Si no especifica un validator, el campo de texto será obligatorio. Si quiere que el campo de texto sea opcional, use un validador que siempre devuelva true, de esta forma:

var options = {
  additionalSignUpFields: [{
    name: "favorite_color",
    placeholder: "Enter your favorite color (optional)",
    validator: function() { 
      return true;
    }
  }]
}

Si desea guardar el valor del atributo en la raíz de su perfil, use storage: 'root'. Solo algunos valores pueden almacenarse de esta forma. La lista de atributos que pueden añadirse a la raíz de su perfil está aquí. De forma predeterminada, cada campo de registro adicional se almacena dentro del objeto user_metadata.

var options = {
  additionalSignUpFields: [{
    name: "name",
    storage: "root"
  }]
};

Campo de selección

El campo de registro type: "select" le permitirá usar elementos de selección para que el usuario pueda elegir un valor.

var options = {
  additionalSignUpFields: [{
    type: "select",
    name: "location",
    placeholder: "choose your location",
    options: [
      {value: "us", label: "United States"},
      {value: "fr", label: "France"},
      {value: "ar", label: "Argentina"}
    ],
    // Las siguientes propiedades son opcionales
    icon: "https://example.com/assests/location_icon.png",
    prefill: "us"
  }]
}

Los elementos del array options de los campos select deben ajustarse al siguiente formato: {label: “cadena no vacía”, value: “cadena no vacía”}, y debe definirse al menos una opción.

Los valores de options y prefill pueden proporcionarse mediante una función:

var options = {
  additionalSignUpFields: [{
    type: "select",
    name: "location",
    placeholder: "choose your location",
    options: function(cb) {
      // obtener opciones, en caso de error llama a cb con el error en el
      // primer argumento en lugar de null
      cb(null, options);
    },
    icon: "https://example.com/assests/location_icon.png",
    prefill: function(cb) {
      // obtener prefill, en caso de error llama a cb con el error en el
      // primer argumento en lugar de null
      cb(null, prefill);
    }
  }]
}

Campo de casilla de verificación

El tercer tipo de campo de registro personalizado es type: "checkbox". El valor de prefill puede determinar el valor predeterminado de la casilla de verificación (true o false) y es obligatorio.

var options = {
  additionalSignUpFields: [{
    type: "checkbox",
    name: "newsletter",
    prefill: "true",
    placeholder: "I hereby agree that I want to receive marketing emails from your company"
  }]
}

Campo oculto

El campo de registro type: "hidden" te permite usar un campo oculto con un valor fijo.

var options = {
  additionalSignUpFields: [{
    type: "hidden",
    name: "signup_code",
    value: "abc123"
  }]
}

En algunos casos de uso, se pueden aprovechar los datos de additionalSignUpFields en las plantillas de correo electrónico; por ejemplo, una opción de preferencia de idioma, cuyo valor podría usarse luego para establecer el idioma de las comunicaciones por correo electrónico generadas a partir de plantillas.

allowLogin

Cuando se establece en false, el widget no mostrará la pantalla de inicio de sesión. Esto resulta útil si desea usar el widget solo para registros (las pestañas de inicio de sesión y registro en la pantalla de registro estarán ocultas) o para restablecer contraseñas (el botón de retroceso en la pantalla de contraseña olvidada estará oculto). En estos casos, también puede ser necesario especificar las opciones initialScreen, allowForgotPassword y allowSignUp. El valor predeterminado es true.

allowLogin: false

allowForgotPassword

Cuando se establece en false, allowForgotPassword oculta el enlace “¿No recuerdas tu contraseña?” en la pantalla de inicio de sesión, lo que hace que la pantalla de recuperación de contraseña sea inaccesible. El valor predeterminado es true. Si usas una conexión de base de datos con una base de datos personalizada que no tiene un script para cambiar la contraseña, la pantalla de recuperación de contraseña no estará disponible.

allowForgotPassword: false

allowSignUp

Cuando se establece en false, oculta las pestañas de inicio de sesión y registro en la pantalla de inicio de sesión, lo que hace que no se pueda acceder a la pantalla de registro. El valor predeterminado es true. Ten en cuenta que, si la conexión de base de datos tiene los registros deshabilitados o estás usando una base de datos personalizada que no tiene un script de creación, la pantalla de registro no estará disponible.

Ten en cuenta también que esta opción solo controla la apariencia del lado del cliente y no impide por completo que visitantes anónimos decididos creen cuentas nuevas. Si quieres evitar por completo que nuevos usuarios se registren, debes usar la opción Disable Sign Ups en el Dashboard, en la configuración de la conexión.

allowSignUp: false

defaultDatabaseConnection

Especifica qué conexión de base de datos se utilizará cuando haya más de una disponible.

defaultDatabaseConnection: 'test-database'

initialScreen

El nombre de la pantalla que se mostrará al abrir el widget. Los valores válidos son login, signUp y forgotPassword. Si no se especifica esta opción, el widget usará de forma predeterminada la primera pantalla disponible de esa lista.

initialScreen: 'forgotPassword'

loginAfterSignUp

Determina si el usuario iniciará sesión automáticamente después de registrarse correctamente. El valor predeterminado es true.

loginAfterSignUp: false

forgotPasswordLink

Establece la URL de una página que permite al usuario restablecer su contraseña. Cuando se establece con una cadena no vacía, se redirigirá al usuario a la URL proporcionada al hacer clic en el enlace “¿No recuerdas tu contraseña?” en la pantalla de inicio de sesión.

forgotPasswordLink: 'https://yoursite.com/reset-password'

showTerms

Si se establece en true, muestra la cadena languageDictionary.signUpTerms. El valor predeterminado es true.

showTerms: false

mustAcceptTerms

Cuando se establece en true, muestra una casilla de verificación junto a los términos y condiciones, que deben aceptarse antes de registrarse. Los términos y condiciones se pueden especificar mediante la opción languageDictionary. Esta opción solo surte efecto para los usuarios que se registran con conexiones de base de datos. El valor predeterminado es false.

mustAcceptTerms: true

prefill

Permite establecer el valor inicial de los campos de correo electrónico y/o username. Si se omite, no se proporcionará ningún valor inicial.

var options = {
  prefill: {
    email: "[e-mail]",
    username: "someone",
    phoneNumber: "[phone]"
  }
};

signUpLink

Establece la URL a la que se enviará la solicitud al hacer clic en el botón de registro. Cuando se establece como una cadena no vacía, esta opción fuerza allowSignUp a true.

signUpLink: 'https://yoursite.com/signup'

usernameStyle

Determina qué se usará para identificar al usuario en una conexión de base de datos que tenga activada la marca requires_username (si no está activada, se ignorará la opción usernameStyle). Los valores posibles son "username" y "email". De forma predeterminada, se permiten tanto username como email; al establecer esta opción, se limitarán los inicios de sesión para que usen uno u otro.

usernameStyle: 'username'

Opciones empresariales

defaultEnterpriseConnection

Especifica la conexión empresarial que permite iniciar sesión con un username y una contraseña, y que se utilizará cuando haya más de una disponible o cuando exista una conexión de base de datos. Si se proporciona defaultDatabaseConnection, se utilizará la conexión de base de datos y se ignorará esta opción.

defaultEnterpriseConnection: 'test-database'

defaultADUsernameFromEmailPrefix

Obtiene el username provisional de AD a partir del prefijo del correo electrónico. El valor predeterminado es true.

defaultADUsernameFromEmailPrefix: false

Opciones de inicio de sesión sin contraseña

passwordlessMethod

Al usar Auth0LockPasswordless con una conexión de correo electrónico, puede usar esta opción para elegir entre enviar un code o un magic link para autenticar al usuario. Los valores disponibles para las conexiones de correo electrónico son code y link. El valor predeterminado es code. Las conexiones sin contraseña por SMS siempre usarán code.

passwordlessMethod: code

Otras opciones

configurationBaseUrl

Anula la URL base de configuración de la aplicación. De forma predeterminada, usa el dominio proporcionado. Esta opción solo es necesaria si tu caso de uso específico requiere que la aplicación no use el comportamiento predeterminado.

configurationBaseUrl: "https://www.example.com"

languageBaseUrl

Anula la URL base del idioma para las traducciones proporcionadas por Auth0. De forma predeterminada, esta opción usa la URL de CDN de Auth0 https://cdn.auth0.com, ya que es donde se almacenan todas las traducciones proporcionadas. Si especifica otro valor, puede usar otra fuente para las traducciones de idioma, si es necesario.

languageBaseUrl: "https://www.example.com"

hashCleanup

Cuando la opción hashCleanup está habilitada, elimina la parte de hash de la URL de devolución de llamada después de la autenticación del usuario. El valor predeterminado es true.

hashCleanup: false

connectionResolver

Cuando se utiliza, proporciona un punto de extensión que permite elegir qué conexión usar según la información de username.

Recibe username, context y callback como parámetros. El callback espera un objeto como este: {type: 'database', name: 'connection name'}. Esto solo funciona con conexiones de base de datos. Ten en cuenta que esta función se ejecutará en el evento onSubmit del formulario, así que procura que sea simple y rápida.

Esta funcionalidad está en beta. Si encuentras un error, abre un issue en GitHub.

leeway

La opción leeway puede establecerse como un entero (un valor en segundos) para tener en cuenta la desincronización del reloj en el vencimiento del ID Token. Normalmente, el valor no supera uno o dos minutos.

leeway: 30