Tipo de recurso federatedIdentityCredential

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.

Hace referencia a las credenciales de identidad federada para una aplicación o agentIdentityBlueprint. Estas credenciales de identidad federada se usan en la federación de identidades de carga de trabajo al intercambiar un token de un emisor de confianza por un token de acceso vinculado a una aplicación o a un plano técnico de identidad de agente.

Hereda de la entidad.

Methods

Método Tipo devuelto Descripción
List Colección federatedIdentityCredential Obtener una lista de los objetos federatedIdentityCredential y sus propiedades.
Crear federatedIdentityCredential Cree un nuevo objeto federatedIdentityCredential .
Get federatedIdentityCredential Lea las propiedades y relaciones de un objeto federatedIdentityCredential .
Actualizar Ninguno Actualizar las propiedades de un objeto federatedIdentityCredential .
Upsert federatedIdentityCredential Cree una nueva federatedIdentityCredential si no existe, o actualice las propiedades de un objeto federatedIdentityCredential existente.
Delete Ninguno Eliminar un objeto federatedIdentityCredential .

Propiedades

Propiedad Tipo Descripción
Públicos Colección string El público que puede aparecer en el token externo. Este campo es obligatorio y debe establecerse en api://AzureADTokenExchange para Microsoft Entra ID. Indica lo que la Plataforma de identidad de Microsoft debe aceptar en la aud notificación del token entrante. Este valor representa el Microsoft Entra ID en su proveedor de identidad externo y no tiene ningún valor fijo en todos los proveedores de identidades. Es posible que deba crear un nuevo registro de aplicación en su proveedor de identidad para que sirva como audiencia de este token. Este campo solo puede aceptar un único valor y tiene un límite de 600 caracteres. Obligatorio.
claimsMatchingExpression federatedIdentityExpression Admite valores NULL. El valor predeterminado es null si no se establece. Permite el uso de expresiones que coincidan con notificaciones específicas. Si se define claimsMatchingExpression , subject debe ser null. Para obtener una lista de notificaciones y sintaxis de expresiones admitidas, visite la referencia de FIC flexible.
description Cadena La descripción no validada proporcionada por el usuario de la credencial de identidad federada. Tiene un límite de 600 caracteres. Opcional.
id Cadena El identificador único de la identidad federada. Obligatorio. Solo lectura.
emisor Cadena La dirección URL del proveedor de identidad externo y debe coincidir con la issuer notificación del token externo que se intercambia. La combinación de los valores de emisor y asunto debe ser única en la aplicación. Tiene un límite de 600 caracteres. Obligatorio.
name Cadena El identificador único de la credencial de identidad federada, que tiene un límite de 120 caracteres y debe ser compatible con la dirección URL. Es inmutable una vez creado. Tecla alternativa. Necesario. No admite valores NULL. Admite $filter (eq).
subject Cadena Admite valores NULL. El valor predeterminado es null si no se establece. El identificador de la carga de trabajo de software externo dentro del proveedor de identidad externo. Al igual que el valor de audiencia, no tiene un formato fijo, ya que cada proveedor de identidades usa el suyo propio: a veces un GUID, a veces un identificador delimitado por dos puntos, a veces cadenas arbitrarias. El valor aquí debe coincidir con la sub notificación dentro del token presentado a Microsoft Entra ID. La combinación de emisor y sujeto debe ser única en la aplicación. Tiene un límite de 600 caracteres. Si se define subject , claimsMatchingExpression debe ser null. Admite $filter (eq).

Relaciones

Ninguno

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.federatedIdentityCredential",
  "id": "String (identifier)",
  "name": "String",
  "issuer": "String",
  "subject": "String",
  "description": "String",
  "audiences": [
    "String"
  ],
  "claimsMatchingExpression": {
    "@odata.type": "microsoft.graph.federatedIdentityExpression"
  }
}