Obtient les profils de carte à puce

Obtient la liste des profils de carte à puce d’un utilisateur. La liste comprend les opérations possibles qui peuvent être effectuées par l’utilisateur actuel. Une demande peut alors être initiée pour l'une des opérations spécifiées.

Notes

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

Requête

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

Paramètres d’URL

Propriété Description
smartcarduuid facultatif. UUID de la carte à puce, tel qu’il est indiqué par Microsoft Identity Manager (MIM) la gestion des certificats (CM). La valeur correspond au champ « UUID » de l’objet Microsoft. CLM. Shared. SmartCards. SmartCard.

Paramètres de requête

Propriété Description
cardid Optionnel. UUID de la carte à puce, tel qu’il est indiqué par MIM CM. La valeur correspond au champ « UUID » de l’objet Microsoft. CLM. Shared. SmartCards. SmartCard.

En-têtes de requête

Pour les en-têtes de requête courants, consultez en-têtes de requête et de réponse http dans Détails du service de l' API REST cm.

Corps de la demande

Aucun.

response

Cette section décrit la réponse.

Codes de réponse

Code Description
200 OK
204 Aucun contenu
403 Interdit
500 Erreur interne

En-têtes de réponse

Pour les en-têtes de réponse courants, consultez en-têtes de requête et de réponse http dans Détails du service de l' API REST cm.

Response body

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

Nom Description
AssignedUserUuid Identificateur de l'utilisateur auquel est affectée la carte à puce.
Atr Chaîne ATR (Answer-To-Reset) de carte à puce pour la carte en cours d'initialisation.
Commentaire Commentaire qui décrit la carte à puce.
Indicateurs Indicateurs qui décrivent la carte à puce.
Middleware Intergiciel (middleware) de la carte à puce.
ParentSmartcardUuid Identificateur de l'ancienne carte à puce remplacée par la nouvelle.
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 contenant les stratégies et paramètres qui régissent la carte à puce.
ProfileTemplateVersion Version du modèle de profil au moment de la création de la carte à puce.
SerialNumber Numéro de série de la carte à puce.
Statut État de la carte à puce.
Uuid Identificateur du profil de la carte à puce.

Exemple

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

Exemple : requête 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