Partager via

Obtenir des profils de carte à puce

Obtient une liste de profils de carte à puce pour un utilisateur. La liste inclut les opérations possibles qui peuvent être effectuées par l’utilisateur actuel. Une demande peut ensuite être lancée pour l’une des opérations spécifiées.

Remarque

Les URL de cet article sont relatives au nom d’hôte choisi pendant le déploiement de l’API, par exemple https://api.contoso.com.

Requête

Méthode URL de demande
OBTENIR /CertificateManagement/api/v1.0/smartcards
/CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

Paramètres d’URL

Propriété Description
smartcarduuid Optionnel. Carte à puce UUID comme indiqué par Microsoft Identity Manager (MIM) Certificate Management (CM). La valeur correspond au champ « uuid » dans l’objet Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard.

Paramètres de requête

Propriété Description
cardid Optionnel. Carte à puce UUID comme indiqué par MIM CM. La valeur correspond au champ « uuid » dans l’objet Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard.

En-têtes de requête

Pour connaître les en-têtes de requête courants, consultez les en-têtes de requête et de réponse HTTP dans détails du service d’API REST CM.

Corps de la requête

Aucun.

Réponse

Cette section décrit la réponse.

Codes de réponse

Code Description
200 D’ACCORD
204 Aucun contenu
403 Interdit
500 Erreur interne

En-têtes de réponse

Pour connaître les en-têtes de réponse courants, consultez les en-têtes de requête et de réponse HTTP dans détails du service d’API REST CM.

Corps de la réponse

En cas de réussite, retourne un objet JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcard avec les propriétés suivantes :

Nom Description
AssignedUserUuid Identificateur de l’utilisateur auquel la carte à puce est affectée.
Atr Chaîne de réponse à réinitialiser (ATR) de carte à puce pour la carte en cours d’initialisation.
Commentaire Commentaire décrivant la carte à puce.
Flags Indicateurs qui décrivent la carte à puce.
Intergiciel Intergiciel pour la carte à puce.
ParentSmartcardUuid Identificateur de l’ancienne carte à puce que la carte à puce a remplacée.
PermanentSmartcardUuid Identificateur de la carte à puce permanente associée à la carte à puce.
PrimarySmartcardUuid Identificateur de la carte à puce principale.
ProfileTemplateUuid Identificateur du modèle de profil qui contient les stratégies et les paramètres qui régissent la carte à puce.
ProfileTemplateVersion Version du modèle de profil au moment où le profil de carte à puce a été créé.
Numéro de série Numéro de série de la carte à puce.
Statut État de la carte à puce.
Uuid Identificateur du profil de carte à puce.

Exemple :

Cette section fournit un exemple pour obtenir des profils de carte à puce pour un utilisateur.

Exemple : Demande 1

GET /certificatemanagement/api/v1.0/smartcards?cardid=d1ef6869-5517-42a0-8f05-16ca1a0b834d HTTP/1.1

Exemple : Réponse 1

HTTP/1.1 200 OK

{
    "Uuid":"438d1b30-f3b4-4bed-85fa-285e08605ba7",
    "Status":3,
    "Flags":1,
    "ParentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PrimarySmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PermanentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "AssignedUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "ProfileTemplateVersion":46,
    "Comment":"",
    "SerialNumber":"{d1ef6869-5517-42a0-8f05-16ca1a0b834d}",
    "Middleware":"MSBaseCSP",
    "Atr":"3b8d0180fba000000397425446590301c8"
}

Exemple : Demande 2

GET /certificatemanagement/api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1

Exemple : Réponse 2

HTTP/1.1 200 OK

{
    "Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "Status":2,
    "Flags":1,
    "ParentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PrimarySmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PermanentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "AssignedUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "ProfileTemplateVersion":46,
    "Comment":"",
    "SerialNumber":"{bc88f13f-83ba-4037-8262-46eba1291c6e}",
    "Middleware":"MSBaseCSP",
    "Atr":"3b8d0180fba000000397425446590301c8"
}

Voir aussi

  • Last updated on