EnvironmentCredential Clase

Definición

Espacio de nombres:

Azure.Identity

Ensamblado:

Azure.Identity.dll

Paquete:

Azure.Identity v1.11.1

Source:

EnvironmentCredential.cs

Permite la autenticación Microsoft Entra identificador mediante un secreto de cliente o certificado, o como usuario con un nombre de usuario y una contraseña.

La configuración se intenta en este orden mediante estas variables de entorno:

Entidad de servicio con secreto:

Variable	Descripción
AZURE_TENANT_ID	Identificador de inquilino (directorio) de Microsoft Entra.
AZURE_CLIENT_ID	Identificador de cliente (aplicación) de un registro de aplicación en el inquilino.
AZURE_CLIENT_SECRET	Secreto de cliente generado para el registro de aplicación.

Entidad de servicio con certificado:

Variable	Descripción
AZURE_TENANT_ID	Identificador de inquilino (directorio) de Microsoft Entra.
AZURE_CLIENT_ID	Identificador de cliente (aplicación) de un registro de aplicación en el inquilino.
AZURE_CLIENT_CERTIFICATE_PATH	Ruta al par de certificado y clave privada en formato PEM o PFX, que puede autenticar el registro de aplicación.
AZURE_CLIENT_CERTIFICATE_PASSWORD	(Opcional) Contraseña que protege el archivo de certificado (actualmente solo se admite para certificados PFX (PKCS12).
AZURE_CLIENT_SEND_CERTIFICATE_CHAIN	(Opcional) Especifica si una solicitud de autenticación incluirá un encabezado x5c para admitir la autenticación basada en el nombre del firmante o el emisor. Cuando se establece en "true" o "1", las solicitudes de autenticación incluyen el encabezado x5c.

Nombre de usuario y contraseña:

Variable	Descripción
AZURE_TENANT_ID	Identificador de inquilino (directorio) de Microsoft Entra.
AZURE_CLIENT_ID	Identificador de cliente (aplicación) de un registro de aplicación en el inquilino.
AZURE_USERNAME	Nombre de usuario, también conocido como upn, de una cuenta de usuario de Microsoft Entra.
AZURE_PASSWORD	Contraseña de la cuenta de usuario de Microsoft Entra. Tenga en cuenta que no se admiten cuentas con MFA habilitada.

En última instancia, esta credencial usa , ClientSecretCredentialClientCertificateCredentialo UsernamePasswordCredential para realizar la autenticación mediante estos detalles. Consulte la documentación de esa clase para obtener más detalles.

public class EnvironmentCredential : Azure.Core.TokenCredential

type EnvironmentCredential = class
    inherit TokenCredential

Public Class EnvironmentCredential
Inherits TokenCredential

Herencia

Object

TokenCredential

EnvironmentCredential

Constructores

EnvironmentCredential()	Crea una instancia de la clase EnvironmentCredential y lee los detalles del secreto de cliente de las variables de entorno. Si no se encuentran las variables de entorno esperadas en este momento, el método GetToken devolverá el valor predeterminado AccessToken cuando se invoque.
EnvironmentCredential(EnvironmentCredentialOptions)	Crea una instancia de la clase EnvironmentCredential y lee los detalles del secreto de cliente de las variables de entorno. Si no se encuentran las variables de entorno esperadas en este momento, el método GetToken devolverá el valor predeterminado AccessToken cuando se invoque.

Métodos

GetToken(TokenRequestContext, CancellationToken)

Obtiene un token del identificador de Microsoft Entra, utilizando los detalles de cliente especificados en las variables de entorno AZURE_TENANT_ID, AZURE_CLIENT_ID y AZURE_CLIENT_SECRET o AZURE_USERNAME y AZURE_PASSWORD para autenticarse. Los tokens adquiridos se almacenan en caché mediante la instancia de credencial. La duración del token y la actualización se controlan automáticamente. Siempre que sea posible, reutilice las instancias de credenciales para optimizar la eficacia de la memoria caché.

GetTokenAsync(TokenRequestContext, CancellationToken)

Obtiene un token del identificador de Microsoft Entra, utilizando los detalles de cliente especificados en las variables de entorno AZURE_TENANT_ID, AZURE_CLIENT_ID y AZURE_CLIENT_SECRET o AZURE_USERNAME y AZURE_PASSWORD para autenticarse. Los tokens adquiridos se almacenan en caché mediante la instancia de credencial. La duración del token y la actualización se controlan automáticamente. Siempre que sea posible, reutilice las instancias de credenciales para optimizar la eficacia de la memoria caché.