---
updatedAt: 2026-05-21T16:39:34.000Z
---
# Récupérer la liste des clients authentificateurs.
Récupérer la liste des clients d’authentification pour les instances d’ IBM Verify ou les authentificateurs mobiles personnalisés développés à partir du SDK IBM Verify.
Les clients d’authentification permettent de configurer des contrôles d’accès spécifiques à une autorisation OAuth pour les enregistrements d’authentificateurs qui y sont associés.
Droits :
- manageAuthenticatorsConfig (Gérer la configuration de l’authentificateur)
- readAuthenticatorsConfig (Lire la configuration de l’authentificateur)
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"version": "1.0.0",
"description": "Authentication Configuration",
"title": "Authentication Configuration"
},
"servers": [
{
"url": "https://{tenanturl}",
"variables": {
"tenanturl": {
"default": "{tenant_url}",
"description": "URL of your IBM Security Verify tenant"
}
}
}
],
"tags": [
{
"name": "Authenticator Clients"
}
],
"paths": {
"/v1.0/authenticators/clients": {
"get": {
"tags": [
"Authenticator Clients"
],
"summary": "Récupérer la liste des clients authentificateurs.",
"description": "Récupérer la liste des clients d’authentification pour les instances d’ IBM Verify ou les authentificateurs mobiles personnalisés développés à partir du SDK IBM Verify.
Les clients d’authentification permettent de configurer des contrôles d’accès spécifiques à une autorisation OAuth pour les enregistrements d’authentificateurs qui y sont associés.
Droits :
- manageAuthenticatorsConfig (Gérer la configuration de l’authentificateur)
- readAuthenticatorsConfig (Lire la configuration de l’authentificateur)",
"operationId": "getClients",
"parameters": [
{
"name": "pagination",
"in": "query",
"description": "Contrôle les résultats renvoyés dans une page.
Vous pouvez utiliser les paramètres de requête suivants:
page - Permet d'identifier la page demandée ou le décalage.
limite - Permet de définir le nombre total de résultats renvoyés par page. La valeur maximale autorisée est 1000.
A. Un maximum de 200 résultats est renvoyé si aucun paramètre de requête de pagination n'est transmis.
Note : La valeur du paramètre de pagination doit être codée en HTML. Utilisez le préfixe \"pagination=\" dans le paramètre de la requête.
Exemple : Paginer sur page=1&limit=5
pagination=page%3D1%26limit%3D5",
"schema": {
"type": "string"
}
},
{
"name": "search",
"in": "query",
"description": "Renvoie les résultats en fonction des critères de recherche.
Les opérateurs valides pour les chaînes de caractères sont =,!= et contains. Utilisez des guillemets doubles pour les valeurs de recherche.
Les opérateurs valides pour les booléens sont = et!=
Les opérateurs valides pour les nombres sont >=, >, <=, <, = et!=
Note : La valeur du paramètre de recherche doit être codée en HTML. Utilisez le préfixe \"search=\" dans le paramètre de la requête.
Exemple : La recherche sur id contient \"fd45\"&enabled=true
search=id%20contains%20%22fd45%22%26enabled%3Dtrue",
"schema": {
"type": "string"
}
},
{
"name": "filter",
"in": "query",
"description": "Affiche les résultats en fonction des critères de filtrage.
Les valeurs du filtre doivent être inclusives ou exclusives. Il ne peut pas être combiné.
Utilisez une virgule (,) pour séparer plusieurs paramètres de filtre.
Note : La valeur du paramètre de filtre doit être codée en HTML. Utilisez le préfixe \"filter=\" dans le paramètre de la requête.
Exemples
Filtre pour retourner uniquement l'id : filter=id
Filtre pour exclure l'id et enabled : filter=%21id,enabled",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "La liste des clients de l'authentificateur.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Clients"
}
}
}
},
"401": {
"description": "L'utilisateur non authentifié ne dispose pas des autorisations nécessaires pour effectuer l'opération demandée",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Unauthorized_0"
}
}
}
},
"403": {
"description": "L'utilisateur authentifié ne dispose pas des autorisations nécessaires pour effectuer l'opération demandée",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Forbidden_1"
}
}
}
}
},
"x-publicAPI": "true",
"x-category": "Authentication Configuration"
}
}
},
"components": {
"schemas": {
"Clients": {
"required": [
"clients"
],
"type": "object",
"properties": {
"clients": {
"type": "array",
"description": "La liste des instances de clients",
"items": {
"$ref": "#/components/schemas/Client"
}
}
},
"description": "Liste de clients authentificateurs valable pour les flux d'exécution prenant en charge les enregistrements."
},
"Client": {
"required": [
"accessTokenLifetime",
"authorizationCodeLifetime",
"enabled",
"id",
"name",
"refreshTokenLifetime"
],
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "L'identifiant unique du client authentificateur",
"readOnly": true,
"example": "ecb2bbbb-fd45-4ce9-957f-f18eaf65dfe8"
},
"name": {
"type": "string",
"description": "Le nom d'affichage du client",
"example": "VerifyAuthenticator"
},
"enabled": {
"type": "boolean",
"description": "Si le client est activé pour une utilisation en cours d'exécution"
},
"accessTokenLifetime": {
"type": "integer",
"description": "La durée, en secondes, pendant laquelle un jeton d'accès restera valide",
"format": "int32",
"example": 3600
},
"refreshTokenLifetime": {
"type": "integer",
"description": "Durée, en secondes, pendant laquelle un jeton d'actualisation restera valide",
"format": "int32",
"example": 63115200
},
"authorizationCodeLifetime": {
"type": "integer",
"description": "Durée de validité, en secondes, d'un code d'autorisation",
"format": "int32",
"example": 120
}
},
"description": "Un client authentificateur valide pour les flux d'exécution prenant en charge les enregistrements."
},
"Forbidden_1": {
"required": [
"messageDescription",
"messageId"
],
"type": "object",
"properties": {
"messageId": {
"type": "string",
"description": "L'identifiant de la clé de message",
"readOnly": true,
"example": "CSIXX1234X"
},
"messageDescription": {
"type": "string",
"description": "Un message descriptif spécifique au local du demandeur",
"readOnly": true,
"example": "The access token included in the request is not valid"
}
},
"description": "Le message de réponse à la demande."
},
"Unauthorized_0": {
"required": [
"messageDescription",
"messageId"
],
"type": "object",
"properties": {
"messageId": {
"type": "string",
"description": "L'identifiant de la clé de message",
"readOnly": true,
"example": "CSIXX1234X"
},
"messageDescription": {
"type": "string",
"description": "Un message descriptif spécifique au local du demandeur",
"readOnly": true,
"example": "The unauthenticated user does not have the permissions to perform the requested operation"
}
},
"description": "Le message de réponse à la demande."
}
}
},
"x-original-swagger-version": "2.0",
"x-explorer-enabled": false
}
```