Retour au catalogue
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.

Simuler un appel API
Paramètres
NameTypeRequiredDescription
user_idstringrequisIdentifiant de l'utilisateur à authentifier
modeenumrequissingle_factor | multi_factor
methodsstring[]requispassword | sms_otp | mobile_network
credentials.passwordstringoptionnelRequis si la méthode password est utilisée
msisdnE.164optionnelRequis pour sms_otp et mobile_network
otpstringoptionnelCode reçu par SMS (étape de vérification)
callback_urlURLoptionnelWebhook 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"
    }
  ]
}