---
updatedAt: 2026-05-21T16:39:34.000Z
---
# Récupérer la configuration du mot de passe à usage unique basé sur l'heure.
Récupérer la configuration du mot de passe à usage unique basé sur le temps.
Entitlements:
- manageMFAMethods (Gérer la configuration de la méthode d'authentification à deuxième facteur)
- readMFAMethods (Lire la configuration de la méthode d'authentification à deuxième facteur)
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"version": "1.0.0",
"description": "Authentication Configuration",
"title": "Authentication Configuration"
},
"servers": [
{
"url": "https://{tenanturl}",
"variables": {
"tenanturl": {
"default": "{tenant_url}",
"description": "URL of your IBM Security Verify tenant"
}
}
}
],
"tags": [
{
"name": "Time-based One-time Password Configuration 2.0"
}
],
"paths": {
"/config/v2.0/factors/totp": {
"get": {
"tags": [
"Time-based One-time Password Configuration 2.0"
],
"summary": "Récupérer la configuration du mot de passe à usage unique basé sur l'heure.",
"description": "Récupérer la configuration du mot de passe à usage unique basé sur le temps.
Entitlements:
- manageMFAMethods (Gérer la configuration de la méthode d'authentification à deuxième facteur)
- readMFAMethods (Lire la configuration de la méthode d'authentification à deuxième facteur)",
"operationId": "getTotpConfiguration_2.0",
"responses": {
"200": {
"description": "La configuration spécifique.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TotpConfiguration_2.0"
}
}
}
},
"401": {
"description": "L'utilisateur non authentifié ne dispose pas des autorisations nécessaires pour effectuer l'opération demandée",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Unauthorized_0"
}
}
}
},
"403": {
"description": "L'utilisateur authentifié ne dispose pas des autorisations nécessaires pour effectuer l'opération demandée",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Forbidden_1"
}
}
}
}
},
"x-publicAPI": "true",
"x-category": "Authentication Configuration"
}
}
},
"components": {
"schemas": {
"TotpConfiguration_2.0": {
"required": [
"algorithm",
"digits",
"enabled",
"keyUri",
"oneTimeUse",
"period",
"periodSkew"
],
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"description": "L'algorithme utilisé pour générer le mot de passe à usage unique",
"example": "SHA1",
"enum": [
"SHA1",
"SHA256",
"SHA512"
]
},
"digits": {
"maximum": 12,
"minimum": 6,
"type": "integer",
"description": "Le nombre de chiffres du mot de passe à usage unique",
"format": "int32",
"example": 6
},
"enabled": {
"type": "boolean",
"description": "L'état activé du mot de passe à usage unique basé sur le temps à utiliser dans les flux d'exécution",
"example": true
},
"keyUri": {
"type": "string",
"description": "Le format URI à utiliser pour fournir les clés secrètes",
"example": "otpauth://totp/IBM%20Security%20Verify:@USER_NAME@?secret=@SECRET_KEY@&issuer=IBM%20Security%20Verify&algorithm=@ALGORITHM@"
},
"oneTimeUse": {
"type": "boolean",
"description": "Si les mots de passe à usage unique ne peuvent être utilisés qu'une seule fois au cours de la période donnée",
"example": true
},
"period": {
"maximum": 1800,
"minimum": 1,
"type": "integer",
"description": "Le nombre de secondes restant avant l'expiration du mot de passe à usage unique",
"format": "int32",
"example": 30
},
"periodSkew": {
"maximum": 5,
"minimum": 0,
"type": "integer",
"description": "Les intervalles d'inclinaison de la période à prendre en compte pour le délai de synchronisation entre le serveur et le client générant le mot de passe à usage unique. Par exemple, un intervalle de décalage de 2 signifie qu'un mot de passe à usage unique sera valide dans un maximum de deux intervalles passés ou deux intervalles futurs",
"format": "int32",
"example": 1
},
"enrollments": {
"maximum": 5,
"minimum": 1,
"type": "integer",
"description": "Le nombre maximum d'inscriptions qu'un utilisateur spécifique peut effectuer",
"format": "int32",
"example": 1
}
},
"description": "La configuration du mot de passe à usage unique basé sur le temps."
},
"Forbidden_1": {
"required": [
"messageDescription",
"messageId"
],
"type": "object",
"properties": {
"messageId": {
"type": "string",
"description": "L'identifiant de la clé de message",
"readOnly": true,
"example": "CSIXX1234X"
},
"messageDescription": {
"type": "string",
"description": "Un message descriptif spécifique au local du demandeur",
"readOnly": true,
"example": "The access token included in the request is not valid"
}
},
"description": "Le message de réponse à la demande."
},
"Unauthorized_0": {
"required": [
"messageDescription",
"messageId"
],
"type": "object",
"properties": {
"messageId": {
"type": "string",
"description": "L'identifiant de la clé de message",
"readOnly": true,
"example": "CSIXX1234X"
},
"messageDescription": {
"type": "string",
"description": "Un message descriptif spécifique au local du demandeur",
"readOnly": true,
"example": "The unauthenticated user does not have the permissions to perform the requested operation"
}
},
"description": "Le message de réponse à la demande."
}
}
},
"x-original-swagger-version": "2.0",
"x-explorer-enabled": false
}
```