AcquireTokenInteractiveParameterBuilder Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Generador para una solicitud de token interactiva. Vea https://aka.ms/msal-net-acquire-token-interactively.
public sealed class AcquireTokenInteractiveParameterBuilder : Microsoft.Identity.Client.AbstractPublicClientAcquireTokenParameterBuilder<Microsoft.Identity.Client.AcquireTokenInteractiveParameterBuilder>type AcquireTokenInteractiveParameterBuilder = class
inherit AbstractPublicClientAcquireTokenParameterBuilder<AcquireTokenInteractiveParameterBuilder>Public NotInheritable Class AcquireTokenInteractiveParameterBuilder
Inherits AbstractPublicClientAcquireTokenParameterBuilder(Of AcquireTokenInteractiveParameterBuilder)- Herencia
-
AcquireTokenInteractiveParameterBuilder
Métodos
| Nombre | Description |
|---|---|
| ExecuteAsync() |
Ejecuta la solicitud de token de forma asincrónica. (Heredado de BaseAbstractAcquireTokenParameterBuilder<T>) |
| ExecuteAsync(CancellationToken) |
Ejecuta la solicitud de token de forma asincrónica, con la posibilidad de cancelar el método asincrónico. (Heredado de AbstractPublicClientAcquireTokenParameterBuilder<T>) |
| Validate() |
Valida los parámetros de la operación AcquireToken. (Heredado de BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithAccount(IAccount) |
Establece la cuenta para la que se recuperará el token. Este método es mutuamente excluyente con WithLoginHint(String). Si se usan ambos, se producirá una excepción. |
| WithAdfsAuthority(String, Boolean) |
Agrega una entidad conocida correspondiente a un servidor ADFS. Consulte https://aka.ms/msal-net-adfs. (Heredado de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AadAuthorityAudience, Boolean) |
Obsoletos.
Importante: Use WithTenantId o WithTenantIdFromAuthority en su lugar, o WithB2CAuthority para las autoridades B2C. Agrega una entidad de Azure AD conocida a la aplicación para iniciar sesión a los usuarios que especifican el público de inicio de sesión (la nube es la nube Azure nube pública). Consulte https://aka.ms/msal-net-application-configuration. (Heredado de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean) |
Obsoletos.
Agrega una entidad de Azure AD conocida a la aplicación para iniciar sesión a los usuarios que especifican la instancia de nube y la audiencia de inicio de sesión. Consulte https://aka.ms/msal-net-application-configuration. (Heredado de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, Guid, Boolean) |
Obsoletos.
Importante: Use WithTenantId o WithTenantIdFromAuthority en su lugar, o WithB2CAuthority para las autoridades B2C. Agrega una entidad de Azure AD conocida a la aplicación a los usuarios de inicio de sesión desde una sola organización (aplicación de inquilino único) descrita por su instancia de nube y su identificador de inquilino. Consulte https://aka.ms/msal-net-application-configuration. (Heredado de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, String, Boolean) |
Obsoletos.
Importante: Use WithTenantId o WithTenantIdFromAuthority en su lugar, o WithB2CAuthority para las autoridades B2C. Agrega una entidad de Azure AD conocida a la aplicación a los usuarios de inicio de sesión desde una sola organización (aplicación de inquilino único) descrita por su instancia de nube y su nombre de dominio o identificador de inquilino. Consulte https://aka.ms/msal-net-application-configuration. (Heredado de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Boolean) |
Obsoletos.
Importante: Use WithTenantId o WithTenantIdFromAuthority en su lugar, o WithB2CAuthority para las autoridades B2C. Autoridad específica para la que se solicita el token. Pasar un valor diferente al configurado en el constructor de la aplicación limita la selección a un inquilino específico. Esto no cambia el valor configurado en la aplicación. Esto es específico de las aplicaciones que administran varias cuentas (como un cliente de correo con varios buzones). Consulte https://aka.ms/msal-net-application-configuration. (Heredado de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Guid, Boolean) |
Obsoletos.
Importante: Use WithTenantId o WithTenantIdFromAuthority en su lugar, o WithB2CAuthority para las autoridades B2C. Agrega una entidad de Azure AD conocida a la aplicación para iniciar sesión a los usuarios de una sola organización (aplicación de inquilino único) especificada por su identificador de inquilino. Consulte https://aka.ms/msal-net-application-configuration. (Heredado de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, String, Boolean) |
Obsoletos.
Importante: Use WithTenantId o WithTenantIdFromAuthority en su lugar, o WithB2CAuthority para las autoridades B2C. Agrega una entidad de Azure AD conocida a la aplicación a los usuarios de inicio de sesión desde una sola organización (aplicación de inquilino único) descrita por su nombre de dominio. Consulte https://aka.ms/msal-net-application-configuration. (Heredado de AbstractAcquireTokenParameterBuilder<T>) |
| WithB2CAuthority(String) |
Agrega una autoridad conocida correspondiente a una directiva de Azure AD B2C. Vea https://aka.ms/msal-net-b2c-specificities. (Heredado de AbstractAcquireTokenParameterBuilder<T>) |
| WithClaims(String) |
Establece notificaciones en la consulta. Úselo cuando el administrador de AAD haya habilitado el acceso condicional. La adquisición del token normalmente dará como resultado un MsalUiRequiredException elemento con el conjunto de Claims propiedades. Vuelva a intentar la adquisición del token y use este valor en el WithClaims(String) método . Consulte https://aka.ms/msal-exceptions para obtener más información, así como https://aka.ms/msal-net-claim-challenge. (Heredado de AbstractAcquireTokenParameterBuilder<T>) |
| WithCorrelationId(Guid) |
Establece el identificador de correlación que se usará en la solicitud de autenticación. Se usa para realizar un seguimiento de una solicitud en los registros del SDK y del servicio proveedor de identidades. Si no se establece, se generará uno aleatorio. (Heredado de BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithEmbeddedWebViewOptions(EmbeddedWebViewOptions) |
Especifica las opciones para usar la vista web insertada para la autenticación interactiva. |
| WithExtraQueryParameters(Dictionary<String,String>) |
Obsoletos.
Establece parámetros de consulta adicionales para la cadena de consulta en la solicitud de autenticación HTTP. (Heredado de BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>) |
Establece parámetros de consulta adicionales para la cadena de consulta en la solicitud de autenticación HTTP con control sobre qué parámetros se incluyen en la clave de caché. (Heredado de BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(String) |
Obsoletos.
Establece parámetros de consulta adicionales para la cadena de consulta en la solicitud de autenticación HTTP. (Heredado de AbstractAcquireTokenParameterBuilder<T>) |
| WithExtraScopesToConsent(IEnumerable<String>) |
Generador para una solicitud de token interactiva. Vea https://aka.ms/msal-net-acquire-token-interactively. |
| WithLoginHint(String) |
Establece , |
| WithParentActivityOrWindow(IntPtr) |
Establece una referencia a IntPtr en una ventana que desencadena el explorador que se va a mostrar. Se usa para centrar el explorador que aparece en esta ventana. Centro de la pantalla o la aplicación en primer plano si se configura un valor. |
| WithParentActivityOrWindow(Object) |
Establece una referencia a ViewController (si usa iOS), Activity (si usa Android) IWin32Window o IntPtr (si usa .Net Framework). Se usa para invocar el explorador. |
| WithPrompt(Prompt) |
Especifica cuál es la experiencia interactiva para el usuario. |
| WithProofOfPossession(String, HttpMethod, Uri) |
Modifica la solicitud de adquisición de tokens para que el token adquirido sea un token de prueba de posesión (PoP), en lugar de un token de portador. Los tokens poP son similares a los tokens de portador, pero están enlazados a la solicitud HTTP y a una clave criptográfica, que MSAL puede administrar en Windows. Tenga en cuenta que solo se enlazarán las partes de host y ruta de acceso del URI de solicitud. Vea https://aka.ms/msal-net-pop. |
| WithScopes(IEnumerable<String>) |
Especifica qué ámbitos se van a solicitar. Este método se usa cuando la aplicación necesita especificar los ámbitos necesarios para llamar a una API protegida. Consulte <o>https://docs.microsoft.com/azure/active-directory/develop/v2-permissions-and-consent< vea> para obtener más información sobre ámbitos, permisos y consentimiento, y <consulte>https://docs.microsoft.com/azure/active-directory/develop/msal-v1-app-scopes< o vea> para obtener información sobre cómo crear ámbitos para aplicaciones heredadas que se usan para exponer permisos de OAuth2. (Heredado de AbstractAcquireTokenParameterBuilder<T>) |
| WithSystemWebViewOptions(SystemWebViewOptions) |
Especifica opciones para usar el explorador del sistema operativo del sistema operativo controlar la autenticación interactiva. |
| WithTenantId(String) |
Invalida el identificador de inquilino especificado en la entidad en el nivel de aplicación. Esta operación conserva el host de autoridad (entorno). Si no se especificó una entidad en el nivel de aplicación, el valor predeterminado usado es |
| WithTenantIdFromAuthority(Uri) |
Extrae el identificador de inquilino del URI de autoridad proporcionado e invalida el identificador de inquilino especificado en la entidad en el nivel de aplicación. Esta operación conserva el host de autoridad (entorno) proporcionado al generador de aplicaciones.
Si no se proporcionó una entidad al generador de aplicaciones, este método reemplazará el identificador de inquilino en la entidad predeterminada: |
| WithUseEmbeddedWebView(Boolean) |
Especifica si la aplicación cliente pública debe usar un explorador web incrustado o el explorador predeterminado del sistema. Si el agente (WAM, Authenticator, Portal de empresa) está configurado, esta configuración solo se usa cuando el agente no está instalado. En .NET, incluidos net8-windows, los desarrolladores de aplicaciones deben hacer referencia a Microsoft. Identity.Client.Desktop y llame a PublicClientApplicationBuilder.WithDesktopFeatures() para habilitar el explorador web incrustado. |
Métodos de extensión
| Nombre | Description |
|---|---|
| OnBeforeTokenRequest<T>(AbstractAcquireTokenParameterBuilder<T>, Func<OnBeforeTokenRequestData,Task>) |
Interviene en la canalización de solicitudes mediante la ejecución de un delegado proporcionado por el usuario antes de que MSAL realice la solicitud de token. El delegado puede modificar la carga de la solicitud agregando o quitando parámetros y encabezados del cuerpo. OnBeforeTokenRequestData |
| WithAdditionalCacheParameters<T>(AbstractAcquireTokenParameterBuilder<T>, IEnumerable<String>) |
Especifica parámetros adicionales adquiridos a partir de las respuestas de autenticación que se almacenarán en caché con el token de acceso que normalmente no se incluyen en el objeto de caché. estos valores se pueden leer desde el AdditionalResponseParameters parámetro . |
| WithAuthenticationExtension<T>(AbstractAcquireTokenParameterBuilder<T>, MsalAuthenticationExtension) |
Permite a las aplicaciones cliente proporcionar una operación de autenticación personalizada que se usará en la solicitud de adquisición de tokens. |
| WithCachePartitionKey<T>(BaseAbstractAcquireTokenParameterBuilder<T>, String, String) |
Agrega un par clave-valor a la clave de caché de tokens sin enviarlo como parámetro de consulta.
Úselo para crear particiones de tokens almacenados en caché (por ejemplo, aislar sesiones de corta duración de sesiones regulares para el mismo usuario). Tanto como |
| WithCustomWebUi(AcquireTokenInteractiveParameterBuilder, ICustomWebUi) |
Método de extensión que habilita MSAL.NET extensores para aplicaciones cliente públicas para establecer una interfaz de usuario web personalizada que permita al usuario iniciar sesión con Azure AD, presentar el consentimiento si es necesario y recuperar el código de autorización. |
| WithExtraClientAssertionClaims<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
Especifica notificaciones adicionales que se incluirán en la aserción de cliente. Estas notificaciones se combinarán con notificaciones predeterminadas cuando se genere la aserción de cliente. Esto permite que las API de nivel superior, como Microsoft. Identity.Web proporciona notificaciones adicionales para la aserción de cliente. Importante: los tokens están asociados a las notificaciones de aserción de cliente adicionales, lo que afecta a las búsquedas de caché. Se trata de una API de extensibilidad y no se debe usar directamente en las aplicaciones. |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
Obsoletos.
Agrega encabezados HTTP adicionales a la solicitud de token. |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
Agrega encabezados HTTP adicionales a la solicitud de token. |
| WithFmiPathForClientAssertion<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
Especifica una ruta de acceso fmi que se usará para la aserción del cliente. Esto permite que las API de nivel superior, como Id.Web, proporcionen credenciales que distinguen FMI. Importante: los tokens están asociados a la ruta de acceso fmi de credenciales, que afecta a las búsquedas de caché Esta es una API de extensibilidad y las aplicaciones no deben usarse. |
| WithProofOfPosessionKeyId<T>(AbstractAcquireTokenParameterBuilder<T>, String, String) |
Enlaza el token a una clave de la memoria caché. No se realiza ninguna operación criptográfica en el token. |
| WithSSHCertificateAuthenticationScheme(AcquireTokenInteractiveParameterBuilder, String, String) |
Indica a AAD que devuelva un certificado SSH en lugar de un token de portador. El certificado SSH (no igual que el par de claves pública y privada que usa SSH), se puede usar para implementar de forma segura una clave SSH pública en una máquina. Consulte https://aka.ms/msal-net-ssh para obtener más información. |