ArticleAutorisation et fédération

Qu'est-ce que CIBA (Client-Initiated Backchannel Authentication) ?

Un flux OpenID Connect sans redirection : l'application demande l'authentification d'un utilisateur, qui l'approuve sur un autre appareil, souvent son téléphone.

Nom complet
OpenID Connect Client-Initiated Backchannel Authentication Flow, Core 1.0
Publié par
OpenID Foundation, 2021
Dans TOSIAM
Endpoint /bc-authorize, mode poll
Sur cette page

CIBA en bref#

Dans les flux classiques d’OpenID Connect, l’utilisateur est devant l’application qui demande sa connexion : elle redirige son navigateur vers le fournisseur d’identité, il s’authentifie, puis revient.

CIBA (Client-Initiated Backchannel Authentication) couvre le cas où ce n’est pas possible : l’application qui a besoin de l’authentification n’est pas entre les mains de l’utilisateur, ou n’a pas de navigateur. Elle contacte directement le fournisseur, de serveur à serveur, en lui indiquant quel utilisateur doit être authentifié. Le fournisseur joint l’utilisateur sur un autre appareil, typiquement par une notification sur son téléphone, et l’utilisateur approuve ou refuse. L’application récupère ensuite les jetons.

Pas de redirection, pas de navigateur partagé : l’échange entre l’application et le fournisseur passe entièrement par le canal arrière (backchannel).

Des cas d’usage concrets#

  • Un centre d’appels. Le conseiller doit vérifier l’identité de la cliente au téléphone. Plutôt que de lui poser des questions secrètes, son application déclenche une demande ; la cliente reçoit une notification et l’approuve sur son téléphone.
  • Un terminal de paiement ou une borne. L’utilisateur saisit un identifiant sur la borne et confirme sur son propre appareil, sans taper de mot de passe sur un équipement public.
  • La validation d’une opération sensible. Un virement initié depuis un poste de travail est confirmé sur le téléphone du titulaire.

CIBA distingue deux appareils : l’appareil de consommation (Consumption Device), où le service est utilisé, et l’appareil d’authentification (Authentication Device), où l’utilisateur prouve son identité et donne son accord.

Comment ça marche#

  1. Application vers TOSIAM Demande d’authentification sur /bc-authorize, avec login_hint
  2. TOSIAM vers Application Renvoie auth_req_id, expires_in et interval
  3. TOSIAM vers Utilisateur Notifie l’utilisateur sur son téléphone
  4. Application vers TOSIAM Interroge l’endpoint de jeton avec auth_req_id
  5. TOSIAM vers Application Répond authorization_pending
  6. Utilisateur vers TOSIAM Vérifie le message et approuve
  7. Application vers TOSIAM Interroge de nouveau
  8. TOSIAM vers Application Renvoie l’ID token et l’access token
CIBA en mode poll : l’application interroge l’endpoint de jeton jusqu’à la décision de l’utilisateur.

La demande initiale identifie l’utilisateur par un indice : la norme en prévoit trois, dont exactement un doit être fourni.

Faites défiler le tableau
ParamètreContenu
login_hintUn identifiant connu du fournisseur : nom d’utilisateur, adresse e-mail, numéro de téléphone.
login_hint_tokenUn jeton qui désigne l’utilisateur, émis par un tiers de confiance.
id_token_hintUn ID token déjà émis pour cet utilisateur.

D’autres paramètres complètent la demande : scope, qui doit contenir openid ; acr_values, le niveau d’authentification souhaité ; binding_message, un court texte affiché à la fois sur l’appareil de consommation et sur le téléphone, pour que l’utilisateur sache qu’il approuve bien la bonne opération ; requested_expiry, la durée de validité souhaitée.

Le fournisseur répond immédiatement, sans attendre l’utilisateur :

json· Réponse de l'endpoint d'authentification
{
  "auth_req_id": "1c266114-a1be-4252-8ad1-04986c5b9ac1",
  "expires_in": 300,
  "interval": 5
}

L’application obtient ensuite les jetons à l’endpoint de jeton, avec le grant urn:openid:params:grant-type:ciba et l’auth_req_id.

Trois modes de livraison#

Le client choisit, lors de son enregistrement, comment il apprendra la décision de l’utilisateur.

Faites défiler le tableau
ModeFonctionnement
PollLe client interroge l’endpoint de jeton à intervalles réguliers. Tant que l’utilisateur n’a pas répondu, il reçoit authorization_pending ; s’il interroge trop vite, slow_down.
PingLe fournisseur appelle une URL du client quand la décision est prise ; le client va alors chercher les jetons à l’endpoint de jeton.
PushLe fournisseur envoie directement les jetons à l’URL du client.

Les modes ping et push reposent sur le paramètre client_notification_token, que le fournisseur présente au client pour s’authentifier lors de l’appel. Le mode push est le plus délicat à sécuriser, et le profil FAPI-CIBA l’exclut.

Bonnes pratiques#

  • Affichez toujours un binding_message explicite, par exemple « Virement de 250 € vers M. Martin », et le même texte des deux côtés. Sans lui, un utilisateur peut approuver une demande qui ne vient pas de lui.
  • Ne déclenchez une demande qu’après une action volontaire de l’utilisateur. Des notifications répétées finissent par être approuvées par lassitude.
  • Respectez l’interval renvoyé par le fournisseur et arrêtez d’interroger à l’expiration de la demande.
  • Signez les demandes d’authentification (paramètre request) : le fournisseur a ainsi la preuve que la demande vient bien du client et n’a pas été modifiée.
  • Réservez CIBA aux clients confidentiels, capables de s’authentifier auprès du fournisseur.

CIBA dans TOSIAM#

TOSIAM implémente CIBA en mode poll. L’endpoint d’authentification est l’adresse de l’émetteur suivie de /bc-authorize, par exemple https://login.example.fr/tosiam/oauth2/clients/bc-authorize. Il n’accepte que des requêtes POST au format formulaire.

Une demande signée obligatoire. TOSIAM authentifie le client ; pour un client private_key_jwt, l’assertion peut désigner comme audience (aud) l’émetteur, l’endpoint de jeton ou l’endpoint /bc-authorize (avant la version 3.38.0, aucune de ces trois valeurs n’était acceptée). TOSIAM exige ensuite que la demande soit transmise dans un request object signé, le paramètre request. La signature est vérifiée avec les clés publiques déclarées pour le client, par un algorithme asymétrique de la liste annoncée par la découverte (celui que le client a enregistré pour ses assertions, s’il en a un). TOSIAM contrôle aussi que l’émetteur (iss) du JWT est le client lui-même, que son audience (aud) est l’émetteur de TOSIAM (issuer), que iat, nbf, exp et jti sont présents (avec 60 secondes de tolérance sur l’horloge du client, et 24 heures de durée de vie au plus), que le scope contient openid et reste dans les scopes du client (sinon invalid_scope), et qu’exactement un des trois indices est présent. Un request object ne sert qu’une fois : TOSIAM réserve son jti dans le Core Token Store. Seul login_hint est pris en charge : il doit désigner un utilisateur actif du royaume, sinon la demande est refusée (invalid_request). Le client doit être confidentiel et avoir le grant CIBA dès cette étape, sinon unauthorized_client. Ces contrôles datent de la version 3.38.0 : un client écrit pour une version antérieure doit ajouter iat, nbf et jti à son request object et désigner l’émetteur comme audience.

L’authentification de l’utilisateur. La valeur acr_values de la demande est recherchée dans la table « Correspondance acr_values OpenID Connect vers chaînes d’authentification » du fournisseur OAuth2, qui la relie à un service d’authentification. Sans acr_values, ou si aucune des valeurs demandées n’est dans cette table, TOSIAM exécute l’authentification par défaut du royaume. TOSIAM exécute le service côté serveur, en arrière-plan, et lui transmet le login_hint comme identifiant. Le service exécuté doit donc pouvoir joindre l’utilisateur sans navigateur, par exemple par une notification push à laquelle il répond sur son téléphone : une chaîne qui demande un mot de passe ne peut pas aboutir, et la demande est refusée. Selon l’issue, la demande passe à l’état approuvé ou refusé ; à partir de la version 3.38.0, elle n’est approuvée que si l’utilisateur authentifié est celui du login_hint. TOSIAM attend la réponse de l’utilisateur 90 secondes au plus, ou jusqu’à l’expiration de la demande si elle survient avant ; passé ce délai, la demande reste en attente et le client reçoit expired_token à son expiration.

Avant la version 3.38.0, une demande sans acr_values ne déclenchait aucune authentification et restait en attente jusqu’à son expiration, et une valeur absente de la table provoquait une erreur 500 : indiquez alors toujours une valeur présente dans la table.

La récupération des jetons. Le client interroge l’endpoint de jeton avec le grant urn:openid:params:grant-type:ciba. Ce grant doit figurer dans la liste des grants autorisés du client, et le client doit être confidentiel. TOSIAM répond authorization_pending tant que l’utilisateur n’a pas répondu, slow_down si le client interroge plus vite que l’intervalle annoncé, expired_token après expiration et access_denied en cas de refus (à partir de la 3.38.0 ; avant, authorization_declined). Un auth_req_id ne sert qu’une fois : il est consommé dès la délivrance des jetons, qui comprennent un refresh token si le fournisseur en émet.

Les réglages. Deux réglages du fournisseur OAuth2 encadrent les demandes : la durée de vie d’une demande, 300 secondes par défaut, et l’intervalle minimal entre deux interrogations, 5 secondes par défaut. Les demandes en attente sont conservées dans le Core Token Store.

La découverte. À partir de la version 3.38.0, le document de découverte (/.well-known/openid-configuration) annonce backchannel_authentication_endpoint, backchannel_token_delivery_modes_supported (poll), backchannel_authentication_request_signing_alg_values_supported (RS256, RS384, RS512, ES256, ES384, ES512) et backchannel_user_code_parameter_supported (false). Avec une version antérieure, configurez l’adresse de l’endpoint explicitement dans l’application cliente.

Pour aller plus loin#

Mis à jour le