identity
Authenticate
Authentifie un utilisateur selon une règle configurable : mono-facteur (une méthode) ou multi-facteur (plusieurs méthodes combinées). Méthodes disponibles : login / mot de passe, OTP par SMS, et vérification silencieuse par le réseau mobile (silent auth opérateur). SIFIP orchestre les facteurs et renvoie une décision d'authentification avec le niveau d'assurance atteint.
Paramètres
| Name | Type | Required | Description |
|---|---|---|---|
| user_id | string | requis | Identifiant de l'utilisateur à authentifier |
| mode | enum | requis | single_factor | multi_factor |
| methods | string[] | requis | password | sms_otp | mobile_network |
| credentials.password | string | optionnel | Requis si la méthode password est utilisée |
| msisdn | E.164 | optionnel | Requis pour sms_otp et mobile_network |
| otp | string | optionnel | Code reçu par SMS (étape de vérification) |
| callback_url | URL | optionnel | Webhook de fin de session |
Réponse type
{
"session_id": "auth_9f2c1a7b",
"decision": "AUTHENTICATED",
"mode": "multi_factor",
"assurance_level": "aal2",
"user_id": "user-12345",
"factors": [
{
"method": "password",
"status": "passed"
},
{
"method": "sms_otp",
"status": "passed"
},
{
"method": "mobile_network",
"status": "passed",
"detail": "Ligne active, non SIM-swappée"
}
]
}