Vue d’ensemble des API de workflows de cycle de vie

Workflows de cycle de vie est un service de gouvernance des identités dans Microsoft Entra ID qui permet aux organisations d’automatiser les processus de cycle de vie de base pour leurs utilisateurs à trois niveaux :

1. Joiner : lorsqu’un individu entre dans l’étendue d’un besoin d’accès ; par exemple, un nouvel employé qui rejoint une entreprise ou une organisation.
2. Mover : lorsqu’un individu passe d’une limite à l’autre au sein d’une organisation ; par exemple, un utilisateur qui était en marketing est maintenant membre de l’organisation commerciale. Ce déplacement peut nécessiter davantage d’accès ou d’autorisation, ou la révocation d’autres privilèges.
3. Leaver : lorsqu’une personne quitte l’étendue du besoin d’accès, l’accès doit peut-être être révoqué et l’utilisateur déprovisionné. Par exemple, un employé qui prend sa retraite ou qui est licencié.

Pour cette raison, les workflows de cycle de vie peuvent être appelés flux de travail Joiner-Mover-Leaver (JML).

Les API de flux de vie dans Microsoft Graph vous permettent d’automatiser les fonctionnalités des workflows de cycle de vie pour votre organisation. Cet article a présenté l’ensemble des API qui activent le service Workflows de cycle de vie dans l’ID Microsoft Entra.

Les API des workflows de cycle de vie sont définies dans le sous-espace de nom OData, microsoft.graph.identityGovernance.

Flux de travail

Les flux de travail sont des conteneurs pour les processus impliqués dans la gestion du cycle de vie des utilisateurs de l’organisation. Les tâches et les conditions d’exécution sont à la base.

• Les tâches sont des actions spécifiques qui s’exécutent automatiquement lorsqu’un workflow est déclenché.
• Les conditions d’exécution définissent l’étendue de « qui » et le déclencheur de « quand » un workflow s’exécute.

Pour créer des flux de travail, nous vous recommandons d’utiliser l’un des modèles de flux de travail prédéfinis.

Modèles de flux de travail

Microsoft Entra ID fournit les modèles de flux de travail prédéfinis suivants qui définissent les modèles pour les combinaisons de tâches et de conditions d’exécution qui peuvent faire partie d’un workflow. Vous pouvez utiliser les modèles de flux de travail pour créer vos workflows par programmation.

Utilisez le type de ressource workflowTemplate et ses méthodes associées pour identifier les modèles préconfigurés, ainsi que les tâches et les conditions d’exécution qu’ils prennent en charge, puis copiez et utilisez les modèles pour créer vos workflows par programmation.

Informations générales sur les flux de travail

Chaque workflow contient des informations descriptives générales telles que son identificateur, son nom, sa description et s’il est activé pour s’exécuter comme planifié ou à la demande.

Tâches de flux de travail

Les tâches de flux de travail sont des actions spécifiques qui s’exécutent automatiquement lorsqu’un workflow est déclenché. Les workflows de cycle de vie définissent les tâches préconfigurées et en lecture seule suivantes autorisées pour les catégories de flux de travail spécifiées. Ces définitions de tâches affichent les paramètres du type de tâche, vous guidant lorsque vous créez des tâches pour votre workflow.

Les workflows de cycle de vie prennent actuellement en charge les tâches suivantes :

Utilisez le type de ressource taskDefinition et ses méthodes associées pour découvrir toutes les tâches prédéfinies qui peuvent être configurées pour votre flux de travail et les paramètres des propriétés. Le type de ressource de tâche et les méthodes GET associées vous permettent d’afficher les tâches configurées pour votre workflow.

Conditions d’exécution

Pour chaque tâche de flux de travail, il existe une condition d’exécution qui définit l’étendue de « qui » et le déclencheur de « quand » un workflow et ses tâches associées s’exécutent. Par exemple, une condition d’exécution peut spécifier qu’un workflow s’exécute pour les employés qui quittent, sept jours avant leur date de fin d’emploi, s’ils se trouvent dans le service R&D. La tâche associée dans le flux de travail peut spécifier que l’utilisateur est supprimé des équipes et groupes R&D.

⁄⁄Sample snippet for the executionConditions object

"executionConditions": {
    "@odata.type": "#microsoft.graph.identityGovernance.triggerAndScopeBasedConditions",
    "scope": {
        "@odata.type": "#microsoft.graph.identityGovernance.ruleBasedSubjectSet",
        "rule": "department eq 'R&D'"
    },
    "trigger": {
        "@odata.type": "#microsoft.graph.identityGovernance.timeBasedAttributeTrigger",
        "timeBasedAttribute": "employeeLeaveDateTime",
        "offsetInDays": -7
    }
}

Lors de la création ou de la mise à jour d’un workflow, utilisez le type de ressource workflowExecutionConditions pour configurer les conditions d’exécution. Utilisez cet objet pour configurer également un workflow qui s’exécute uniquement à la demande.

Créer et gérer des flux de travail

Après avoir identifié les tâches et les conditions d’exécution que vous souhaitez définir pour votre flux de travail, utilisez le type de ressource de flux de travail et les méthodes associées pour créer et gérer le flux de travail. Vous pouvez créer jusqu’à 100 workflows dans un locataire. La catégorie de la tâche doit correspondre à la catégorie du flux de travail. Chaque workflow peut avoir jusqu’à 25 tâches. Donc:

• Une tâche prise en charge uniquement pour la catégorie de workflow « leaver » ne peut pas être spécifiée dans un scénario de flux de travail « joiner » ou « mover », et inversement.
• Une tâche prise en charge pour les catégories de flux de travail « joiner », « mover » et « leaver » peut être spécifiée dans un scénario de flux de travail « joiner », « mover » ou « leaver ».

Vous pouvez planifier l’exécution d’un workflow en fonction de la planification à l’échelle du locataire ou l’exécuter à la demande. La planification du locataire peut prendre en charge les nouvelles embauches et les résiliations planifiées, tandis que vous pouvez exécuter un workflow à la demande immédiatement pour mettre fin à l’accès d’un employé en cas d’événement sensible.

Versions de flux de travail

Pendant l’utilisation d’un workflow, vous devrez peut-être mettre à jour les conditions d’exécution et les tâches d’un workflow. Toutefois, les workflows de cycle de vie ne vous permettent pas de mettre à jour ces propriétés pour un flux de travail existant.

Au lieu de créer de nouveaux flux de travail, utilisez le type de ressource workflowVersion et ses méthodes associées pour créer et gérer une nouvelle version de workflow, basée sur un objet de flux de travail existant. La version du workflow peut avoir un ensemble similaire ou différent de tâches et de conditions d’exécution.

Rapports

Les workflows de cycle de vie prennent en charge des fonctionnalités de création de rapports étendues pour suivre l’état du traitement des flux de travail au niveau de l’exécution du flux de travail, au niveau de la tâche et de l’utilisateur.

Pour plus d’informations sur les fonctionnalités de création de rapports pour les workflows de cycle de vie, consultez la vue d’ensemble des API de création de rapports des workflows de cycle de vie.

Extensions

Parfois, les tâches intégrées peuvent ne pas être suffisantes pour répondre à tous vos scénarios métier. Pour étendre vos scénarios de gestion du cycle de vie, les workflows de cycle de vie prennent en charge la définition de tâches personnalisées à intégrer à des systèmes externes via Azure Logic Apps. Par exemple, pour un scénario de « leaver », vous pouvez également accorder au responsable de l’utilisateur l’accès au compte de messagerie de l’utilisateur.

Utilisez le type de ressource customTaskExtension et ses méthodes associées pour définir les paramètres de votre application logique Azure.

Paramètres

Chaque locataire définit une planification à l’échelle du locataire lorsque tous les workflows planifiés sont exécutés. Le locataire peut adopter la planification par défaut définie par l’ID Microsoft Entra où les flux de travail sont exécutés toutes les trois heures, ou modifier la planification pour qu’elle s’exécute entre 1 heure et 24 heures.

Vérifications des licences

L’utilisation de cette fonctionnalité nécessite des licences de gouvernance d’ID Microsoft Entra. Pour trouver la licence adaptée à vos besoins, consultez Comparer les fonctionnalités généralement disponibles de Microsoft Microsoft Entra ID.

Contenu connexe

• Que sont les workflows de cycle de vie ?
• Concepts dans les workflows de cycle de vie
• Tutoriel : Automatiser les tâches de retrait des employés après leur dernier jour de travail avec Microsoft Graph
• Tutoriel : Exécuter des tâches de retrait des employés en temps réel le dernier jour de leur travail avec Microsoft Graph
• Tutoriel : Automatiser les tâches d’intégration des employés avant leur premier jour de travail avec Microsoft Graph