LoginId - Auth0 Docs

Example

import LoginId from "@auth0/auth0-acul-js/login";
const loginIdManager = new LoginId();
loginIdManager.getLoginIdentifiers();

Constructeurs

Crée une instance de la classe LoginIdManager.

Propriétés

string

Méthodes

Example

import LoginId from "@auth0/auth0-acul-js/login-id";
const loginIdManager = new LoginId();

// Vérifiez si alternateConnections est disponible et contient au moins un élément
if (!loginIdManager.transaction.alternateConnections) {
  console.error('No alternate connections available.');
}

// Sélectionnez la première connexion disponible (les utilisateurs peuvent sélectionner n'importe quelle connexion disponible)
const selectedConnection = alternateConnections[0];

// Consignez la connexion choisie à des fins de débogage ou d'information
console.log(`Selected connection: ${selectedConnection.name}`);

// Procédez à la connexion fédérée en utilisant la connexion sélectionnée
loginIdManager.federatedLogin({
  connection: selectedConnection.name,
});

Afficher Paramètres

Propriétés

string

Renvoie le tableau des erreurs de transaction à partir du contexte, ou un tableau vide s’il n’en existe aucune.

Fonction utilitaireRenvoie les types d’identifiants actifs pour l’écran de connexion.

Example

import LoginId from "@auth0/auth0-acul-js/login";
const loginIdManager = new LoginId();
loginIdManager.getLoginIdentifiers();

Example

import LoginId from "@auth0/auth0-acul-js/login-id";

const loginIdManager = new LoginId();

loginIdManager.login({
  username: <usernameFieldValue>
});

Afficher Paramètres

Propriétés

string

Example

import LoginId from "@auth0/auth0-acul-js/login-id";
const loginIdManager = new LoginId();

// Cette méthode associe en interne la configuration de passkey disponible pour les utilisateurs, telle que fournie par le serveur Auth0
loginIdManager.passkeyLogin();

Afficher Paramètres

Promise<void>

Example

import LoginId from "@auth0/auth0-acul-js/login-id";
const loginIdManager = new LoginId();

loginIdManager.pickCountryCode();

Afficher Paramètres

Passkeys

Promise<void>

Utility FeatureEnregistre l’interface utilisateur conditionnelle du navigateur pour les passkeys (expérience de saisie semi-automatique).Cette méthode initialise une requête passive d’identifiants WebAuthn à l’aide de navigator.credentials.get() avec mediation: "conditional". Lorsque cette fonctionnalité est prise en charge, elle permet au navigateur d’afficher les passkeys enregistrés directement dans la liste de saisie semi-automatique du champ de nom d’utilisateur.Appelez cette méthode une seule fois lorsque l’écran de connexion est initialisé (par exemple, au chargement de la page). Après l’enregistrement, le fait de placer le curseur dans le champ de nom d’utilisateur affichera automatiquement les passkeys correspondants comme suggestions. La sélection d’un passkey finalise l’authentification sans nécessiter d’interaction supplémentaire de la part de l’utilisateur.

Configuration de l’élément `input`

Si un inputId est fourni, la Trousse de développement logiciel (SDK) va :

Valider que l’élément existe et qu’il s’agit d’un <input>.
Remplacer son attribut autocomplete par "webauthn username".

Cela garantit une compatibilité complète avec l’API Conditional Mediation. Si vous ne fournissez pas de inputId, vous êtes responsable de configurer l’élément d’entrée manuellement avec les attributs appropriés :

<input id="username" autocomplete="webauthn username" />

Pièges à éviter

L’attribut autocomplete doit contenir exactement "webauthn username". L’ajout de jetons non liés comme "email" ou "text" empêchera les navigateurs d’afficher la liste déroulante de passkeys.
Le fait d’écraser l’attribut est intentionnel et nécessaire pour assurer un comportement cohérent d’un navigateur à l’autre. Ne comptez pas sur la fusion ou l’extension des valeurs autocomplete existantes.
Si la médiation conditionnelle n’est pas prise en charge par le navigateur, le SDK se contentera de ne rien faire (no-op) en toute sécurité.

Paramètres

string

stringID facultatif de l’élément <input> pour le nom d’utilisateur (sans #). Exemple : "username". S’il est omis, le développeur doit veiller manuellement à ce que les attributs autocomplete soient corrects.

Example

import LoginId from '@auth0/auth0-acul-js/login-id';

// Exemple : initialisation de la saisie automatique de clé d'accès dans un bloc de configuration asynchrone.
async function initializeLogin() {
  const loginId = new LoginId();
  // Assurez-vous que l'élément input HTML associé existe :
  // <input id="username" autocomplete="webauthn username" />
  // Enregistrement conditionnel de l'IU.
  await loginId.registerPasskeyAutofill('username');
}

initializeLogin().catch(console.error);

Remarques

Cette méthode délègue à l’utilitaire interne registerPasskeyAutofill(), qui renvoie en arrière-plan un AbortController pour gérer la durée de vie de la requête. Elle ne doit être appelée qu’une seule fois par cycle de vie de la page.

​Constructeurs

​Propriétés

​Méthodes

​Passkeys

​Configuration de l’élément input

​Pièges à éviter

​Paramètres

​Remarques

Constructeurs

Propriétés

Méthodes

Passkeys

Configuration de l’élément `input`

Pièges à éviter

Paramètres

Remarques