DossierFacile Connect

En quoi consiste le DossierFacile Connect ? 
DossierFacile Connect est la solution single sign-on (SSO) de DossierFacile.
Il s'agit d'une fenêtre de login/signup de DossierFacile qui est intégrée à votre plateforme. L’utilisateur peut alors se connecter à DossierFacile depuis votre site et une liaison est ainsi faite entre votre plateforme et un compte existant sur DossierFacile. 
Ce faisant l'utilisateur consent à ce que le partenaire ait accès à un certain nombre d’informations relatives à son compte chez DossierFacile.
Prérequis techniques 
Avoir un espace login sur votre plateforme pour les utilisateurs
Connaissance de Postman
Pouvoir mettre en place un webhook (optionnel)
Télécharger la présentation
DossierFacile - Presentation_DossierFacile_Connect.pdf
1MB
PDF
Visionner la présentation technique par le développeur
📽
Webinaires d'intégration technique
Le principe du SSO
Testez le DossierFacile Connect avec Postman (environnement bac à sable)
DossierFacile Connect est un système vous permettant de récupérer les informations du dossier de location d’un de vos utilisateurs directement sur votre plateforme. Il permet également de mettre en place un webhook vous indiquant quand le statut d’un dossier change.
Ce tutoriel décrit les différentes étapes de l’utilisation via Postman.
L’objectif de l’opération est de pouvoir appeler le endpoint https://api-dev.dossierfacile.fr/dfc/tenant/profile qui contient les informations du dossier de location de l’utilisateur.
1 - Création d’une requête dans Postman
Créez un endpoint GET sur l’URL https://api-dev.dossierfacile.fr/dfc/tenant/profile
2 - Configuration de l’authentification dans Postman
Configurez l’authentification de Postman en Oauth 2.0 puis configurez un nouveau token avec les valeurs suivantes.

​
​
​
Token Name
oauth2 keycloack
Grant Type
Authorization Code
Callback URL
https://locataire-dev.dossierfacile.fr
Authorize using browser
non coché
Auth URL
https://sso-preprod.dossierfacile.fr/auth/realms/dossier-facile/protocol/openid-connect/auth
Access Token URL
https://sso-preprod.dossierfacile.fr/auth/realms/dossier-facile/protocol/openid-connect/token
Client ID
dfc-test-client
Client Secret
​
Scope 
openid
State 
​
Client Authentication
Send as Basic Auth header

Cliquez ensuite sur Get New Access Token, une fenêtre d’identification DossierFacile va s’ouvrir.

Renseignez les champs avec les identifiants d’un compte créé préalablement sur https://locataire-dev.dossierfacile.fr

Cliquez ensuite sur Use Token
​
3 -  Et enfin lancez la requête Postman
4 - Optionnel : utilisation du refresh token
Il existe dans la réponse à l’authentification un refresh token, qui permet de générer un nouveau token d’authentification afin d’accéder au endpoint /dfc/tenant/profile à nouveau sans demander à l’utilisateur de se reconnecter.

curl --location --request POST https://sso-preprod.dossierfacile.fr/auth/realms/dossier-facile/protocol/openid-connect/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=refresh_token' \
--data-urlencode 'client_id=dfc-locservice' \
--data-urlencode 'refresh_token={REFRESH TOKEN VALUE}'

5 - Optionnel 2 : Webhook
Il est possible de configurer un webhook afin qu’une fois qu’un utilisateur s’est loggé à DossierFacile depuis votre plateforme, vous receviez les changements de statuts de son dossier. Pour la mise en place de ce webhook, consultez la page suivante : lien tracké​
Prendre rendez-vous pour plus d'informations
📅
Échanger avec un membre de l'équipe