Passer au contenu principal

Créer vos populations automatiquement depuis votre annuaire

Comment configurer votre annuaire pour que Kamaé crée et tienne à jour vos populations, et comment elles évoluent ensuite.

Écrit par Kamaé-san

Fonctionnalité en bêta. La création de populations depuis votre annuaire est en cours de déploiement et peut encore évoluer. Elle est ouverte aux organisations qui en font la demande.

Ce qu'il faut savoir

Si votre annuaire est synchronisé avec Kamaé par SCIM, il peut créer et tenir à jour vos populations à votre place : par ville, par département, par entité, par métier…

  • Vous choisissez dans votre annuaire les informations à envoyer, sous la forme Clé=Valeur (par exemple Ville=Paris).

  • Kamaé crée une population par valeur reçue et y place automatiquement les collaborateurs concernés.

  • Quand un collaborateur change de ville ou de département dans l'annuaire, il change de population dans Kamaé. Une population qui n'a plus aucun membre disparaît d'elle-même.

Prérequis

  • Le SCIM est déjà en place entre votre fournisseur d'identité et Kamaé. Sinon, contactez nos équipes pour sa configuration.

  • La fonctionnalité est activée sur demande : contactez le support depuis la plateforme pour l'ouvrir sur votre organisation.

  • Votre fournisseur d'identité est Microsoft Entra ID : c'est aujourd'hui le seul fournisseur pris en charge.

Le principe

Kamaé écoute un seul attribut SCIM de l'utilisateur : division (extension entreprise). Votre annuaire y envoie une chaîne qui regroupe une ou plusieurs paires Clé=Valeur, séparées par une barre verticale | :

Ville=Paris|Département=Marketing
  • La clé est le critère de regroupement, c'est vous qui la nommez : Ville, Département, Entité, Métier…

  • La valeur devient le nom de la population. Ici, le collaborateur rejoint la population Paris (clé Ville) et la population Marketing (clé Département).

Exemple avec quatre collaborateurs :

Collaborateur

Valeur envoyée dans division

Populations dans Kamaé

Alice

Ville=Paris|Département=Marketing

Paris, Marketing

Bruno

Ville=Lyon|Département=Marketing

Lyon, Marketing

Chloé

Ville=Lyon|Département=Support

Lyon, Support

David

Ville=Paris

Paris

Résultat : 4 populations créées automatiquement, Paris et Lyon (clé Ville), Marketing et Support (clé Département). Les populations restent indépendantes des équipes : l'équipe d'un collaborateur continue de venir du champ department, comme avant.

Configurer Microsoft Entra ID

Dans le portail Azure, ouvrez l'application Kamaé de votre tenant, puis :

  1. Approvisionnement > Mappages > Provision Microsoft Entra ID Users.

  2. En bas de la liste, cliquez sur « Ajouter un nouveau mappage ».

  3. Type de mappage : Expression.

  4. Expression : collez l'expression ci-dessous, adaptée à vos attributs.

  5. Attribut cible : urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division.

  6. Appliquer ce mappage : Toujours. Cliquez sur OK, puis Enregistrer.

L'expression à utiliser

Exemple pour regrouper par ville et par département :

Join("|", Join("=", "Ville", [city]), Join("=", "Département", [department]))
  • Chaque bloc Join("=", "Clé", [attribut]) produit une paire, par exemple Ville=Paris.

  • Le Join("|", …) extérieur les met bout à bout.

  • Pour ajouter un critère, ajoutez un bloc. Vous pouvez utiliser n'importe quel attribut de vos utilisateurs : [companyName], [officeLocation], [jobTitle], [country], un attribut d'extension…

Si un attribut est vide pour un collaborateur, Entra envoie la clé seule (par exemple Ville) : Kamaé l'ignore, sans erreur. Le collaborateur ne rejoint simplement aucune population pour cette clé.

Si vos valeurs peuvent contenir une barre verticale « | »

La barre | sert de séparateur. Une valeur comme Recherche | Développement serait coupée en deux et produirait des populations en trop. Si vos attributs peuvent en contenir, remplacez-la par une barre oblique en entourant chaque attribut d'un Replace :

Join("|", Join("=", "Ville", Replace([city], "|", , , "/", , )), Join("=", "Département", Replace([department], "|", , , "/", , )))

La valeur devient Recherche / Développement et donne une seule population. Dans le doute, utilisez directement cette version : elle ne change rien aux valeurs sans barre verticale.

Testez avant d'enregistrer. Le générateur d'expressions d'Entra (menu Approvisionnement) affiche le résultat pour un utilisateur réel, sans rien modifier. Vous devez obtenir une chaîne de la forme Ville=Paris|Département=Marketing. Le signe = est accepté à l'intérieur d'une valeur.

Envoyer les valeurs à Kamaé

Entra applique le nouveau mappage aux collaborateurs au fil de ses cycles de synchronisation (environ toutes les 40 minutes), mais seulement à ceux qui ont changé. Pour envoyer tout le monde d'un coup, cliquez sur « Redémarrer l'approvisionnement » dans la page Approvisionnement après l'enregistrement.

Pour vérifier sur un seul collaborateur, utilisez « Approvisionner à la demande » : sa population apparaît dans Kamaé quelques secondes plus tard.

Retrouver vos populations dans Kamaé

Rendez-vous dans Administration > Populations.

  • Dans l'onglet « Populations », la colonne Création distingue les populations Auto (générées par l'annuaire) et Manuelle, et la colonne Clé indique d'où vient chaque population générée. Deux populations « Paris » peuvent ainsi coexister : l'une issue de la clé Ville, l'autre d'une clé Département, ou une population manuelle du même nom.

  • Les filtres Création (Manuelle, Auto) et Clé réduisent la liste, par exemple aux seules populations de la clé Ville. La liste est paginée et se trie par nom ou par nombre de membres. Sur téléphone, les colonnes Création et Clé laissent place à la clé, affichée sous le nom.

  • Sur la page d'une population générée, l'étiquette Auto · Ville rappelle sa clé.

  • L'onglet « Synchronisation annuaire » résume ce que votre annuaire envoie : pour chaque clé, le nombre de populations générées, de collaborateurs couverts et la date de dernière synchronisation. Il est en lecture seule.

  • Partout où vous choisissez ou consultez une population (filtre du tableau de bord, cible d'une campagne de phishing, colonne et filtre Populations de la liste Administration > Collaborateurs, fiche d'un collaborateur), une population générée s'affiche avec sa clé, par exemple Paris (Ville).

  • Dans les exports .csv du tableau de bord, la colonne Populations liste une population générée sous la forme Ville=Paris, et les populations d'un même collaborateur sont séparées par |.

Comment les populations évoluent

L'annuaire est la seule source de vérité : chaque fois qu'il envoie un collaborateur, Kamaé aligne ses populations générées sur la valeur reçue.

Dans votre annuaire

Dans Kamaé

Un collaborateur porte une valeur jamais vue (Ville=Nantes)

La population Nantes est créée et il y entre.

Un collaborateur change de valeur (Paris devient Lyon)

Il quitte Paris et rejoint Lyon.

L'attribut d'un collaborateur est vidé

Il quitte la population correspondante.

Plus aucun collaborateur ne porte une valeur

La population, désormais vide, est supprimée automatiquement.

La valeur réapparaît plus tard

Une nouvelle population est créée.

Un collaborateur est désactivé ou retiré de l'application Kamaé

Il reste dans ses populations générées tant qu'il n'est pas supprimé définitivement de Kamaé. À sa suppression, il en sort, et une population restée vide est supprimée.

Une clé n'est plus envoyée par l'expression

Au fil des synchronisations, chacun quitte ces populations, qui disparaissent une fois vides. La clé disparaît avec sa dernière population.

Ce que vous pouvez faire, et ce qui reste à l'annuaire

Une population générée est pilotée par votre annuaire. Dans Kamaé :

  • Vous ne pouvez pas la renommer, la supprimer, ni y ajouter, retirer ou importer des collaborateurs. Pour changer sa composition, modifiez l'attribut dans votre annuaire.

  • Vous pouvez modifier sa description, l'utiliser comme cible de campagne ou comme filtre du tableau de bord, et lui donner son propre programme de sensibilisation (voir Donner un programme de sensibilisation à une population).

  • Vos populations manuelles ne sont jamais touchées par la synchronisation, même si elles portent le même nom qu'une population générée. Pour les créer et les gérer, consultez Créer et gérer vos populations.

Points de vigilance

  • Une population supprimée perd son programme. Si une population générée se vide, elle est supprimée avec son programme de sensibilisation. Si la valeur revient, la nouvelle population repart d'un programme vide. Évitez de vider une valeur « le temps d'une réorganisation ».

  • Gardez des noms de clés stables. Renommer une clé dans l'expression (Ville devient Site) crée de nouvelles populations et vide les anciennes, avec leur programme.

  • Majuscules et accents ne distinguent pas deux valeurs. « Évry », « Evry » et « EVRY » donnent une seule population, nommée d'après la première orthographe reçue. Harmonisez l'annuaire si le libellé compte pour vous.

  • Une même clé peut porter plusieurs valeurs. Site=Paris|Site=Lyon place le collaborateur dans les deux populations.

  • Les collaborateurs désactivés restent comptés. Ils restent membres de leurs populations générées, et donc dans les « Collaborateurs couverts », jusqu'à leur suppression définitive.

  • Longueur maximale. Une clé ou une valeur de plus de 255 caractères est ignorée.

  • Le calendrier suit les populations. Entrer dans une population qui a son propre programme ajoute ses compétences au calendrier du collaborateur ; en sortir les retire. Les scores déjà obtenus sont conservés.

  • Tableau de bord. Comme pour les équipes, l'historique d'une population nouvellement créée se complète dans le tableau de bord le week-end suivant.

Avez-vous trouvé la réponse à votre question ?