---
updatedAt: 2026-05-21T18:12:22.000Z
---

# Liste des fournisseurs de cartes à puce et d'autres certificats X.509.

Liste de la configuration des cartes à puce et des autres fournisseurs de certificats X.509.<br>Attributions requises : readIdentitySources (Lire les fournisseurs d'identité) ou manageIdentitySources (Gérer les fournisseurs d'identité).<br>Note : Vous n'avez besoin que d'une seule attribution, mais vous pouvez en avoir plus d'une.<br>

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0.0",
    "description": "IBM Verify API",
    "title": "IBM Verify API"
  },
  "servers": [
    {
      "url": "https://{tenanturl}",
      "variables": {
        "tenanturl": {
          "default": "{tenant_url}",
          "description": "URL of your IBM Security Verify tenant"
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Smartcard and other X.509 certificate provider configuration"
    }
  ],
  "paths": {
    "/config/v1.0/smartcard-providers": {
      "get": {
        "tags": [
          "Smartcard and other X.509 certificate provider configuration"
        ],
        "summary": "Liste des fournisseurs de cartes à puce et d'autres certificats X.509.",
        "description": "Liste de la configuration des cartes à puce et des autres fournisseurs de certificats X.509.<br>Attributions requises : readIdentitySources (Lire les fournisseurs d'identité) ou manageIdentitySources (Gérer les fournisseurs d'identité).<br>Note : Vous n'avez besoin que d'une seule attribution, mais vous pouvez en avoir plus d'une.<br>",
        "operationId": "listSmartcardProviders",
        "parameters": [
          {
            "name": "identitySourceId",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "idOnly",
            "in": "query",
            "schema": {
              "type": "boolean",
              "enum": [
                true,
                false
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Requête réussie",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SmartcardProvider"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Exception pour mauvaise demande",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBean"
                }
              }
            }
          },
          "403": {
            "description": "Interdit",
            "content": {}
          },
          "500": {
            "description": "Erreur de serveur interne",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBean"
                }
              }
            }
          }
        },
        "x-publicAPI": "true",
        "x-category": "IBM Verify API"
      }
    }
  },
  "components": {
    "schemas": {
      "PostEvalOptions": {
        "required": [
          "custom",
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "L'identifiant de l'opération de post-exploitation.",
            "example": "base64encoding"
          },
          "custom": {
            "type": "string",
            "description": "Règle personnalisée de l'opération d'évaluation des postes.",
            "example": "idsuser.$property[0]"
          }
        }
      },
      "ErrorBean": {
        "type": "object",
        "properties": {
          "messageId": {
            "type": "string",
            "description": "L'identifiant de la clé du message.",
            "readOnly": true
          },
          "messageDescription": {
            "type": "string",
            "description": "Un message descriptif spécifique à la locale du demandeur.",
            "readOnly": true
          }
        }
      },
      "SmartcardProvider": {
        "required": [
          "identitySourceEnabled",
          "identitySourceId",
          "instanceName",
          "jitpEnabled",
          "subjectKeyIdentifier",
          "uniqueUserIdentifier"
        ],
        "type": "object",
        "properties": {
          "instanceName": {
            "type": "string",
            "description": "Un nom descriptif pour représenter cette instance.",
            "example": "TryISV MTLS-Auth provider"
          },
          "enabled": {
            "type": "boolean",
            "description": "Indiquer si cette instance est activée."
          },
          "identitySourceId": {
            "type": "string",
            "description": "L'identifiant du fournisseur d'identité.",
            "example": "<UUID>"
          },
          "jitpEnabled": {
            "type": "boolean",
            "description": "Indiquer si le provisionnement juste à temps est activé."
          },
          "uniqueUserIdentifier": {
            "type": "string",
            "description": "Attribut unique utilisé pour identifier un utilisateur existant dans le fournisseur d'identité Verify ou pour effectuer une JITP avec sa valeur pour l'utilisateur userName"
          },
          "attributeMappings": {
            "type": "array",
            "description": "La configuration des mappages d'attributs.",
            "items": {
              "$ref": "#/components/schemas/AttributeMapping_0"
            }
          },
          "identitySourceEnabled": {
            "type": "boolean",
            "description": "Informations en lecture seule sur l'état d'activation du fournisseur d'identité configuré."
          },
          "smartcardProviderId": {
            "type": "string",
            "description": "En lecture seule et généré après la création de ce fournisseur.",
            "example": "<UUID>"
          },
          "uniqueUserIdentifierRequestRule": {
            "type": "string",
            "description": "Règle personnalisée permettant d'évaluer la valeur de l'attribut uniqueUserIdentifier.",
            "example": "requestContext.subjectCN[0].split('@')[0]"
          },
          "subjectKeyIdentifier": {
            "type": "string",
            "description": "Subject Key Identifier de l'autorité de certification immédiate qui délivre les certificats du client X.509.",
            "example": "6D:55:3E:F9:5D:82:14:C5:03:D2:93:4A:64:D9:0A:A1:CC:FB:B9:A0"
          }
        }
      },
      "AttributeMapping_0": {
        "required": [
          "attrId",
          "idsAttrName",
          "jitpOption"
        ],
        "type": "object",
        "properties": {
          "idsAttrName": {
            "type": "string",
            "description": "Le nom de l'attribut entrant.",
            "example": "mail"
          },
          "attrId": {
            "type": "string",
            "description": "L'identifiant interne de l'attribut de l'utilisateur.",
            "example": "3"
          },
          "jitpOption": {
            "type": "string",
            "description": "L'option JITP sur l'attribut.",
            "example": "ALWAYS"
          },
          "postEval": {
            "$ref": "#/components/schemas/PostEvalOptions"
          }
        }
      }
    }
  },
  "x-original-swagger-version": "2.0",
  "x-explorer-enabled": false
}
```