Obtenir des profils de carte à puce

Article
09/14/2023

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 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 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. L’UUID de carte à puce comme indiqué par Microsoft Identity Manager (MIM) Certificate Management (CM). La valeur correspond au champ « uuid » dans l’objet Microsoft.Clm.Shared.Smartcards.Smartcards.

Paramètres de requête

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

En-têtes de requête

Pour connaître les en-têtes de requête courants, consultez En-têtes de requête et de réponse HTTP dans les détails du service d’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 connaître les en-têtes de réponse courants, consultez Requêtes HTTP et en-têtes de réponse dans les détails du service d’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 d’obtention de 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 : Requête 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

Classe Microsoft.Clm.Shared.Smartcards.Smartcard

Partager via