Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Un plano técnico de identidad de agente sirve como plantilla para crear identidades de agente dentro del ecosistema de Microsoft Entra ID.
Hereda de la aplicación.
De forma predeterminada, un plano técnico admite varias identidades de agente por inquilino a través de un agentIdentityBlueprintPrincipal. Establezca isSingleInstance en true al crear el plano técnico para admitir como máximo una identidad de agente activa por inquilino, respaldada directamente por el plano técnico sin una entidad de seguridad del plano técnico de identidad de agente. Si se omite, isSingleInstance se establece de forma predeterminada en false. No se puede cambiar este valor después de la creación.
Este recurso es un tipo abierto que permite propiedades adicionales además de las documentadas aquí.
Métodos
| Método | Tipo devuelto | Descripción |
|---|---|---|
| List | Colección agentIdentityBlueprint | Obtenga una lista de los objetos agentIdentityBlueprint y sus propiedades. |
| Crear | agentIdentityBlueprint | Crea (registra) un nuevo agentIdentityBlueprint. |
| Get | agentIdentityBlueprint | Lea las propiedades y relaciones del objeto agentIdentityBlueprint . |
| Actualizar | agentIdentityBlueprint | Actualice las propiedades de un objeto agentIdentityBlueprint. |
| Upsert | agentIdentityBlueprint | Cree un nuevo plano técnico de identidad de agente si no existe, o actualice las propiedades de un plano técnico existente. |
| Delete | Ninguno | Eliminar un objeto agentIdentityBlueprint. |
| Credenciales | ||
| Add password | passwordCredential | Agregue una contraseña segura o un secreto a un plano técnico de identidad de agente. |
| Remove password | passwordCredential | Quitar una contraseña o un secreto de un plano técnico de identidad de agente. |
| Agregar clave | keyCredential | Agregar una credencial de clave a un plano técnico de identidad de agente. |
| Quitar clave | Ninguna | Quitar una credencial de clave de un plano técnico de identidad de agente. |
| Enumerar credenciales de identidad federada | Colección federatedIdentityCredential | Obtener una lista de los objetos federatedIdentityCredential y sus propiedades. |
| Crear credencial de identidad federada | federatedIdentityCredential | Cree un nuevo objeto federatedIdentityCredential . |
| Obtener credencial de identidad federada | federatedIdentityCredential | Lea las propiedades y relaciones de un objeto federatedIdentityCredential . |
| Actualizar credenciales de identidad federada | Ninguno | Actualizar las propiedades de un objeto federatedIdentityCredential . |
| Credenciales de identidad federada de Upsert | federatedIdentityCredential | Cree una nueva federatedIdentityCredential si no existe, o actualice las propiedades de un objeto federatedIdentityCredential existente. |
| Eliminar credenciales de identidad federada | Ninguno | Eliminar un objeto federatedIdentityCredential . |
| Configuración de comunicación | ||
| Obtener communicationConfiguration | agentCommunicationConfiguration | Obtenga la configuración de comunicación predeterminada para este plano técnico de identidad de agente. |
| Update communicationConfiguration | agentCommunicationConfiguration | Actualice la configuración de comunicación predeterminada para este plano técnico de identidad de agente. |
| Elementos eliminados | ||
| Lista | Colección directoryObject | Recuperar una lista de identidades de agente eliminadas recientemente. |
| Get | directoryObject | Recuperar las propiedades de una identidad de agente eliminada recientemente. |
| Restaurar | directoryObject | Restauración de una identidad de agente eliminada recientemente. |
| Eliminar permanentemente | Ninguno | Eliminar permanentemente una identidad de agente. |
| Propietarios | ||
| Enumerar propietarios | Colección directoryObject | Obtenga los propietarios de este principal del plano de identidad del agente. |
| Agregar propietarios | directoryObject | Asignar un propietario a esta entidad de seguridad del plano técnico de identidad de agente. |
| Quitar propietarios | Ninguno | Eliminar un propietario de esta entidad de seguridad del plano técnico de identidad de agente. |
| Patrocinadores | ||
| Enumerar patrocinadores | Colección directoryObject | Obtenga los patrocinadores para este plano de identidad de agente. Los patrocinadores son usuarios o entidades de servicio que pueden autorizar y administrar el ciclo de vida de las instancias de identidad del agente. |
| Agregar patrocinadores | directoryObject | Agregue patrocinadores publicando en la colección de patrocinadores. |
| Eliminar patrocinadores | Ninguno | Quite un objeto directoryObject . |
| Editor verificado | ||
| Set | Ninguno | Establecer el editor verificado de una aplicación. |
| Sin establecer | Ninguno | Anular el editor verificado de una aplicación. |
Propiedades
Importante
Aunque este recurso hereda de la aplicación, algunas propiedades no son aplicables y devuelven null valores predeterminados. Estas propiedades se excluyen de la tabla siguiente.
| Propiedad | Tipo | Descripción |
|---|---|---|
| api | apiApplication | Especifica la configuración de un plano técnico de identidad de agente que implementa una API web. Heredado de la aplicación. |
| appId | Cadena | El identificador único para el plano técnico de identidad del agente asignado por Microsoft Entra ID. No admite valores NULL. Solo lectura. Heredado de la aplicación. |
| appRoles | Colección appRole | Colección de roles definidos para el plano técnico de identidad de agente. Con las asignaciones de rol de la aplicación, se pueden asignar estos roles a los usuarios, grupos u otras entidades de servicio asociadas con otras aplicaciones. No admite valores NULL. Heredado de la aplicación. |
| certificación | certificación | Especifica el estado de certificación del plano técnico de identidad del agente. Heredado de la aplicación. |
| createdByAppId | Cadena | El AppId de la aplicación que creó este plano técnico de identidad de agente. Establecido internamente por Microsoft Entra ID. Solo lectura. Heredado de la aplicación. |
| createdDateTime | DateTimeOffset | La fecha y hora en que se registró el plano técnico de identidad de agente. El tipo DateTimeOffset representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Solo lectura. Heredado de la aplicación. |
| description | Cadena | Campo de texto libre para proporcionar una descripción del plano técnico de identidad del agente a los usuarios finales. El tamaño máximo permitido es de 1024 caracteres. El permiso con privilegios mínimos para actualizar esta propiedad es AgentIdentityBlueprint.UpdateBranding.All. Heredado de la aplicación. |
| disabledByMicrosoftStatus | Cadena | Especifica si Microsoft ha deshabilitado el plano técnico de identidad de agente registrado. Los valores posibles son: null (valor predeterminado) NotDisabledy DisabledDueToViolationOfServicesAgreement (los motivos pueden incluir actividad sospechosa, abusiva o malintencionada, o una infracción del Contrato de servicios de Microsoft). Heredado de la aplicación. |
| displayName | Cadena | El nombre para mostrar del plano técnico de identidad del agente. La longitud máxima es de 256 caracteres. El permiso con privilegios mínimos para actualizar esta propiedad es AgentIdentityBlueprint.UpdateBranding.All. Heredado de la aplicación. |
| groupMembershipClaims | Cadena | Configura la groups notificación emitida en un usuario o token de acceso de OAuth 2.0 que espera el plano técnico de identidad de agente. Para establecer este atributo, utilice uno de los siguientes valores de cadena: None, SecurityGroup (para grupos de seguridad y roles de Microsoft Entra), All (obtiene todos los grupos de seguridad, grupos de distribución y roles de directorio de Microsoft Entra de los que el usuario que ha iniciado sesión es miembro). Heredado de la aplicación. |
| id | Cadena | Identificador único para el objeto de plano técnico de identidad de agente. Esta propiedad se conoce como Id. de objeto en el Centro de administración de Microsoft Entra. Clave. No admite valores NULL. Solo lectura. Heredado de directoryObject. |
| identifierUris | Colección string | También conocido como URI de id. de aplicación, este valor se establece cuando se usa un plano técnico de identidad de agente como aplicación de recursos. identifierUris actúa como prefijo de los ámbitos a los que hace referencia en el código de la API y debe ser único globalmente en Microsoft Entra ID. No admite valores NULL. Heredado de la aplicación. |
| info | informationalUrl | Información de perfil básica del plano de identidad del agente, como las direcciones URL de la declaración de marketing, soporte técnico, términos de servicio y declaración de privacidad. Las condiciones del servicio y la declaración de privacidad se exponen a los usuarios mediante la experiencia de consentimiento del usuario. Heredado de la aplicación. |
| isDisabled | Booleano | Desactivar un plano técnico de identidad de agente sin eliminarlo. Esta configuración especifica si la entidad de servicio asociada con el plano técnico de identidad del agente puede obtener nuevos tokens de acceso o acceder a recursos protegidos. Cuando se establece en true, los tokens existentes siguen siendo válidos hasta que expiran en función de su duración configurada.
true si el plano técnico de identidad del agente está desactivado; de lo contrario false. Heredado de la aplicación. |
| isSingleInstance | Booleano | Especifica si el plano técnico admite una única identidad de agente por inquilino sin una entidad de seguridad del plano técnico de identidad de agente. Valores predeterminados de false. Inmutable después de la creación, ya sea que se establezca en true o false. No admite valores NULL. Heredado de la aplicación. Admite $filter (eq) con el ConsistencyLevel: eventual encabezado y $count=true. |
| keyCredentials | Colección keyCredential | Colección de credenciales clave asociadas con el plano técnico de identidad del agente. No admite valores NULL. El permiso con privilegios mínimos para actualizar esta propiedad es AgentIdentityBlueprint.AddRemoveCreds.All. Heredado de la aplicación. |
| de administradorAplicaciones | Colección Guid | Una colección de identificadores de aplicación para las aplicaciones designadas como administradores de este plano de identidad de agente. Las aplicaciones de administrador pueden crear entidades principales, identidades de agente y usuarios de agente para sus planos técnicos administrados, sin necesidad de permisos con privilegios elevados como AgentIdentityBlueprintPrincipal.ReadWrite.All. Actualmente, solo los identificadores de aplicaciones propias de Microsoft se pueden establecer como valores. Máximo de 10 valores. No admite valores NULL. |
| optionalClaims | optionalClaims | Los desarrolladores de aplicaciones pueden configurar reclamaciones opcionales en sus planos técnicos de identidad de agente de Microsoft Entra para especificar las notificaciones que el servicio de tokens de seguridad de Microsoft envía a su aplicación. Heredado de la aplicación. |
| passwordCredentials | Colección passwordCredential | La colección de credenciales de contraseña asociadas con el plano técnico de identidad del agente. No admite valores NULL. El permiso con privilegios mínimos para actualizar esta propiedad es AgentIdentityBlueprint.AddRemoveCreds.All. Heredado de la aplicación. También puede agregar contraseñas después de crear el plano técnico de identidad del agente mediante una llamada a la API Agregar contraseña . |
| publisherDomain | Cadena | El dominio de editor comprobado para el plano técnico de identidad del agente. Solo lectura. Heredado de la aplicación. |
| requiredResourceAccess | Colección requiredResourceAccess | Especifica los recursos a los que el agentIdentityBlueprint necesita acceder. Esta propiedad también especifica el conjunto de permisos delegados y roles de aplicación que necesita para cada uno de esos recursos. Esta configuración de acceso a los recursos necesarios controla la experiencia del consentimiento. No se pueden configurar más de 50 servicios de recursos (API). El número total de permisos necesarios no debe superar los 400. Para obtener más información, consulte Límites en los permisos solicitados por aplicación. No admite valores NULL. Heredado de la aplicación. Admite $filter (eq, not, ge, le). |
| serviceManagementReference | Cadena | Hace referencia a la información de contacto de la aplicación o servicio de una base de datos de administración de recursos o servicios. Admite un valor NULL. Heredado de la aplicación. |
| signInAudience | Cadena | Especifica las cuentas de Microsoft que se admiten para el plano técnico de identidad de agente actual. Los valores posibles son: AzureADMyOrg (predeterminado), AzureADMultipleOrgs, AzureADandPersonalMicrosoftAccount, y PersonalMicrosoftAccount. Heredado de la aplicación. |
| tags | Colección string | Cadenas personalizadas que se pueden usar para categorizar e identificar el plano técnico de identidad del agente. No admite valores NULL. Heredado de la aplicación. |
| tokenEncryptionKeyId | Guid | Especifica el valor keyId de una clave pública de la colección keyCredentials. Cuando se configura, Microsoft Entra ID cifra todos los tokens que emite mediante la clave a la que apunta esta propiedad. Heredado de la aplicación. |
| uniqueName | Cadena | El identificador único que se puede asignar a un plano técnico de identidad de agente y usarse como clave alternativa. Inmutable. Solo lectura. Heredado de la aplicación. |
| verifiedPublisher | verifiedPublisher | Especifica el publicador comprobado del plano técnico de identidad del agente. Heredado de la aplicación. |
| web | webApplication | Especifica opciones de configuración para una aplicación web. Heredado de la aplicación. |
Límites de permisos solicitados por aplicación
Microsoft Entra ID limita el número de permisos que una aplicación cliente puede solicitar y consentir. Estos límites dependen del valor de signInAudience una aplicación, que se muestra en el manifiesto de la aplicación.
| signInAudience | Usuarios permitidos | Permisos máximos que la aplicación puede solicitar | Permisos máximos Microsoft Graph que la aplicación puede solicitar | Permisos máximos que se pueden consentir en una sola solicitud |
|---|---|---|---|---|
| AzureADMyOrg | Usuarios de la organización donde está registrada la aplicación | 400 | 400 | Unos 155 permisos delegados y unos 300 permisos de aplicación |
| AzureADMultipleOrgs | Usuarios de cualquier organización de Microsoft Entra | 400 | 400 | Unos 155 permisos delegados y unos 300 permisos de aplicación |
| PersonalMicrosoftAccount | Usuarios consumidores (como cuentas de Outlook.com o Live.com) | 30 | 30 | 30 |
| AzureADandPersonalMicrosoftAccount | Usuarios consumidores y usuarios de cualquier organización de Microsoft Entra | 30 | 30 | 30 |
Nota:
Para el Agente de Microsoft Entra ID, algunos permisos de Microsoft Graph de alto riesgo se bloquean globalmente para los agentes y no se pueden conceder a las identidades de los agentes.
Si incluye un ámbito de permiso delegado de Microsoft Graph bloqueado o un rol de aplicación en la resourceAccess recopilación de una requiredResourceAccess entrada, la solicitud se rechaza con una respuesta HTTP 400 Bad Request y un error que indica que el permiso está bloqueado y no se puede conceder a las identidades de agente.
Para obtener la lista de permisos bloqueados de Microsoft Graph para agentes, consulte Permisos de Microsoft Graph bloqueados para agentes.
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| appManagementPolicies | Colección appManagementPolicy | La appManagementPolicy aplicada a este plano técnico de identidad de agente. Heredado de microsoft.graph.application |
| communicationConfiguration | agentCommunicationConfiguration | La configuración de comunicación predeterminada para las identidades de agente creadas a partir de este plano técnico de identidad de agente. Las identidades de agente heredan esta configuración a menos que definan su propia invalidación. |
| federatedIdentityCredentials | Colección federatedIdentityCredential | Identidades federadas para planos técnicos de identidad de agente. Heredado de microsoft.graph.application |
| inheritablePermissions | Colección inheritablePermission | Define los ámbitos de una aplicación de recursos que se pueden conceder automáticamente a las identidades de agente sin consentimiento adicional. |
| owners | Colección directoryObject | Objetos de directorio que son propietarios de este plano técnico de identidad de agente. Los propietarios son un conjunto de usuarios no administradores o entidades de servicio autorizadas a modificar este objeto. Solo lectura. Admite valores NULL. Heredado de microsoft.graph.application |
| patrocinadores | Colección directoryObject | Los patrocinadores de este plano de identidad del agente. Los patrocinadores son usuarios o grupos que pueden autorizar y administrar el ciclo de vida de las instancias de identidad del agente. Necesario durante la operación de creación. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.agentIdentityBlueprint",
"id": "String (identifier)",
"appId": "String",
"identifierUris": ["String"],
"createdByAppId": "String",
"createdDateTime": "String (timestamp)",
"description": "String",
"disabledByMicrosoftStatus": "String",
"displayName": "String",
"groupMembershipClaims": "String",
"publisherDomain": "String",
"requiredResourceAccess": [{"@odata.type": "microsoft.graph.requiredResourceAccess"}],
"signInAudience": "String",
"tags": ["String"],
"tokenEncryptionKeyId": "Guid",
"uniqueName": "String",
"serviceManagementReference": "String",
"certification": {
"@odata.type": "microsoft.graph.certification"
},
"optionalClaims": {
"@odata.type": "microsoft.graph.optionalClaims"
},
"api": {
"@odata.type": "microsoft.graph.apiApplication"
},
"appRoles": [
{
"@odata.type": "microsoft.graph.appRole"
}
],
"info": {
"@odata.type": "microsoft.graph.informationalUrl"
},
"isDisabled": "Boolean",
"isSingleInstance": "Boolean",
"keyCredentials": [
{
"@odata.type": "microsoft.graph.keyCredential"
}
],
"managerApplications": ["Guid"],
"passwordCredentials": [
{
"@odata.type": "microsoft.graph.passwordCredential"
}
],
"verifiedPublisher": {
"@odata.type": "microsoft.graph.verifiedPublisher"
},
"web": {
"@odata.type": "microsoft.graph.webApplication"
}
}