Provisionner les comptes dans vos applications
Gardez les comptes d'une application enregistrée par votre organisation alignés sur les personnes qui y sont affectées, en SCIM 2.0 ou via Microsoft Entra, avec chaque tentative et chaque écart consignés.
Une application qui connecte les utilisateurs via Scrydon tient souvent son propre compte pour chacun d'eux. Le provisionnement garde ces comptes à jour pour vous. Quand une personne est affectée à l'application, Scrydon y crée son compte. Quand ses informations ou ses équipes changent, il met le compte à jour. Quand elle quitte l'organisation, est suspendue ou n'est plus affectée, il désactive le compte. Les changements atteignent l'application en quelques minutes.
Le provisionnement se règle sur l'application, sous Paramètres → Organisation → Applications → votre application → Provisionnement. Il fonctionne de la même manière pour une application OIDC et une application SAML. Seul un propriétaire ou un administrateur de l'organisation peut le voir ou le modifier. Chaque modification est consignée dans le journal d'audit.
Qui est provisionné
Les personnes provisionnées sont celles autorisées à utiliser l'application : tous les membres quand l'application admet tous les membres, ou les équipes et les personnes que vous avez nommées quand elle est restreinte. Restreindre l'accès à l'application désactive les comptes des personnes qu'elle n'admet plus.
Deux façons d'atteindre l'application
Chaque application a une cible de provisionnement, atteinte de l'une de deux façons.
| Façon | À utiliser quand | Ce que vous saisissez |
|---|---|---|
| SCIM 2.0 | L'application a un point de terminaison SCIM 2.0. | L'URL de base du point de terminaison, et le secret d'organisation qui contient son jeton bearer. |
| Microsoft Entra | Les comptes de l'application sont tenus par une application d'entreprise Entra. | La connexion Microsoft de l'organisation, l'identifiant du principal de service de l'application d'entreprise, et l'identifiant de son travail de provisionnement. |
L'URL de base doit utiliser https, sans nom d'utilisateur, mot de passe, requête ni fragment, et son hôte doit figurer sur la liste d'autorisation de sortie de votre organisation. Scrydon refuse toute autre adresse.
Vous ne saisissez jamais de jeton dans le formulaire. Vous choisissez un secret d'organisation, ou une connexion d'extension, qui le contient déjà. Scrydon enregistre lequel vous avez choisi, jamais sa valeur. Pour changer le jeton, mettez à jour le secret : la cible utilise la nouvelle valeur dès son appel suivant. Créez le secret d'organisation avant de configurer la cible.
Ce que reçoit une application SCIM 2.0
Chaque personne est un User SCIM :
| Attribut | Valeur |
|---|---|
userName | Le nom de connexion de la personne dans votre organisation (son e-mail si elle n'en a pas). |
externalId | Un identifiant fixe de la personne, qui ne change jamais. Rapprochez les comptes sur lui. |
displayName, name.givenName, name.familyName | Le nom de la personne. |
emails | Un e-mail professionnel principal. |
active | false dès que la personne est désactivée. |
Une nouvelle personne est créée par POST /Users. Chaque modification
ultérieure est un PATCH. Désactiver un compte met active à false :
Scrydon ne supprime jamais un compte, ses données restent donc dans
l'application. Chaque équipe dont la personne fait partie devient un Group
SCIM dont l'externalId est l'identifiant de l'équipe, et la personne y est
ajoutée ou en est retirée au fil de ses équipes. Les groupes créés par
l'application elle-même ne sont jamais modifiés.
Quand l'application a déjà un compte avec le même userName et le même
externalId, Scrydon reprend ce compte au lieu d'en créer un second. Un
compte avec le même userName et un autre externalId est laissé tel quel,
et la tentative échoue.
Configurer une cible
- Ouvrez l'application et choisissez Provisionnement.
- Choisissez Configurer le provisionnement.
- Choisissez SCIM 2.0 ou Microsoft Entra, puis remplissez les champs ci-dessus.
- Choisissez Enregistrer la cible. Une nouvelle cible est désactivée.
- Choisissez Activer quand vous êtes prêt. Scrydon envoie alors chaque personne affectée, et les garde à jour ensuite.
La façon dont une cible atteint l'application est fixée une fois enregistrée. Pour passer de SCIM à Entra, désactivez la cible, supprimez-la et configurez-en une nouvelle.
Désactiver, resynchroniser et supprimer
- Désactiver arrête l'envoi des changements à l'application. Une confirmation vous est demandée. Les comptes déjà présents dans l'application restent tels quels.
- Resynchroniser renvoie chaque personne affectée. Utilisez-le après avoir corrigé un problème du côté de l'application. L'application est mise à jour en quelques minutes.
- Supprimer la cible retire la configuration. Désactivez d'abord la cible. Une confirmation vous est demandée. Les preuves restent dans le journal d'audit.
Tant que l'application a encore des comptes que Scrydon a provisionnés et pas encore désactivés, vous ne pouvez supprimer ni la cible ni l'application elle-même. Supprimer l'une ou l'autre effacerait la trace que Scrydon garde de ces comptes, et ils resteraient actifs dans l'application sans plus rien pour les désactiver. Pour supprimer :
- Provisionnement activé, retirez l'accès de ces personnes à l'application (désaffectez-les).
- Attendez que Tentatives affiche une désactivation pour chacune d'elles, en général en moins d'une minute.
- Désactivez le provisionnement, puis supprimez la cible ou l'application.
Si l'application a disparu pour de bon et n'est plus joignable, contactez le support.
Quand le secret ou la connexion qu'utilise une cible est supprimé, la cible affiche Pas prêt et ne peut pas être activée. Modifiez-la et choisissez-en un autre.
Ce qui s'est passé, et ce qui diffère
L'onglet Provisionnement montre le statut de la cible, sa dernière tentative et le nombre de ses écarts ouverts.
-
Tentatives liste chaque appel que Scrydon a fait à l'application : quand, pour qui, ce qu'il a fait (création, mise à jour, désactivation ou suppression), et s'il a réussi, échoué ou est en attente. Un appel échoué est relancé de lui-même. Quand l'application demande à Scrydon de ralentir (un
Retry-Aftersur un 429 ou un 503), Scrydon attend le temps demandé, 5 minutes au plus, avant de réessayer. Une tentative marquée Aucun appel a échoué avant que Scrydon ne joigne l'application. Cible entière à la place d'une personne signifie qu'elle concernait toutes les personnes de cette cible. -
Écarts liste ce que Scrydon a trouvé en comparant les comptes de l'application avec les personnes qui devraient s'y trouver :
Constat Signification Absent de l’application Une personne affectée n'a pas de compte dans l'application. Inattendu dans l’application L'application a un compte pour une personne qui ne devrait plus en avoir. Attributs différents Le nom, l'e-mail ou les équipes d'un compte diffèrent de ceux de Scrydon. État actif différent Un compte est actif alors qu'il devrait être désactivé, ou l'inverse. Scrydon corrige lui-même chaque constat. Activez Afficher les résolus pour voir aussi les constats passés.
Les deux listes sont paginées. Pour garder une trace hors de Scrydon, utilisez Exporter en CSV : choisissez une période de 92 jours au plus, et Scrydon télécharge jusqu'à 50 000 tentatives de cette période. Chaque export est consigné dans le journal d'audit.
Dépannage
| Message | Que faire |
|---|---|
| Cette URL est refusée | Utilisez https, sans nom d'utilisateur, mot de passe, requête ni fragment, avec un hôte de la liste d'autorisation de sortie de votre organisation. |
| Ce secret (ou cette connexion) n'est pas de cette organisation | Il a été supprimé, ou appartient à une autre organisation. Choisissez-en un autre. |
| Cette application a déjà une cible de provisionnement | Modifiez plutôt la cible existante. |
| Désactivez le provisionnement avant de supprimer la cible | Désactivez-la, puis supprimez-la. |
| Des comptes sont encore provisionnés en aval (ou : Cette application a encore des comptes provisionnés en aval) | Retirez l'accès de ces personnes, attendez chaque désactivation dans Tentatives, puis supprimez. Voir Désactiver, resynchroniser et supprimer. |
| Cette période contient trop de tentatives pour un seul fichier | Exportez une période plus courte. |
Une tentative a échoué avec scim_unauthorized ou scim_forbidden | L'application a refusé le jeton. Mettez dans le secret un jeton que l'application accepte. |
Une tentative a échoué avec scim_endpoint_refused | L'URL de base n'est plus autorisée, souvent parce que son hôte a quitté la liste d'autorisation de sortie. |
Une tentative a échoué avec scim_uniqueness | L'application a un autre compte avec ce userName. Supprimez le doublon dans l'application, ou donnez-lui l'externalId de la personne. |
Une tentative a échoué avec scim_rate_limited, scim_target_unavailable ou scim_timeout | L'application est occupée ou indisponible. Scrydon réessaie de lui-même. |
Microsoft Entra
Une cible Entra inscrit vos utilisateurs dans votre tenant Microsoft Entra via le provisionnement entrant piloté par API d'Entra. Scrydon l'appelle par la connexion de l'extension Microsoft de votre organisation : il ne détient donc aucun jeton Microsoft qui lui soit propre.
Avant de la configurer, dans votre tenant Entra :
- Créez l'application de provisionnement et son travail de provisionnement piloté par API (Applications d'entreprise → API-driven provisioning to Microsoft Entra ID). Notez l'identifiant d'objet du principal de service de l'application et l'identifiant du travail.
- Accordez à l'inscription d'application derrière votre connexion Microsoft
exactement deux autorisations d'application Graph, avec le consentement
administrateur :
SynchronizationData-User.UploadetProvisioningLog.Read.All. - Dans les mappages d'attributs du travail, mappez
externalIdvers l'attribut de correspondance du travail (par défautemployeeId),userNameversuserPrincipalNameetactiveversaccountEnabled. - Démarrez le travail.
Essayez d'abord dans un tenant de test avec quelques personnes.
Ce que reçoit Entra. Pour chaque personne, une requête SCIM groupée avec
userName (son nom de connexion, qui devient son nom d'utilisateur principal),
externalId (son identifiant fixe), son nom, une adresse e-mail
professionnelle principale et active. La désactivation envoie
active: false : Scrydon ne supprime jamais l'utilisateur Entra. Les équipes
ne sont pas envoyées à Entra.
L'état en attente est normal. Entra accepte un envoi et l'applique plus tard, lors de son prochain cycle de provisionnement. D'ici là, la tentative est en attente. Scrydon lit le journal de provisionnement du travail et passe la tentative à réussie ou échouée quand Entra l'a appliquée. Une tentative échouée est renvoyée.
Limites. Entra accepte 40 envois toutes les 5 secondes et 2 000 toutes les 24 heures par tenant. Scrydon envoie une personne par envoi et attend quand une limite est atteinte : une première synchronisation de plus de 2 000 personnes prend donc plus d'une journée. Toutes les cibles qui utilisent la même connexion Microsoft partagent ces limites : utilisez une seule connexion par tenant.
Pour qu'Entra cesse aussitôt d'appliquer les envois, arrêtez le travail de provisionnement dans le centre d'administration Entra, puis désactivez la cible ici.
| Une tentative a échoué avec | Que faire |
|---|---|
entra_access_denied ou entra_reauthorization_required | Accordez les deux autorisations ci-dessus avec consentement, ou reconnectez la connexion Microsoft. |
entra_runtime_refused | La connexion Microsoft est absente ou désactivée. Réparez-la, ou modifiez la cible. |
entra_throttled | La limite d'Entra est atteinte. Scrydon attend le temps demandé par Entra, 5 minutes au plus, et réessaie de lui-même. |
entra_conflict | Un autre utilisateur Entra a déjà ce nom d'utilisateur principal ou une autre valeur unique. Résolvez le doublon dans Entra. |
entra_skipped | L'étendue du travail a exclu la personne. Vérifiez le filtre d'étendue du travail. |
entra_provisioning_failed | Entra n'a pas pu appliquer le changement. La tentative affiche l'erreur d'Entra. Vérifiez les mappages d'attributs du travail. |
entra_not_logged | Entra n'a pas signalé l'envoi en 4 heures. Vérifiez que le travail est démarré et pas en quarantaine. |