TOTP

Catalogue des nœuds Transformations

Sur cette page

Générer ou vérifier des codes à usage unique (2FA).

Utilisation et spécificités

Sélectionnez un identifiant TOTP contenant la graine ou l’URI otpauth. Gardez l’horloge synchronisée. La graine et les codes sont sensibles ; ne les placez pas dans une configuration partagée.

Type technique : totp. Runtime : nodulz.

Identifiants et prérequis

TOTP (integration / totp). Secret TOTP (base32 ou URI otpauth://)

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le guide des identifiants pour les accès et la rotation.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre	Type	Par défaut	Valeurs / limites
`operation`	`enum`	`"generate"`	`generate`, `verify`, `create_secret`
`credentialId`	`string`	`""`	-
`secret`	`string`	`""`	-
`code`	`string`	`""`	-
`algorithm`	`enum`	`"sha1"`	`sha1`, `sha256`, `sha512`
`digits`	`number`	`6`	-; ≥ 6, ≤ 8
`period`	`number`	`30`	-; ≥ 10, ≤ 300
`window`	`number`	`1`	-; ≥ 0, ≤ 5
`lastStep`	`string`	`""`	-
`issuer`	`string`	`""`	-
`accountName`	`string`	`""`	-
`secretLength`	`number`	`20`	-; ≥ 10, ≤ 64

Aide de configuration

operation Opération: Générer le code actuel, vérifier un code saisi ou créer un nouveau secret.
accountName Compte: Affiché dans l’application d’authentification.
issuer Émetteur: Nom du service affiché avec le compte.
secretLength Taille du secret (octets): 20 octets recommandés.
credentialId Identifiant TOTP: Secret stocké chiffré. Sinon, renseignez-le ci-dessous.
secret Secret: Clé base32 ou URI otpauth://. Les paramètres de l’URI sont prioritaires.
code Code à vérifier: Code saisi par l’utilisateur.
algorithm Algorithme: SHA-1 pour la plupart des applications.
digits Chiffres: Longueur du code.
period Période (secondes): Durée de validité d’un code.
window Tolérance (périodes): Périodes acceptées avant et après, pour absorber un décalage d’horloge.
lastStep Dernier pas accepté: Anti-rejeu : renvoyez ici le « step » mémorisé lors de la dernière validation. Un code déjà utilisé sera refusé.

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json

{
  "operation": "generate",
  "credentialId": "",
  "secret": "",
  "code": "",
  "algorithm": "sha1",
  "digits": 6,
  "period": 30,
  "window": 1,
  "lastStep": "",
  "issuer": "",
  "accountName": "",
  "secretLength": 20
}

Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.