pismile

Scopes et claims

Les informations que votre application reçoit, scope par scope, et comment les utiliser.

3 min de lecture · Mis à jour le · API v1

Connectez-vous pour voir vos propres identifiants sandbox dans les exemples.

Votre application demande des scopes ; pismile renvoie les claims correspondantes dans le jeton d'identité (_ID token_) et sur l'endpoint userinfo (https://pismile.com/userinfo), après accord de l'utilisateur.

Scopes#

Scope

Obligatoire

Ce qu'il donne

openid

Oui

sub (identifiant de l'utilisateur pour votre application), auth_time

profile

Recommandé

name, pismile_country, pismile_category

address

Non

address.country, si ce scope est activé pour votre application dans la console

Claims#

Claim

Exemple

Description

sub

c2b18f…

Identifiant stable de l'utilisateur, propre à votre application

name

AWA MENSAH

Nom du titulaire du compte, tel que le connaît son établissement

pismile_country

TG

Pays du compte (code ISO 3166-1 à deux lettres)

pismile_category

P

Catégorie du titulaire dans PI-SPI (voir ci-dessous)

auth_time

1760781600

Date de la dernière vérification de l'alias (secondes depuis le 1er janvier 1970)

address.country

TG

Pays, au format de la claim standard address

Catégories de titulaires#

La plateforme PI-SPI de la BCEAO classe les clients des établissements participants en quatre catégories. pismile_category reprend la catégorie du titulaire de l'alias.

Valeur

Catégorie

Qui

P

Particulier

Une personne physique

C

Commerçant

Une personne physique qui exerce une activité commerciale

B

Entreprise

Une personne morale : société, association…

G

Administration

Une structure de l'administration publique

Exemple de jeton d'identité#

id_token (payload)
{
  "iss": "https://pismile.com",
  "aud": "VOTRE_CLIENT_ID",
  "sub": "c2b18f6e4a0d4c7e9b2f1a3d5e7c9b10",
  "auth_time": 1760781600,
  "name": "AWA MENSAH",
  "pismile_country": "TG",
  "pismile_category": "P"
}

Identifier vos utilisateurs avec sub#

sub est la seule claim à utiliser comme clé de vos comptes utilisateurs.

  • Il est stable : le même utilisateur obtient toujours le même sub dans votre application.

  • Il est propre à votre application : un autre site qui utilise pismile reçoit un sub différent pour la même personne. Les applications ne peuvent donc pas croiser leurs utilisateurs.

  • Il suit le titulaire, pas l'alias : si un alias change de titulaire (par exemple un numéro de téléphone réattribué), le nouveau titulaire obtient un nouveau sub. Il n'accède jamais au compte de l'ancien.

Pas d'e-mail ni de téléphone#

pismile ne transmet ni adresse e-mail ni numéro de téléphone. Si votre service en a besoin, demandez-les à l'utilisateur après sa connexion.

Cette page vous a-t-elle aidé ?