GetAuthorizationRequestUrlParameterBuilder 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í.
NOTA: Algunos de los métodos de AbstractAcquireTokenParameterBuilder (por ejemplo, cuenta) no tienen sentido aquí. ¿Deseamos crear una base adicional que contenga TODOS los métodos comunes y, a continuación, tener otra cuenta incluida, etc., que solo se usen para AcquireToken?
public sealed class GetAuthorizationRequestUrlParameterBuilder : Microsoft.Identity.Client.AbstractConfidentialClientAcquireTokenParameterBuilder<Microsoft.Identity.Client.GetAuthorizationRequestUrlParameterBuilder>
type GetAuthorizationRequestUrlParameterBuilder = class
inherit AbstractConfidentialClientAcquireTokenParameterBuilder<GetAuthorizationRequestUrlParameterBuilder>
Public NotInheritable Class GetAuthorizationRequestUrlParameterBuilder
Inherits AbstractConfidentialClientAcquireTokenParameterBuilder(Of GetAuthorizationRequestUrlParameterBuilder)
- Herencia
-
GetAuthorizationRequestUrlParameterBuilder
Métodos
| Nombre | Description |
|---|---|
| ExecuteAsync() |
NOTA: Algunos de los métodos de AbstractAcquireTokenParameterBuilder (por ejemplo, cuenta) no tienen sentido aquí. ¿Deseamos crear una base adicional que contenga TODOS los métodos comunes y, a continuación, tener otra cuenta incluida, etc., que solo se usen para AcquireToken? |
| ExecuteAsync(CancellationToken) |
NOTA: Algunos de los métodos de AbstractAcquireTokenParameterBuilder (por ejemplo, cuenta) no tienen sentido aquí. ¿Deseamos crear una base adicional que contenga TODOS los métodos comunes y, a continuación, tener otra cuenta incluida, etc., que solo se usen para AcquireToken? |
| Validate() |
Valida los parámetros de la operación AcquireToken. (Heredado de AbstractConfidentialClientAcquireTokenParameterBuilder<T>) |
| WithAccount(IAccount) |
NOTA: Algunos de los métodos de AbstractAcquireTokenParameterBuilder (por ejemplo, cuenta) no tienen sentido aquí. ¿Deseamos crear una base adicional que contenga TODOS los métodos comunes y, a continuación, tener otra cuenta incluida, etc., que solo se usen para AcquireToken? |
| 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>) |
| WithCcsRoutingHint(String, String) |
Para ayudar con la resistencia, el sistema de autenticación de copia de seguridad de AAD funciona como una copia de seguridad de AAD. Esto proporcionará al sistema de autenticación de copia de seguridad de AAD una sugerencia de enrutamiento para ayudar a mejorar el rendimiento durante la autenticación. La sugerencia creada con esta API tendrá prioridad sobre la creada con WithLoginHint(String) |
| 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>) |
| 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>) |
NOTA: Algunos de los métodos de AbstractAcquireTokenParameterBuilder (por ejemplo, cuenta) no tienen sentido aquí. ¿Deseamos crear una base adicional que contenga TODOS los métodos comunes y, a continuación, tener otra cuenta incluida, etc., que solo se usen para AcquireToken? |
| WithLoginHint(String) |
NOTA: Algunos de los métodos de AbstractAcquireTokenParameterBuilder (por ejemplo, cuenta) no tienen sentido aquí. ¿Deseamos crear una base adicional que contenga TODOS los métodos comunes y, a continuación, tener otra cuenta incluida, etc., que solo se usen para AcquireToken? |
| WithPkce(String) |
Se usa para proteger la concesión de código de autorización mediante proof of key for Code Exchange (PKCE). Para obtener más información, consulte PKCE RCF: https://tools.ietf.org/html/rfc7636 |
| WithPrompt(Prompt) |
Especifica la experiencia interactiva para el usuario. |
| WithProofOfPossession(PoPAuthenticationConfiguration) |
Obsoletos.
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. Vea https://aka.ms/msal-net-pop. (Heredado de AbstractConfidentialClientAcquireTokenParameterBuilder<T>) |
| WithRedirectUri(String) |
Establece el URI de redireccionamiento que se va a agregar a la dirección URL de solicitud de autorización. |
| 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>) |
| WithSignedHttpRequestProofOfPossession(PoPAuthenticationConfiguration) |
Modifica la solicitud para adquirir un token de prueba de posesión (PoP) de solicitud HTTP firmada( SHR), en lugar de un portador. Los tokens poP de SHR se enlazan a la solicitud HTTP y a una clave criptográfica, que MSAL administra en Windows. Los tokens poP de SHR son diferentes de los tokens poP de mTLS, que se usan para la autenticación mutua de TLS (mTLS). Consulte https://aka.ms/mtls-pop para obtener más información. (Heredado de AbstractConfidentialClientAcquireTokenParameterBuilder<T>) |
| 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: |
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 . |
| WithAttributeTokens<T>(AbstractConfidentialClientAcquireTokenParameterBuilder<T>, IEnumerable<String>) |
Envía |
| 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 |
| WithClaimsFromClient<T>(AbstractConfidentialClientAcquireTokenParameterBuilder<T>, String) |
Especifica las notificaciones originadas por el cliente que se incluirán en la solicitud de token. A diferencia WithClaims(String) de (para los desafíos de notificaciones emitidos por el servidor), los tokens adquiridos con notificaciones de cliente se almacenan en caché y la entrada de caché se clave en el valor de notificaciones. Los distintos valores de notificaciones generan entradas de caché independientes. Use valores estables y no dinámicos para evitar el crecimiento de la memoria caché sin enlazar. |
| WithExtraBodyParameters<T>(AbstractConfidentialClientAcquireTokenParameterBuilder<T>, Dictionary<String,Func<CancellationToken,Task<String>>>) |
Agregue parámetros de cuerpo adicionales a la solicitud de token. Estos parámetros se agregan a la clave de caché para asociar estos parámetros al token adquirido. Funciona para flujos de cliente confidenciales (AcquireTokenForClient, AcquireTokenOnBehalfOf, AcquireTokenByAuthorizationCode). |
| 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. |