Obtenir les clients
Récupère les clients (applications et intégrations SSO) correspondant aux filtres fournis. Vous pouvez aussi préciser une liste de champs à inclure ou à exclure. Pour plus d’information, consultez Applications in Auth0 et Single Sign-On.
- Les éléments suivants peuvent être récupérés avec n’importe quelle portée :
client_id,app_type,nameetdescription. - Les propriétés suivantes ne peuvent être récupérées qu’avec la portée
read:clientsouread:client_keys:callbacks,oidc_logout,allowed_origins,web_origins,tenant,global,config_route,callback_url_template,jwt_configuration,jwt_configuration.lifetime_in_seconds,jwt_configuration.secret_encoded,jwt_configuration.scopes,jwt_configuration.alg,api_type,logo_uri,allowed_clients,owners,custom_login_page,custom_login_page_off,sso,addons,form_template,custom_login_page_codeview,resource_servers,client_metadata,mobile,mobile.android,mobile.ios,allowed_logout_urls,token_endpoint_auth_method,is_first_party,oidc_conformant,is_token_endpoint_ip_header_trusted,initiate_login_uri,grant_types,refresh_token,refresh_token.rotation_type,refresh_token.expiration_type,refresh_token.leeway,refresh_token.token_lifetime,refresh_token.policies,organization_usage,organization_require_behavior. - Les propriétés suivantes ne peuvent être récupérées qu’avec les portées
read:client_keysouread:client_credentials:encryption_key,encryption_key.pub,encryption_key.cert,client_secret,client_authentication_methodsetsigning_key.
Autorisations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Paramètres de requête
Liste de champs séparés par des virgules à inclure ou à exclure (selon la valeur fournie pour include_fields) dans le résultat. Laissez vide pour récupérer tous les champs.
Indique si les champs précisés doivent être inclus (true) ou exclus (false).
Indice de la page de résultats à retourner. La première page est 0.
x >= 0Nombre de résultats par page. La valeur par défaut est de 50 et la valeur maximale est de 100
0 <= x <= 100Retourne les résultats dans un objet qui contient le nombre total de résultats (true) ou sous forme de tableau de résultats direct (false, par défaut).
ID facultatif à partir duquel commencer la sélection.
Nombre de résultats par page. La valeur par défaut est de 50.
1 <= x <= 100Filtre facultatif sur le paramètre global du client.
Filtre facultatif indiquant si un client est ou non un client propriétaire.
Filtre facultatif selon une liste de types d’application séparés par des virgules.
Filtre facultatif selon l’URI du Client ID Metadata Document pour les clients enregistrés par CIMD.
1 - 120Requête avancée en syntaxe Lucene.
Requêtes autorisées :
- client_grant.organization_id:{organization_id}
- client_grant.allow_any_organization:true
- Ne peut pas être utilisée en combinaison avec d’autres filtres
- Nécessite l’utilisation des paramètres de pagination from et take (pagination par checkpoint)
- Des limites de débit réduites s’appliquent. Consultez Rate Limit Configurations
Réponse
Clients récupérés avec succès.
- Option 1 · object[]
- Option 2 · object
- Option 3 · object
Modules complémentaires activés pour ce client et leur configuration associée.
Liste des clients autorisés et des ID d’API autorisés à effectuer des requêtes de délégation. Vide signifie que tous vos clients sont autorisés.
Liste d’URL séparées par des virgules vers lesquelles la redirection est autorisée après la déconnexion d’Auth0. Les caractères génériques sont autorisés pour les sous-domaines.
Liste d’URL séparées par des virgules autorisées à effectuer des requêtes JavaScript vers l’API Auth0 (généralement utilisée avec CORS). Par défaut, toutes vos URL de rappel seront autorisées. Ce champ vous permet de saisir d’autres origines au besoin. Vous pouvez aussi utiliser des caractères génériques au niveau du sous-domaine (p. ex. https://*.contoso.com). Les chaînes de requête et les informations de hachage ne sont pas prises en compte lors de la validation de ces URL.
Le type d’application que ce client représente
native, spa, regular_web, non_interactive, resource_server, express_configuration, b2b_integration, rms, box, cloudbees, concur, dropbox, mscrm, echosign, egnyte, newrelic, office365, salesforce, sentry, sharepoint, slack, springcm, zendesk, zoom, sso_integration, oag Tableau des canaux de notification pour communiquer avec l’utilisateur lorsque son approbation est requise. Les valeurs valides sont guardian-push, email.
1guardian-push, email Configuration des clients d’intégration B2B.
Liste d’URL séparées par des virgules qu’Auth0 est autorisé à utiliser comme URL de rappel vers le client après l’authentification.
Liste des audiences/realms pour le protocole SAML. Utilisée par l’addon wsfed.
Définit les méthodes d’authentification du client.
ID de ce client.
Metadata associées au client, sous la forme d’un object contenant des valeurs String (max. 255 caractères). Un maximum de 10 properties de metadata est autorisé. Les field names (max. 255 caractères) sont alphanumériques et peuvent uniquement inclure les caractères spéciaux suivants : :,-+=_*?"/()<>@ [Tab] [Space]
Secret du client (que vous ne devez pas rendre public).
Définit le niveau de conformité pour ce client, ce qui peut restreindre ses capacités.
none, fapi1_adv_pkj_par, fapi1_adv_mtls_par, fapi2_sp_pkj_mtls, fapi2_sp_mtls_mtls, null Indique si ce client peut être utilisé pour effectuer des requêtes d’authentification inter-origines (true) ou s’il n’est pas autorisé à effectuer de telles requêtes (false).
URL de l’emplacement sur votre site où la vérification inter-origines a lieu dans le flux d’authentification inter-origines lorsque l’authentification est effectuée sur votre propre domaine plutôt que sur la page de connexion hébergée d’Auth0.
Le contenu (HTML, CSS, JS) de la page de connexion personnalisée.
Indique si une page de connexion personnalisée doit être utilisée (true) ou si la page de connexion par défaut doit l’être (false).
Le contenu (HTML, CSS, JS) de la page de connexion personnalisée. (Utilisé dans les aperçus)
Définit l’ID d’Organization par défaut et les flows.
Description en texte libre de ce client (longueur maximale : 140 caractères).
Chiffrement utilisé pour les réponses WsFed avec ce client.
Configuration propre à l’application à utiliser avec la fonctionnalité OIN Express Configuration.
Un autre identifiant client à utiliser durant les flux d’autorisation. Prend uniquement en charge les identifiants client fondés sur CIMD.
Indique qui a créé le client de métadonnées externes. La valeur admin indique que le client a été enregistré au moyen de la Management API. La valeur client indique que le client a été enregistré dynamiquement. Ce champ n’est présent que lorsque external_metadata_type est défini.
admin, client Indique le type de métadonnées externes utilisé pour enregistrer le client. Ce champ est omis pour les clients ordinaires. La valeur cimd identifie les clients enregistrés au moyen d’un Client ID Metadata Document. La valeur dcr identifie les clients enregistrés au moyen de Dynamic Client Registration.
cimd, dcr Configurer les paramètres de connexion FedCM pour le nouveau Universal Login
Modèle de formulaire HTML à utiliser pour WS-Federation.
Indique s’il s’agit de votre client global « All Applications », représentant les paramètres Legacy du tenant (true), ou d’un client régulier (false).
Liste des types d’octroi pris en charge pour cette application. Peut inclure 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 et urn:auth0:params:oauth:grant-type:token-exchange:federated-connection-access-token.
Configuration relative à l’utilisation des ID-JAG pour Cross App Access.
URI d’initialisation de la connexion; doit utiliser HTTPS
Indique si ce client est un client de première partie (true) ou non (false).
Si true, l’IP indiquée dans l’en-tête auth0-forwarded-for est considérée comme l’IP de l’utilisateur final aux fins de la protection contre les attaques par force brute au point de terminaison de jeton.
URL du JSON Web Key Set (JWKS) contenant les clés publiques utilisées pour l’authentification private_key_jwt. Présente uniquement pour les clients CIMD qui utilisent l’authentification private_key_jwt.
Configuration liée aux JWT du client.
URL du logo à afficher pour ce client. La taille recommandée est de 150 x 150 pixels.
Configuration supplémentaire pour les applications mobiles natives.
Configuration liée à la configuration My Organization pour le client.
Nom de ce client (longueur minimale : 1 caractère, n’autorise pas < ni >).
Configurer les paramètres de connexion sociale native
Indique si ce client est conforme aux spécifications strictes d’OIDC (true) ou s’il utilise des fonctionnalités héritées (false).
Configuration du logout OIDC par canal arrière
Définit les méthodes offertes pour la découverte de l’organisation durant le pre_login_prompt. Les utilisateurs peuvent découvrir leur organisation à l’aide de email, de organization_name ou des deux.
1Méthode de découverte des organisations pendant pre_login_prompt. email permet aux utilisateurs de trouver leur organisation en saisissant leur adresse courriel et en effectuant une correspondance de domaine, tandis que organization_name exige qu’ils saisissent directement le nom de l’organisation. Ces méthodes peuvent être combinées.
email, organization_name Définit comment procéder pendant une transaction d’authentification lorsque client.organization_usage: 'require'. Peut être no_prompt (par défaut), pre_login_prompt ou post_login_prompt. post_login_prompt exige oidc_conformant: true.
no_prompt, pre_login_prompt, post_login_prompt Définit comment procéder pendant une transaction d’authentification en ce qui concerne une organization. Peut être deny (par défaut), allow ou require.
deny, allow, require Précise pendant combien de temps, en secondes, un URI de Pushed Authorization Request demeure valide
10 <= x <= 600Détermine si Auth0 redirige les utilisateurs vers l’URL de rappel de l’application en cas d’erreur d’authentification ou dans les flux de vérification du courriel. open_redirect_protection affiche plutôt une page d’erreur que d’effectuer une redirection et masque le domaine de rappel dans les modèles de courriel. allow_always active le comportement de redirection standard. La valeur par défaut est open_redirect_protection pour les clients third-party. S’applique uniquement lorsque is_first_party est false et que third_party_security_mode est strict. Pour en savoir plus, consultez la protection contre les redirections.
allow_always, open_redirect_protection Configuration du Refresh Token
Rend obligatoire l’utilisation de la Proof-of-Possession pour ce client
Rend obligatoire l’utilisation des Pushed Authorization Requests pour ce client
L’identifiant du serveur de ressources auquel ce client est associé.
Configuration de Native to Web SSO
Paramètres de JWT-Secured Authorization Requests (JAR).
Certificats de signature associés à ce client.
Détermine si un message de confirmation est affiché durant les flux de connexion lorsque l’URI de redirection utilise des URI de rappel non vérifiables (par exemple, un schéma d’URI personnalisé comme myapp:// ou localhost).
Si la valeur est true, aucun message de confirmation ne sera affiché. Nous recommandons de définir cette valeur à false afin d’améliorer la protection contre les applications malveillantes.
Consultez https://auth0.com/docs/secure/security-guidance/measures-against-app-impersonation pour en savoir plus.
S’applique uniquement aux clients SSO et détermine si Auth0 gère l’authentification unique (true) ou si c’est le fournisseur d’identité qui la gère (false).
Indique si l’authentification unique est désactivée (true) ou activée (true). La valeur par défaut est true.
Nom du tenant auquel ce client appartient.
Mode de sécurité pour les clients tiers. strict applique des contrôles de sécurité renforcés : alignement sur OAuth 2.1, autorisation explicite de l’API et ensemble sélectionné de fonctionnalités prises en charge. permissive conserve le comportement préexistant et n’est offert qu’aux tenants ayant déjà utilisé des clients tiers. Il est défini à la création et ne peut pas être modifié.
strict, permissive Définit la méthode d’authentification demandée pour le point de terminaison des jetons. Peut être none (client public sans client secret), client_secret_post (le client utilise des paramètres HTTP POST) ou client_secret_basic (le client utilise HTTP Basic).
none, client_secret_post, client_secret_basic Configuration de l’échange de jetons.
Paramètres de l’accès privilégié à Token Vault.
Liste d’origines autorisées, séparées par des virgules, à utiliser avec la Cross-Origin Authentication, le Device Flow et le mode de réponse par message Web.