Actualizar un cliente por ID
Actualiza la configuración de un cliente. Para obtener más información, consulte Applications in Auth0 y inicio de sesión único.
Notas:
- Los atributos
client_secretysigning_keysolo pueden actualizarse con el alcanceupdate:client_keys. - Las propiedades
client_authentication_methodsytoken_endpoint_auth_methodson mutuamente excluyentes. Useclient_authentication_methodspara configurar el cliente con el método de autenticación Private Key JWT. En caso contrario, usetoken_endpoint_auth_methodpara configurar el cliente con client secret (basic o post) o sin método de autenticación (none). - Al usar
client_authentication_methodspara configurar el cliente con el método de autenticación Private Key JWT, especifique solo los ID de credencial generados al crear las credenciales en el cliente. - Para configurar
client_authentication_methods, se requiere el alcanceupdate:client_credentials. - Para configurar
client_authentication_methods, la propiedadjwt_configuration.algdebe establecerse en RS256. - Para cambiar la propiedad
is_first_partyde un cliente afalse, deben desestablecerse las propiedadesorganization_usageyorganization_require_behavior.
Autorizaciones
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Parámetros de ruta
ID del cliente que se va a actualizar.
Cuerpo
Complementos habilitados para este cliente y sus configuraciones asociadas.
Ids de los clientes a los que se les permitirá realizar solicitudes de delegación. De manera predeterminada, se permitirá a todos sus clientes. Este campo le permite especificar clientes concretos.
1URL válidas a las que redirigir después de cerrar sesión en Auth0
Conjunto de URL que representa orígenes válidos para CORS
El tipo de aplicación que representa este cliente
native, spa, regular_web, non_interactive, resource_server, express_configuration, rms, box, cloudbees, concur, dropbox, mscrm, echosign, egnyte, newrelic, office365, salesforce, sentry, sharepoint, slack, springcm, zendesk, zoom, sso_integration, oag Lista de canales de notificación para contactar con el usuario cuando se requiere su aprobación. Los valores válidos son guardian-push, email.
1guardian-push, email Conjunto de URL válidas de devolución de llamada desde Auth0 al autenticar usuarios
Lista de audiencias para el protocolo SAML
1Define los métodos de autenticación del cliente.
Metadatos asociados al cliente, en forma de objeto con valores de cadena (máx. 255 caracteres). Se permite un máximo de 10 propiedades de metadatos. Los nombres de campo (máx. 255 caracteres) son alfanuméricos y solo pueden incluir los siguientes caracteres especiales: :,-+=_*?"/\()<>@\t[Tab] [Space]
El Secret usado para firmar tokens para el cliente
1Define el nivel de cumplimiento de este cliente, que puede restringir sus capacidades.
none, fapi1_adv_pkj_par, fapi1_adv_mtls_par, fapi2_sp_pkj_mtls, fapi2_sp_mtls_mtls, null true si este cliente puede usarse para realizar solicitudes de autenticación entre orígenes; false en caso contrario, si la autenticación entre orígenes está deshabilitada
URL de la ubicación en su sitio donde se realiza la verificación entre orígenes para el flujo de autenticación entre orígenes al realizar la autenticación en su propio dominio en lugar de la hosted login page de Auth0.
El contenido (HTML, CSS, JS) de la página de Login personalizada
true si se debe usar la página de Login personalizada; false en caso contrario.
Define el ID de Organización predeterminado y los flujos.
Descripción en texto libre del propósito del cliente. (Longitud máxima: 140 caracteres)
140La clave de cifrado del cliente
Configuración específica de la aplicación para usar con la función Express Configuration de OIN.
Configure la configuración de inicio de sesión de FedCM para New Universal Login
Plantilla de formulario para el protocolo WS-Federation
Conjunto de tipos de concesión que el cliente está autorizado a usar. Puede incluir authorization_code, implicit, refresh_token, client_credentials, password, http://auth0.com/oauth/grant-type/password-realm, http://auth0.com/oauth/grant-type/mfa-oob, http://auth0.com/oauth/grant-type/mfa-otp, http://auth0.com/oauth/grant-type/mfa-recovery-code, urn:openid:params:grant-type:ciba, urn:ietf:params:oauth:grant-type:device_code y urn:auth0:params:oauth:grant-type:token-exchange:federated-connection-access-token.
1URI para iniciar sesión; debe ser https
Indica si este cliente es de primera parte o no
Si es true, confíe en que la IP especificada en el encabezado auth0-forwarded-for es la IP del usuario final para la protección contra fuerza bruta en el token endpoint.
Objeto que contiene la configuración relacionada con cómo se crean los JWT
La URL del logotipo del cliente (tamaño recomendado: 150 x 150)
Configuración relacionada con las aplicaciones móviles nativas
Configuración relacionada con My Organization Configuration para el cliente.
El nombre del cliente. Debe contener al menos un carácter. No se permiten '<' ni '>'.
^[^<>]+$Configurar los ajustes de inicio de sesión social nativo
Configuración del logout por canal secundario de OIDC (obsoleto; se recomienda usar oidc_logout)
Indica si este cliente cumplirá estrictamente con las especificaciones de OIDC
Configuración del logout por canal secundario de OIDC
Define los métodos disponibles para detectar la organización durante pre_login_prompt. Los usuarios pueden detectar su organización mediante email, organization_name o ambos.
1Método para detectar organizaciones durante pre_login_prompt. email permite a los usuarios encontrar su organización introduciendo su dirección de correo electrónico y realizando una coincidencia de dominio, mientras que organization_name requiere que los usuarios introduzcan directamente el nombre de la organización. Estos métodos pueden combinarse.
email, organization_name Define cómo proceder durante una transacción de autenticación cuando client.organization_usage: 'require'. Puede ser no_prompt (predeterminado), pre_login_prompt o post_login_prompt. post_login_prompt requiere oidc_conformant: true.
no_prompt, pre_login_prompt, post_login_prompt, null Define cómo proceder durante una transacción de autenticación con respecto a una organización. Puede ser deny (predeterminado), allow o require.
deny, allow, require, null Especifica cuánto tiempo, en segundos, sigue siendo válido un URI de Pushed Authorization Request
10 <= x <= 600Controla si Auth0 redirige a los usuarios a la URL de devolución de llamada de la aplicación cuando se producen errores de autenticación o en flujos de verificación de correo electrónico. open_redirect_protection muestra una página de error en lugar de redirigir y oculta el dominio de devolución de llamada en las plantillas de correo electrónico. allow_always habilita el comportamiento de redirección estándar. El valor predeterminado es open_redirect_protection para clientes de terceros. Solo se aplica cuando is_first_party es false y third_party_security_mode es strict. Para obtener más información, consulta Protección de redirección.
allow_always, open_redirect_protection Configuración del token de actualización
Hace obligatorio el uso de Proof-of-Possession para este cliente
Hace obligatorio el uso de Pushed Authorization Requests para este cliente
Configuración de SSO de nativo a web
Configuración de solicitudes de autorización protegidas con JWT (JAR).
Controla si se muestra una pantalla de confirmación durante los flujos de Login cuando el Redirect URI usa URL de devolución de llamada no verificables (por ejemplo, un esquema de URI personalizado como myapp:// o localhost).
Si se establece en true, no se mostrará ninguna pantalla de confirmación. Recomendamos establecerlo en false para mejorar la protección frente a aplicaciones maliciosas.
Consulta https://auth0.com/docs/secure/security-guidance/measures-against-app-impersonation para obtener más información.
true para usar Auth0 en lugar del IdP para realizar el inicio de sesión único; false en caso contrario (valor predeterminado: false)
true para deshabilitar el inicio de sesión único; false en caso contrario (valor predeterminado: false)
Modo de seguridad para clientes de terceros. strict aplica controles de seguridad mejorados: alineación con OAuth 2.1, autorización explícita de API y un conjunto seleccionado de funcionalidades compatibles. permissive conserva el comportamiento preexistente y solo está disponible para inquilinos con uso previo de clientes de terceros. Se establece al crearlo y no puede modificarse.
strict, permissive Define el método de autenticación solicitado para el endpoint de token. Puede ser none (cliente público sin secreto de cliente), client_secret_post (el cliente usa parámetros HTTP POST) o client_secret_basic (el cliente usa HTTP Basic).
none, client_secret_post, client_secret_basic, null Configuración para el intercambio de tokens.
Conjunto de URL que representa orígenes web válidos para usar con el modo de respuesta web_message
Respuesta
Cliente actualizado correctamente.
Complementos habilitados para este cliente y sus configuraciones asociadas.
Lista de clientes e id de API permitidos para realizar solicitudes de delegation. Si está vacía, significa que todos tus clientes están permitidos.
Lista de URL separadas por comas válidas para redirigir después del Logout de Auth0. Se permiten comodines para subdominios.
Lista de URL separadas por comas desde las que se permite hacer solicitudes de JavaScript a la API de Auth0 (normalmente se usa con CORS). De forma predeterminada, se permitirán todas tus URL de devolución de llamada. Este campo te permite introducir otros orígenes si es necesario. También puedes usar comodines en el nivel de subdominio (por ejemplo, https://*.contoso.com). Las cadenas de consulta y la información de hash no se tienen en cuenta al validar estas URL.
El tipo de aplicación que representa este cliente
native, spa, regular_web, non_interactive, resource_server, express_configuration, rms, box, cloudbees, concur, dropbox, mscrm, echosign, egnyte, newrelic, office365, salesforce, sentry, sharepoint, slack, springcm, zendesk, zoom, sso_integration, oag Lista de canales de notificación para contactar con el usuario cuando se requiere su aprobación. Los valores válidos son guardian-push, email.
1guardian-push, email Lista de URL separadas por comas incluidas en la lista de permitidas para que Auth0 las use como callback al cliente después de la autenticación.
Lista de audiencias/realm para el protocolo SAML. La utiliza el addon wsfed.
Define los métodos de autenticación del cliente.
ID de este cliente.
Metadatos asociados al cliente, en forma de objeto con valores de cadena (máx. 255 caracteres). Se permite un máximo de 10 propiedades de metadatos. Los nombres de campo (máx. 255 caracteres) son alfanuméricos y solo pueden incluir los siguientes caracteres especiales: :,-+=_*?"/\()<>@\t[Tab] [Space]
Secreto del cliente (que no debes hacer público).
Define el nivel de cumplimiento de este cliente, que puede restringir sus capacidades.
none, fapi1_adv_pkj_par, fapi1_adv_mtls_par, fapi2_sp_pkj_mtls, fapi2_sp_mtls_mtls, null Indica si este cliente puede usarse para realizar solicitudes de autenticación entre orígenes (true) o si no tiene permitido realizar dichas solicitudes (false).
URL de la ubicación en tu sitio donde se realiza la verificación entre orígenes para el flujo de autenticación entre orígenes al realizar la autenticación en tu propio dominio en lugar de la hosted login page de Auth0.
El contenido (HTML, CSS, JS) de la página de Login personalizada.
Indica si se debe usar una página de Login personalizada (true) o la página de Login predeterminada (false).
El contenido (HTML, CSS, JS) de la página de Login personalizada. (Se usa en las vistas previas)
Define el ID de Organización predeterminado y los flujos.
Descripción de texto libre de este cliente (longitud máxima: 140 caracteres).
Cifrado usado para las respuestas de WsFed con este cliente.
Configuración específica de la aplicación para usar con la función Express Configuration de OIN.
Un identificador de cliente alternativo para usar durante los flujos de autorización. Solo admite identificadores de cliente basados en CIMD.
Indica quién creó el cliente de metadatos externos. El valor admin indica que el cliente se registró mediante la Management API. El valor client indica que el cliente se registró dinámicamente. Este campo solo está presente cuando se establece external_metadata_type.
admin, client Indica el tipo de metadatos externos usados para registrar el cliente. Este campo se omite para los clientes normales. El valor cimd identifica a los clientes registrados mediante un documento de metadatos de ID de cliente. El valor dcr identifica a los clientes registrados mediante Dynamic Client Registration.
cimd, dcr Plantilla de formulario HTML que se usará para WS-Federation.
Indica si este es tu cliente global "All Applications", que representa la configuración heredada del inquilino (true), o un cliente normal (false).
Lista de tipos de concesión admitidos para esta aplicación. Puede incluir authorization_code, implicit, refresh_token, client_credentials, password, http://auth0.com/oauth/grant-type/password-realm, http://auth0.com/oauth/grant-type/mfa-oob, http://auth0.com/oauth/grant-type/mfa-otp, http://auth0.com/oauth/grant-type/mfa-recovery-code, urn:openid:params:grant-type:ciba, urn:ietf:params:oauth:grant-type:device_code y urn:auth0:params:oauth:grant-type:token-exchange:federated-connection-access-token.
URI de inicio de Login; debe usar https
Indica si este cliente es un cliente de primera parte (true) o no (false).
Si es true, se confiará en que la IP especificada en el encabezado auth0-forwarded-for es la IP del usuario final para la protección contra fuerza bruta en el token endpoint.
URL del conjunto de claves web JSON (JWKS) que contiene las claves públicas utilizadas para la autenticación private_key_jwt. Solo está presente en clientes CIMD que usan autenticación private_key_jwt.
Configuración relacionada con los JWT del cliente.
URL del logotipo que se mostrará para este cliente. El tamaño recomendado es de 150x150 píxeles.
Configuración adicional para aplicaciones móviles nativas.
Configuración relacionada con My Organization Configuration para el cliente.
Nombre de este cliente (longitud mínima: 1 carácter; no permite < ni >).
Indica si este cliente cumple con las especificaciones estrictas de OIDC (true) o usa funcionalidades heredadas (false).
Configuración del logout por canal secundario de OIDC
Define los métodos disponibles para el descubrimiento de organizaciones durante pre_login_prompt. Los usuarios pueden descubrir su organización mediante email, organization_name o ambos.
1Método para detectar organizaciones durante pre_login_prompt. email permite a los usuarios encontrar su organización introduciendo su dirección de correo electrónico y realizando una coincidencia de dominio, mientras que organization_name requiere que los usuarios introduzcan directamente el nombre de la organización. Estos métodos pueden combinarse.
email, organization_name Define cómo proceder durante una transacción de autenticación cuando client.organization_usage: 'require'. Puede ser no_prompt (predeterminado), pre_login_prompt o post_login_prompt. post_login_prompt requiere oidc_conformant: true.
no_prompt, pre_login_prompt, post_login_prompt Define cómo proceder durante una transacción de autenticación con respecto a una organización. Puede ser deny (predeterminado), allow o require.
deny, allow, require Especifica durante cuánto tiempo, en segundos, sigue siendo válido un URI de Pushed Authorization Request
10 <= x <= 600Controla si Auth0 redirige a los usuarios a la URL de devolución de llamada de la aplicación cuando se producen errores de autenticación o en flujos de verificación de correo electrónico. open_redirect_protection muestra una página de error en lugar de redirigir y oculta el dominio de devolución de llamada en las plantillas de correo electrónico. allow_always habilita el comportamiento de redirección estándar. El valor predeterminado es open_redirect_protection para clientes de terceros. Solo se aplica cuando is_first_party es false y third_party_security_mode es strict. Para obtener más información, consulta Protección de redirección.
allow_always, open_redirect_protection Configuración del token de actualización
Hace obligatorio el uso de Proof-of-Possession para este cliente
Hace obligatorio el uso de Pushed Authorization Requests para este cliente
El identificador del servidor de recursos al que está vinculado este cliente.
Configuración de SSO de nativo a web
Configuración de solicitudes de autorización protegidas con JWT (JAR).
Certificados de firma asociados a este cliente.
Controla si se muestra un mensaje de confirmación durante los flujos de inicio de sesión cuando el Redirect URI usa URI de callback no verificables (por ejemplo, un esquema de URI personalizado como myapp:// o localhost).
Si se establece en true, no se mostrará ningún mensaje de confirmación. Recomendamos establecerlo en false para mejorar la protección frente a aplicaciones maliciosas.
Consulte https://auth0.com/docs/secure/security-guidance/measures-against-app-impersonation para obtener más información.
Se aplica solo a clientes SSO y determina si Auth0 gestionará el Single Sign On (true) o si lo hará el Proveedor de identidad (false).
Indica si Single Sign On está deshabilitado (true) o habilitado (false). El valor predeterminado es true.
Nombre del inquilino al que pertenece este cliente.
Modo de seguridad para clientes de terceros. strict aplica controles de seguridad mejorados: alineación con OAuth 2.1, autorización explícita de API y un conjunto seleccionado de funcionalidades compatibles. permissive conserva el comportamiento preexistente y solo está disponible para inquilinos con uso previo de clientes de terceros. Se establece al crearlo y no puede modificarse.
strict, permissive Define el método de autenticación solicitado para el endpoint de token. Puede ser none (cliente público sin secreto de cliente), client_secret_post (el cliente usa parámetros HTTP POST) o client_secret_basic (el cliente usa HTTP Basic).
none, client_secret_post, client_secret_basic Configuración para el intercambio de tokens.
Lista separada por comas de orígenes permitidos para usar con autenticación entre orígenes, flujo de dispositivo y modo de respuesta web message.