Extensiones de directorio y asignación de atributos personalizados en Cloud Sync

Microsoft Entra ID debe contener todos los datos (atributos) necesarios para crear un perfil de usuario al aprovisionar cuentas de usuario de Microsoft Entra ID a una línea de negocio (LOB), Aplicación SaaS, o aplicación local. Puede usar extensiones de directorio para ampliar el esquema en Microsoft Entra ID con sus propios atributos. Esta característica le permite compilar aplicaciones LOB mediante el consumo de atributos que sigue administrando localmente, aprovisionar usuarios de Active Directory a Microsoft Entra ID o aplicaciones SaaS, y usar atributos de extensión en Microsoft Entra ID y características de Gobierno de Microsoft Entra ID, como grupos de pertenencia dinámica o aprovisionamiento de grupos en Active Directory.

Para obtener más información sobre las extensiones de directorio, consulte Uso de atributos de extensión de directorio en notificaciones, Microsoft Entra Connect Sync: extensiones de directorio y Sincronización de atributos de extensión para el aprovisionamiento de aplicaciones de Microsoft Entra.

Puede ver los atributos disponibles mediante el Explorador de Microsoft Graph.

Nota

Para detectar nuevos atributos de extensión de Active Directory, es necesario reiniciar el agente de aprovisionamiento. Debe reiniciar el agente después de crear las extensiones de directorio. Para los atributos de extensión de Microsoft Entra, no es necesario reiniciar el agente.

Sincronización de extensiones de directorio para Microsoft Entra Cloud Sync

Puede usar extensiones de directorio para ampliar la definición de directorio del esquema de sincronización en Microsoft Entra ID con sus propios atributos.

Importante

La extensión de directorio para Microsoft Entra Cloud Sync solo se admite para las aplicaciones con el URI de identificación API://<tenantId>/CloudSyncCustomExtensionsApp y Tenant Schema Extension App creada por Microsoft Entra Connect.

Creación de una aplicación y una entidad de servicio para la extensión de directorio

Debe crear una aplicación con el URI de identificación API://<tenantId>/CloudSyncCustomExtensionsApp si no existe y crear una entidad de servicio para la aplicación si no existe.

Graph PowerShell

1. Compruebe si existe la aplicación con el identificador URI API://<tenantId>/CloudSyncCustomExtensionsApp :

   $tenantId = (Get-MgOrganization).Id
   
   Get-MgApplication -Filter "identifierUris/any(uri:uri eq 'API://$tenantId/CloudSyncCustomExtensionsApp')"
   

   Para obtener más información, vea Get-MgApplication.

2. Si la aplicación no existe, use la $tenantId variable del paso anterior para crear la aplicación con el identificador URI API://<tenantId>/CloudSyncCustomExtensionsApp:

   New-MgApplication -DisplayName "CloudSyncCustomExtensionsApp" -IdentifierUris "API://$tenantId/CloudSyncCustomExtensionsApp"
   

   Para obtener más información, vea New-MgApplication.

3. Use la $tenantId variable del paso anterior para comprobar si la entidad de servicio existe para la aplicación con el identificador URI API://<tenantId>/CloudSyncCustomExtensionsApp:

   $appId = (Get-MgApplication -Filter "identifierUris/any(uri:uri eq 'API://$tenantId/CloudSyncCustomExtensionsApp')").AppId
   
   Get-MgServicePrincipal -Filter "AppId eq '$appId'"
   

   Para obtener más información, vea Get-MgServicePrincipal.

4. Si no existe una entidad de servicio, use la $tenantId variable del paso anterior para crear una nueva entidad de servicio para la aplicación con el identificador URI API://<tenantId>/CloudSyncCustomExtensionsApp:

   New-MgServicePrincipal -AppId $appId
   

   Para obtener más información, vea New-MgServicePrincipal.

5. Use la $tenantId variable del paso anterior para crear una extensión de directorio en microsoft Entra ID. Por ejemplo, una nueva extensión denominada "GroupDN", de tipo cadena, para objetos Group:

   $appObjId = (Get-MgApplication -Filter "identifierUris/any(uri:uri eq 'API://$tenantId/CloudSyncCustomExtensionsApp')").Id
   
   New-MgApplicationExtensionProperty -ApplicationId $appObjId -Name GroupDN -DataType String -TargetObjects Group
   

Explorador de Graph

1. Compruebe si la aplicación con el identificador URI API://<tenantId>/CloudSyncCustomExtensionsApp existe.

   GET /applications?$filter=identifierUris/any(uri:uri eq 'api://<tenantId>/CloudSyncCustomExtensionsApp')
   

   Para más información, consulte Obtener aplicación

2. Si la aplicación no existe, cree la aplicación con el identificador URI API://<tenantId>/CloudSyncCustomExtensionsApp:

   POST https://graph.microsoft.com/v1.0/applications
   Content-type: application/json
   
   {
   "displayName": "CloudSyncCustomExtensionsApp",
   "identifierUris": ["api://<tenant id>/CloudSyncCustomExtensionsApp"]
   }
   

   Para obtener más información, consulte Creación de una aplicación.

3. Compruebe si el principal de servicio existe para la aplicación cuyo identificador URI es API://<tenantId>/CloudSyncCustomExtensionsApp:

   GET /servicePrincipals?$filter=(appId eq '{appId}')
   

   Para obtener más información, consulte obtener de entidad de servicio

4. Si no existe una entidad de servicio, cree una nueva entidad de servicio para la aplicación con el identificador URI API://<tenantId>/CloudSyncCustomExtensionsApp:

   POST https://graph.microsoft.com/v1.0/servicePrincipals
   Content-type: application/json
   
   {
   "appId": 
   "<application appId>"
   }
   

   Para obtener más información, consulte create servicePrincipal.

5. Cree una extensión de directorio en microsoft Entra ID. Por ejemplo, una nueva extensión denominada "GroupDN", de tipo cadena, para objetos Group:

   POST https://graph.microsoft.com/v1.0/applications/<ApplicationId>/extensionProperties
   Content-type: application/json
   
   {
     "name": "GroupDN",
     "dataType": "String",
     "isMultiValued": false,
     "targetObjects": [
         "Group"
     ]
   }    
   

Puede crear extensiones de directorio en el identificador de Microsoft Entra de varias maneras diferentes, como se describe en la tabla siguiente:

Método	Descripción	URL
MS Graph	Creación de extensiones con Microsoft Graph	Creación de extensionProperty
PowerShell	Creación de extensiones mediante PowerShell	New-MgApplicationExtensionProperty
Uso de la sincronización en la nube y Microsoft Entra Connect	Creación de extensiones mediante Microsoft Entra Connect	Creación de un atributo de extensión mediante Microsoft Entra Connect
Personalización de atributos para sincronizar	Información sobre la personalización, qué atributos se van a sincronizar	Personalización de los atributos que se van a sincronizar con Microsoft Entra ID

Uso de la asignación de atributos para asignar Extensiones de directorio

Si ha ampliado Active Directory para incluir atributos personalizados, puede agregar estos atributos y asignarlos a los usuarios.

Para descubrir y asignar atributos, seleccione Agregar asignación de atributos y los atributos estarán disponibles en el menú desplegable bajo atributo de origen. Rellene el tipo de asignación que desee y seleccione Aplicar.

Para obtener más información sobre los nuevos atributos que se agregan y actualizan en Microsoft Entra ID, consulte el user tipo de recurso y considere la posibilidad de suscribirse a las notificaciones de cambio.

Para obtener más información sobre los atributos de extensión, consulte Atributos de extensión de sincronización para Microsoft Entra Application Provisioning.

Más recursos

• Información sobre el esquema y las Custom expressions de Microsoft Entra
• Sincronización de Microsoft Entra Connect: extensiones de directorio
• Asignación de atributos en Microsoft Entra Cloud Sync