Naslaginformatie voor het uitbreiden van Microsoft Entra kenmerktoewijzingen met aangepaste bijschriften met behulp van LCW-uitbreidbaarheidswerkstromen (preview)

Wanneer u inrichting configureert, is een van de typen kenmerktoewijzingen die u kunt opgeven het type uitbreidbaarheidswerkstroomtoewijzing voor levenscycluswerkstromen (LCW). Met dit toewijzingstype kunt u kenmerktoewijzingen uitbreiden buiten de basistransformaties die worden ondersteund door het toewijzingstype expressies, zodat u kunt voldoen aan scenario's waarin aangepaste bedrijfslogica mogelijk vereist is.

Als u het toewijzingstype LCW-uitbreidbaarheidswerkstroom wilt configureren, moet u een LCW-werkstroom voor uitbreidbaarheid maken die een Azure logische app aanroept om een waarde te genereren. De waarde die door de Azure logische app wordt gegenereerd, wordt vervolgens toegepast op een doelkenmerk.

Prerequisites

U moet een Azure logische app maken. Hiervoor moet u het volgende hebben:

Een Azure-abonnement (vereist voor het maken en gebruiken van een Azure logische app)
Ten minste een rol inzender voor logische apps

U moet een LCW-uitbreidbaarheidswerkstroom maken om de Azure logische app te activeren. Hiervoor moet u het volgende hebben:

Een Entra ID-beheerlicentie
Ten minste de rol Van beheerder van levenscycluswerkstromen

Voor het configureren van een inrichtingstaak, inclusief kenmerktoewijzingen, hebt u het volgende nodig:

Ten minste een rol van toepassingsbeheerder . Als u binnenkomende inrichting configureert voor een on-premises Active Directory, is ook de rol Hybrid Identity Administrator vereist

Overzicht van LCW-werkstroom voor uitbreidbaarheid

Een LCW-uitbreidbaarheidswerkstroom is een nieuw type levenscycluswerkstroom dat verschilt van de bestaande joiner-, Mover- en verloftypen.

Net als bij Joiner-, Mover- en Leaver-werkstromen geeft u een taak op die moet worden uitgevoerd voor de werkstroom. In dit geval moet de taak een aangepaste extensie activeren. U kunt een aangepaste extensie beschouwen als een wrapper voor de Azure logische app waarin uw aangepaste logica wordt opgeslagen. Wanneer de aangepaste extensie wordt geactiveerd door de werkstroom voor uitbreidbaarheid, wordt de Azure logische app uitgevoerd.

In tegenstelling tot Joiner-, Mover- en Leaver-werkstromen kunnen echter werkstromen voor uitbreidbaarheid worden uitgevoerd voordat een gebruiker wordt ingericht. Met andere woorden, een werkstroom voor uitbreidbaarheid kan onafhankelijk worden uitgevoerd van of een bepaald gebruikersaccount aanwezig is in de Entra ID directory.

Dit maakt uitbreidbaarheidswerkstromen handig in scenario's voor vooraf inrichten (ook wel pre-joiner genoemd). U kunt bijvoorbeeld een uitbreidbaarheidswerkstroom gebruiken om een unieke alias te genereren voor een zojuist ingehuurde werknemer voordat u het account inricht in de directory en deze vervolgens toegang geeft tot bedrijfsresources.

Note

Op dit moment ondersteunt een LCW-uitbreidbaarheidswerkstroom slechts één triggertype (kenmerktoewijzing inrichten) en één taak (Een gegevensgestuurde aangepaste taakextensie uitvoeren).

Stap 0: een Azure logische app maken

U moet een op verbruik gebaseerde Azure logische app maken die één waarde uitvoert die wordt toegepast op een doelkenmerk.

Als u nog niet eerder Azure Logic Apps, kunt u hier meer lezen. Daarnaast vindt u instructies voor het maken van uw eerste op verbruik gebaseerde Azure logische app in deze zelfstudie.

Stap 1: Een aangepaste extensie maken

Voordat u een uitbreidbaarheidswerkstroom maakt, hebt u een aangepaste extensie nodig die u kunt koppelen aan uw werkstroom voor uitbreidbaarheid. Zoals eerder vermeld, kunt u de aangepaste extensie beschouwen als een wrapper voor de Azure logische app waarin uw aangepaste logica zich bevindt. Wanneer de werkstroom voor uitbreidbaarheid de aangepaste extensie activeert, wordt de Azure logische app uitgevoerd.

In het Microsoft Entra-beheercentrum

Meld u via de Microsoft Entra-beheercentrum aan bij uw Entra ID tenant met behulp van uw browser.
Navigeer naar Aangepaste extensies > voor levenscycluswerkstromen > Voeg een aangepaste extensie toe.
Voeg op het tabblad Basis van de wizard Maken een naam en beschrijving toe voor uw aangepaste extensie.
Selecteer op het tabblad Taakgedrag de optie Wachten op resultaat starten (preview).a0>
Op het tabblad Details kunt u de aangepaste extensie koppelen aan een Azure logische app. Ervan uitgaande dat u er al een hebt gemaakt, selecteert u Nee voor een logische app maken en voert u vervolgens de details van het abonnement, de resourcegroep en de logische app in voor Azure logische app.
Controleer de details van uw aangepaste extensie op het tabblad Controleren en maken en klik op Maken om te voltooien.

U hebt nu een aangepaste extensie die als taak kan worden gekoppeld aan een uitbreidbaarheidswerkstroom. Laten we nu gaan werken aan het maken van een werkstroom voor uitbreidbaarheid.

Microsoft Graph gebruiken

Start het hulpprogramma Microsoft Graph Explorer.
Meld u aan bij uw tenant.
Selecteer Machtigingen wijzigen.
Toestemming voor de volgende vereiste machtigingen: LifecycleWorkflows-CustomExt.ReadWrite.All
Gebruik de API Create customTaskExtensions om een aangepaste extensie te maken.

Voorbeeldaanvraag

POST /identityGovernance/lifecycleWorkflows/customTaskExtensions
Content-Type: application/json

{
	"displayName": "test1",
	"description": "test1",
	"endpointConfiguration": {
		"@odata.type": "#microsoft.graph.logicAppTriggerEndpointConfiguration",
		"subscriptionId": "00000000-0000-0000-0000-000000000000",
		"resourceGroupName": "lcw-synthetics",
		"logicAppWorkflowName": "testReply"
	},
	"callbackConfiguration": null,
	"authenticationConfiguration": {
		"@odata.type": "#microsoft.graph.azureAdPopTokenAuthentication"
	},
	"id": "",
	"clientConfiguration": {
		"timeoutInMilliseconds": 1000,
		"maximumRetries": 1
	},
	"replyMode": "response"
}

Voorbeeldantwoord

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/customTaskExtensions/$entity",
  "id": "902ca666-6b67-4d45-839c-8836d7f205f9",
  "displayName": "test1",
  "description": "test1",
  "createdDateTime": "2026-04-20T19:56:27.0723563Z",
  "lastModifiedDateTime": "2026-04-20T19:56:27.0723657Z",
  "replyMode": "response",
  "callbackConfiguration": null,
  "endpointConfiguration": {
		"@odata.type": "#microsoft.graph.logicAppTriggerEndpointConfiguration",
		"subscriptionId": "00000000-0000-0000-0000-000000000000",
		"resourceGroupName": "lcw-synthetics",
		"logicAppWorkflowName": "testReply",
		"url": "https://prod-05.southcentralus.logic.azure.com:443/workflows/c070dc95455e4e5a98da954feeb7e756/triggers/manual/paths/invoke?api-version=2016-10-01"
  },
	"authenticationConfiguration": {
		"@odata.type": "#microsoft.graph.azureAdPopTokenAuthentication"
	},
	"clientConfiguration": {
		"maximumRetries": 1,
		"timeoutInMilliseconds": 1000
	}
}

U hebt nu een aangepaste extensie die als taak kan worden gekoppeld aan een uitbreidbaarheidswerkstroom. Laten we nu gaan werken aan het maken van een werkstroom voor uitbreidbaarheid.

Stap 2: Een werkstroom voor uitbreidbaarheid maken

Nadat u een aangepaste extensie hebt gemaakt, kunt u nu een uitbreidbaarheidswerkstroom maken waarvan de taak is om de aangepaste extensie te activeren.

In het Microsoft Entra-beheercentrum

Meld u via de Microsoft Entra-beheercentrum aan bij uw Entra ID tenant met behulp van uw browser.
Navigeer naar levenscycluswerkstromen > voor identiteitsbeheer>: werkstroom maken.
Selecteer op het tabblad Een sjabloon kiezen de uitbreidbaarheidssjabloon realtime inrichten .
Voer op het tabblad Basis een naam en beschrijving in voor de werkstroom. Het triggertype wordt automatisch ingesteld op Kenmerktoewijzing inrichten. Dit is het enige triggertype dat momenteel wordt ondersteund voor uitbreidbaarheidswerkstromen.
We gaan nu uw werkstroom voor uitbreidbaarheid configureren zodat deze een aangepaste extensie activeert. Klik op het tabblad Taken controleren op de taak Een gegevensgestuurde aangepaste taakextensie uitvoeren. Deze taak moet automatisch zijn toegevoegd aan de tabel werkstroomtaken als onderdeel van de uitbreidbaarheidssjabloon voor realtime inrichting.
Klik in het contextvenster Een gegevensgestuurde aangepaste taakextensie uitvoeren op het veld Aangepaste extensie selecteren en selecteer de aangepaste extensie die u in de vorige sectie hebt gemaakt.
Klik op Opslaan.
Controleer de details van uw werkstroom op het tabblad Controleren en maken en klik op Maken om te voltooien.

U hebt nu een uitbreidbaarheidswerkstroom waarmee een Azure logische app kan worden geactiveerd die uw aangepaste logica bevat. Laten we nu gaan werken aan het toewijzen van de uitbreidbaarheidswerkstroom aan een doelkenmerk.

Microsoft Graph gebruiken

Start het hulpprogramma Microsoft Graph Explorer.
Meld u aan bij uw tenant.
Selecteer Machtigingen wijzigen.
Toestemming voor de volgende vereiste machtigingen: LifecycleWorkflows-Workflow.ReadWrite.All
Gebruik de werkstroom-API maken om een LCW-uitbreidbaarheidswerkstroom te maken.

Voorbeeldaanvraag

POST /identityGovernance/lifecycleWorkflows/workflows
Content-Type: application/json

{
	"category": "extensibility",
	"displayName": "Real-time Provisioning extensibility (Preview)",
	"description": "Execute real-time extensibility tasks for performing attribute mapping extensions",
	"tasks": [
		{
      "arguments": [
        {
          "name": "customTaskExtensionID",
					"value": "f740553f-a6a2-4dc8-82df-148336dcd920"
				}
			],
			"description": "Run a Custom Task Extension and pass data from the workflow as input",
			"displayName": "Run a Data driven Custom Task Extension (Preview)",
			"isEnabled": true,
			"id": "77bb973f-3150-4a0f-b49b-24d1baa677f6",
			"continueOnError": false,
			"taskDefinitionId": "09303719-609e-4348-8bbc-d3ee45a2657e",
			"category": "extensibility"
		}
	],
	"executionConditions": {
		"@odata.type": "#microsoft.graph.identityGovernance.provisioningAttributeMapping"
 	},
	"isEnabled": true,
	"isSchedulingEnabled": false,
	"targetSubjectType": "provisioningObject"
}

Voorbeeldantwoord

HTTP/1.1 201 Created
Content-Type: application/json

{
	"@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows/$entity",
	"category": "extensibility",
	"description": "Execute real-time extensibility tasks for performing attribute mapping extensions",
	"displayName": "Real-time Provisioning extensibility (Preview)",
	"isEnabled": true,
	"isSchedulingEnabled": false,
	"lastModifiedDateTime": "2026-04-20T19:58:42.4447369Z",
	"targetSubjectType": "provisioningObject",
	"createdDateTime": "2026-04-20T19:58:42.444727Z",
	"deletedDateTime": null,
	"id": "e41388b5-446e-4cf1-9bce-92cd09f828e5",
	"nextScheduleRunDateTime": null,
	"version": 1,
	"executionConditions": {
		"@odata.type": "#microsoft.graph.identityGovernance.provisioningAttributeMapping"
	},
	"quarantineDetails": {
		"quarantinedDateTime": null,
		"quarantineType": "notQuarantined",
		"quarantineReason": null
	},
	"settings": {
		"quarantineConfiguration": {
			"matchMode": "any",
			"conditions": []
		}
	}
}

Stap 3: Een uitbreidbaarheidswerkstroom toewijzen aan een doelkenmerk

Nu u een uitbreidbaarheidswerkstroom hebt gemaakt, is het tijd om deze toe te wijzen aan een kenmerk in een inrichtingstaak. Dit is zo dat wanneer een inrichtingstaak wordt uitgevoerd, de werkstroom voor uitbreidbaarheid een waarde genereert voor dat kenmerk voor elk object binnen het bereik van de inrichtingstaak.

Als u bijvoorbeeld een uitbreidbaarheidswerkstroom toewijst aan het doelkenmerk userPrincipalName en er vijf gebruikers binnen het bereik van uw inrichtingstaak zijn, genereert de werkstroom een waarde voor het kenmerk userPrincipalName voor alle vijf gebruikers.

In het Microsoft Entra-beheercentrum

Meld u via de Microsoft Entra-beheercentrum aan bij uw Entra ID tenant met behulp van uw browser.
Navigeer naar Enterprise-apps > Alle toepassingen.
Selecteer een specifieke toepassing (bijvoorbeeld een HR-connector zoals SuccessFactors of Workday of een SaaS-toepassing).
Navigeer in de toepassing naar de toewijzing van het inrichtingskenmerk>.
Zoek in de lijst met kenmerktoewijzingen het doelkenmerk waarvoor u aangepaste logica wilt aanroepen. Selecteer het bewerkingspictogram (het potloodsymbool) voor dat kenmerk.
Selecteer in de blade Kenmerktoewijzing bewerkende werkstroom LCW-uitbreidbaarheid in de vervolgkeuzelijst Toewijzingstype .
Klik op het werkstroomveld LCW-uitbreidbaarheid om de werkstroomkiezer voor uitbreidbaarheid te openen.
Selecteer in het contextvenster Uitbreidbaarheidswerkstroom selecteren de juiste uitbreidbaarheidswerkstroom in de lijst en druk op Selecteren.
Geef voor het veld Invoerkenmerken op welke bronsysteemkenmerken u doorgeeft aan de werkstroom voor uitbreidbaarheid en een alias voor het kenmerk (aliassen kunnen met name nuttig zijn voor scenario's waarin de bronkenmerknamen lang of niet-leesbaar zijn en mogelijk een beschrijvende naam nodig hebben).
Selecteer de knop Bewerken onder aan de blade Kenmerktoewijzing bewerken .

Als de werkstroom voor uitbreidbaarheid is toegewezen aan het doelkenmerk, wordt de pagina Kenmerktoewijzing bijgewerkt, zodat in de kolom Toewijzingstype de werkstroom LCW-uitbreidbaarheid voor dat kenmerk wordt weergegeven.

Zodra u klaar bent met het configureren van de instellingen van uw inrichtingstaak, kunt u nu een inrichtingstaak als normaal starten. De LCW-uitbreidbaarheidswerkstroom wordt nu uitgevoerd voor alle objecten binnen het bereik.

Microsoft Graph gebruiken

Meld u via de Microsoft Entra-beheercentrum aan bij uw Entra ID tenant met behulp van uw browser.
Navigeer naar Enterprise-apps > Alle toepassingen.
Selecteer de toepassing waarvoor u de kenmerktoewijzingen wilt wijzigen.
Navigeer naar Kenmerktoewijzing inrichten > en selecteer Geavanceerde opties > Schema bewerken.

Important

Voordat u wijzigingen aanbrengt, raden we u aan een kopie van uw bestaande schema op te slaan. Hierdoor kunt u eenvoudig terugkeren naar een stabiele/ongewijzigde versie van uw schema.

Zoek naar het doelkenmerk dat u wilt bewerken, zodat het wordt toegewezen aan de LCW-uitbreidbaarheidswerkstroom. Dit zijn de velden die u moet wijzigen voor dat kenmerk:

Naam van veld	Description
`flowType`	Moet zijn `ObjectAddOnly`, omdat LCW-uitbreidbaarheidswerkstromen alleen kunnen worden uitgevoerd tijdens het maken van gebeurtenissen
`matchingPriority`	Moet zijn `0`, omdat doelkenmerken die zijn toegewezen aan een LCW-uitbreidbaarheidswerkstroom , niet kunnen worden gebruikt als overeenkomende kenmerken
`expression`	Dit is de GUID van de LCW-uitbreidbaarheidswerkstroom
`name`	Hetzelfde als `expression`; dit is GUID van de LCW-uitbreidbaarheidswerkstroom
`type`	Moet zijn `LifecycleWorkflow`
`parameters`	Hier configureert u de bronkenmerken die u wilt doorgeven als invoer in de Azure logische app. `key`is de alias voor een bepaalde invoer (hierdoor kunnen ontwikkelaars een beschrijvende naam gebruiken met verwijzingen naar een invoer in de Azure logische app, wat handig is voor situaties waarin een bronkenmerk lang of ingewikkeld kan zijn). `expression` en `name` is een bronkenmerk.

Voorbeeld van een nieuwe kenmerktoewijzing die gebruikmaakt van LCW-uitbreidbaarheidswerkstromen

In het onderstaande voorbeeld wordt het userPrincipalName doelkenmerk bijgewerkt.

{
	"defaultValue": null,
	"exportMissingReferences": false,
	"flowBehavior": "FlowWhenChanged",
	"flowType": "ObjectAddOnly",
	"matchingPriority": 0,
	"targetAttributeName": "userPrincipalName",
	"source": {
		"expression": "2b19441a-9ff0-449d-ba74-3e4226eff132",
		"name": "2b19441a-9ff0-449d-ba74-3e4226eff132",
		"type": "LifecycleWorkflow",
		"parameters": [
			{
				"key": "firstname",
				"value": {
					"expression": "[name.givenName]",
					"name": "name.givenName",
					"type": "Attribute",
					"parameters": []
				}
			},
			{
				"key": "lastname",
				"value": {
					"expression": "[name.familyName]",
					"name": "name.familyName",
					"type": "Attribute",
					"parameters": []
				}
			}
		]
	}
}

Sla het hele bewerkte schemaobject op, niet alleen het deel dat u hebt bewerkt (overweeg dit in een afzonderlijk bestand te doen). U moet het volledige schemaobject in de aanvraagtekst van het hulpprogramma Microsoft Graph Explorer later opgeven.
Start het hulpprogramma Microsoft Graph Explorer.
Meld u aan bij uw tenant.
Selecteer Machtigingen wijzigen.
Toestemming voor de volgende vereiste machtigingen: Synchronization.ReadWrite.All
Kopieer/plak het bewerkte schemaobject in de sectie Aanvraagtekst van het hulpprogramma Microsoft Graph Explorer en gebruik de API Update synchronizationSchema om de kenmerktoewijzingen voor een bepaalde inrichtingstaak bij te werken.

Voorbeeldaanvraag

PUT /servicePrincipals/{id}/synchronization/jobs/{jobId}/schema
Content-Type: application/json

// In your request body, paste the entire schema object

Voorbeeldantwoord

HTTP/1.1 204 No Content

Limitations

Let op de volgende functiebeperkingen:

Aangepaste bijschriften worden niet ondersteund voor cloudsynchronisatie. LCW-uitbreidbaarheidswerkstromen kunnen alleen worden gebruikt voor binnenkomende HR-, API-gestuurde inrichting, Uitgaande SaaS-inrichting en synchronisatiestromen tussen tenants.
Een kenmerk met het toewijzingstype LCW-uitbreidbaarheidswerkstroom kan niet worden gebruikt voor overeenkomende waarden. Als de waarde van een kenmerk is gegenereerd met behulp van een LCW-uitbreidbaarheidswerkstroom, kan deze niet worden gebruikt als een overeenkomend kenmerk.
Aangepaste bijschriften worden alleen ondersteund voor het maken van gebeurtenissen. De LCW-werkstroomtoewijzing voor uitbreidbaarheid kan alleen worden toegepast tijdens het maken, niet bijwerken of verwijderen.
Aangepaste beveiligingskenmerken (CSA's). Het gebruik van LCW-uitbreidbaarheidswerkstromen voor het genereren van waarden voor CBA's wordt niet expliciet ondersteund. Als u besluit dit te doen, wees voorzichtig.

Feedback

Is deze pagina nuttig?

Last updated on 2026-08-03

Naslaginformatie voor het uitbreiden van Microsoft Entra kenmerktoewijzingen met aangepaste bijschriften met behulp van LCW-uitbreidbaarheidswerkstromen (preview)

Prerequisites

Overzicht van LCW-werkstroom voor uitbreidbaarheid

Stap 0: een Azure logische app maken

Stap 1: Een aangepaste extensie maken

In het Microsoft Entra-beheercentrum

Microsoft Graph gebruiken

Stap 2: Een werkstroom voor uitbreidbaarheid maken

In het Microsoft Entra-beheercentrum

Microsoft Graph gebruiken

Stap 3: Een uitbreidbaarheidswerkstroom toewijzen aan een doelkenmerk

In het Microsoft Entra-beheercentrum

Microsoft Graph gebruiken

Limitations

Verwante artikelen

Feedback

Aanvullende resources