> For the complete documentation index, see [llms.txt](https://ksaar.gitbook.io/ksaar-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ksaar.gitbook.io/ksaar-documentation/utilisateurs/authentification-unique-sso/personnalisation-du-mapping-des-champs.md).
# Personnalisation du mapping des champs
Par défaut, Ksaar récupère uniquement les informations de base de l’utilisateur : nom, prénom et email.
La personnalisation du mapping permet de récupérer et d’intégrer des données supplémentaires depuis le token SSO (ex. : matricule, adresse, âge, ...) afin de répondre aux besoins spécifiques de votre organisation.
{% hint style="info" %}
Cette fonctionnalité est disponible uniquement pour le protocole SSO OpenID Connect (OIDC).
{% endhint %}
## 📋 Pré-requis
### 📌 **Configuration du SSO**
Avant toute personnalisation, votre SSO doit être configuré et fonctionnel. Cette configuration initiale garantit que les flux d’authentification et de données sont correctement établis avant de procéder à des personnalisations plus complexes.
### 📌 **Mise en place d’une table de synchronisation**
Dans certains cas, les données du token SSO nécessitent un traitement avancé (formules, REGEX, etc.).
Les données transférées dans les tokens SSO nécessite parfois du traitement avancé pour pouvoir être exploitée (utilisation de formule, REGEX, ...). Il est donc nécessaire de synchroniser la table **Utilisateurs** avec une table dans la **vue Data**, afin de garantir le traitement correct des informations reçues depuis le SSO.\
Pour cela :
1️⃣ Créez une table **Contact** dans la **vue Data**.
2️⃣ Ajoutez au moins **une liaison vers la table Utilisateur** pour synchroniser les données.
3️⃣ Ajoutez dans la table **Contact** les champs correspondant aux informations à récupérer depuis le token SSO (matricule, adresse, âge, ...).
4️⃣ Créez également **une liaison simple depuis la table Utilisateur vers la table Contact** afin d’assurer une synchronisation bidirectionnelle entre les données du token SSO et les comptes utilisateurs Ksaar.
## 🔄 Récupération du schéma du token SSO / Synchronisation avec la table
1️⃣ Depuis l’onglet **Authentification** des paramètres du persona, cliquez sur **Récupérer des informations à la connexion SSO** dans les paramètres avancés pour ouvrir l’interface de paramétrage du mapping.
2️⃣ Vous avez la possibilité de définir le schéma du token SSO de deux manières :
* **Définir le schéma manuellement** : saisissez directement le schéma des champs transmis par votre SSO si vous le connaissez.
* **À partir de la prochaine connexion** : Ksaar récupère automatiquement le schéma lors de la prochaine connexion d’un utilisateur, ce qui facilite la configuration sans saisie manuelle. Nous conseillons fortement d'utiliser cette fonctionnalité car elle réduit le risque d'erreur.
{% hint style="info" %}
Si la table de synchronisation n’est pas correctement configurée, un message s’affiche pour indiquer qu’il faut la préparer avant de continuer.
{% endhint %}
3️⃣ Si vous choisissez “À partir de la prochaine connexion”, connectez-vous en tant qu’utilisateur final via le lien du persona. Une fois connecté, retournez dans l’interface de développement et cliquez sur **Tester la connexion SSO** pour récupérer les champs transmis par le SSO.
4️⃣ Une fois la connexion testée, le schéma du token SSO est récupéré : il contient les champs transmis par le SSO. Vous pouvez ensuite modifier ce schéma manuellement si nécessaire, puis cliquer sur **Utiliser ce schéma** pour le valider.
5️⃣ Sélectionnez la **table de synchronisation** à utiliser. Activez **Montrer seulement les tables éligibles** pour filtrer celles qui respectent les prérequis de liaisons bidirectionnelles entre la table **Utilisateur** et la table de la **vue Data**.
6️⃣ Définissez les liaisons à utiliser entre chaque table afin d’assurer la synchronisation des données.
7️⃣ (*facultatif*) Sélectionnez le champ contenant l’adresse e-mail de votre contact afin de vérifier l’unicité de celui-ci. Ainsi, si un nouvel utilisateur se connecte et qu’un contact correspondant existe déjà, aucun nouveau contact ne sera créé.
8️⃣ **Mappez les champs** : associez les champs de la table de synchronisation avec les données définies dans le schéma du token SSO.
9️⃣ Cliquez sur **Valider les paramètres**, puis sur **Modifier le persona** pour enregistrer la configuration complète.
## 👤 Mise à jour des données utilisateurs
Lors de chaque connexion d’un utilisateur via SSO, Ksaar effectue les vérifications suivantes dans la table de synchronisation :
* **Création d’un enregistrement** : Si aucun enregistrement associé à l’utilisateur n’existe dans la table de synchronisation, Ksaar en crée un automatiquement.
* **Mise à jour des champs** : Ksaar met à jour les champs mappés dans l’enregistrement de la table de synchronisation avec les valeurs renvoyées par le token SSO. Cette mise à jour assure que les données de l’utilisateur sont toujours actuelles et reflètent les dernières informations fournies par le SSO.
{% hint style="info" %}
Bien que la table de synchronisation soit mise à jour automatiquement à chaque connexion SSO, les enregistrements de la table Utilisateurs ne sont pas modifiés automatiquement et nécessitent une action supplémentaire pour se synchroniser.
{% endhint %}
Pour mettre à jour automatiquement les valeurs des enregistrements de la table Utilisateurs avec celles de la table de synchronisation :
**1️⃣** Créer une automation avec pour déclencheur "**Quand un enregistrement est modifié"**.
2️⃣ Sélectionnez la table de synchronisation et choisissez tous les champs susceptibles d’être modifiés par le token SSO.
**3️⃣** Ajoutez une action "**Mettre à jour les champs"** et utilisez la liaison existante entre la table de synchronisation et la table Utilisateurs pour mettre à jour les champs correspondants dans la table Utilisateurs.
{% hint style="info" %}
Lorsque les données du token SSO nécessitent un traitement spécifique, il est recommandé d’utiliser des formules de traitement (formatage, validation, transformations) avant de les synchroniser avec la table Utilisateurs.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://ksaar.gitbook.io/ksaar-documentation/utilisateurs/authentification-unique-sso/personnalisation-du-mapping-des-champs.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.