Abrufen von Smartcardprofilen

Artikel
03/22/2025

Ruft eine Liste der Smartcardprofile für einen Benutzer ab. Die Liste enthält die möglichen Vorgänge, die vom aktuellen Benutzer ausgeführt werden können. Eine Anforderung kann dann für jede der angegebenen Vorgänge initiiert werden.

Hinweis

Die URLs in diesem Artikel beziehen sich auf den Hostnamen, der während der API-Bereitstellung ausgewählt wird, z. B. https://api.contoso.com.

Anfrage

Methode	Anforderungs-URL
ERHALTEN/Bekommen	/CertificateManagement/api/v1.0/smartcards /CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

URL-Parameter

Eigentum	BESCHREIBUNG
smartcarduuid	Wahlfrei. Die Smartcard-UUID, die von microsoft Identity Manager (MIM) Certificate Management (CM) bezeichnet wird. Der Wert entspricht dem Feld "uuid" im Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard-Objekt.

Abfrageparameter

Eigentum	BESCHREIBUNG
cardid	Wahlfrei. Die Smartcard UUID wie von MIM CM gekennzeichnet. Der Wert entspricht dem Feld "uuid" im Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard-Objekt.

Anforderungsheader

Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.

Anfragekörper

Keiner.

Antwort

In diesem Abschnitt wird die Antwort beschrieben.

Antwortcodes

Code	BESCHREIBUNG
200	OKAY
204	Kein Inhalt
403	Verboten
500	Interner Fehler

Antwortheader

Allgemeine Antwortheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.

Antwortkörper

Gibt bei Erfolg ein JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard- -Objekt mit den folgenden Eigenschaften zurück:

Name	BESCHREIBUNG
AssignedUserUuid	Der Bezeichner des Benutzers, dem die Smartcard zugewiesen ist.
Atr	Die Smartcard answer-to-reset (ATR)-Zeichenfolge für die Karte, die derzeit initialisiert wird.
Kommentar	Der Kommentar, der die Smartcard beschreibt.
Flaggen	Die Kennzeichnungen, die die Smartcard beschreiben.
Middleware	Die Middleware für die Smartcard.
ParentSmartcardUuid	Der Bezeichner der alten Smartcard, die die Smartcard ersetzt hat.
PermanentSmartcardUuid	Der Bezeichner der dauerhaften Smartcard, die der Smartcard zugeordnet ist.
PrimarySmartcardUuid	Der Bezeichner der primären Smartcard.
ProfileTemplateUuid	Der Bezeichner der Profilvorlage, die die Richtlinien und Einstellungen enthält, die die Smartcard steuern.
ProfileTemplateVersion	Die Version der Profilvorlage zum Zeitpunkt der Erstellung des Smartcardprofils.
Seriennummer	Die Seriennummer der Smartcard.
Status	Der Status der Smartcard.
Uuid	Der Bezeichner des Smartcardprofils.

Beispiel

Dieser Abschnitt enthält ein Beispiel zum Abrufen von Smartcardprofilen für einen Benutzer.

Beispiel: Anforderung 1

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

Beispiel: Antwort 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"
}

Beispiel: Anforderung 2

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

Beispiel: Antwort 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"
}

Siehe auch

Microsoft.Clm.Shared.Smartcards.Smartcard-Klasse

Freigeben über