Abrufen von Smartcardprofilen

Artikel
09/14/2023

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. Für jeden der angegebenen Vorgänge kann dann eine Anforderung initiiert werden.

Hinweis

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

Anforderung

Methode	Anforderungs-URL
GET	/CertificateManagement/api/v1.0/smartcards /CertificateManagement/api/v1.0/smartcards/{Smartcard-UUID}

URL-Parameter

Eigenschaft	BESCHREIBUNG
smartcarduuid	Optional. Die Smartcard-UUID, wie von Microsoft Identity Manager (MIM) Certificate Management (CM) bezeichnet. Der Wert entspricht dem Feld "uuid" im Microsoft.Clm.Shared.Smartcards.Smartcards-Objekt .

Abfrageparameter

Eigenschaft	BESCHREIBUNG
cardid	Optional. Die Smartcard-UUID, wie von MIM CM bezeichnet. Der Wert entspricht dem Feld "uuid" im Microsoft.Clm.Shared.Smartcards.Smartcards-Objekt .

Anforderungsheader

Informationen zu gängigen Anforderungsheadern finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.

Anforderungstext

Keine.

Antwort

In diesem Abschnitt wird die Antwort beschrieben.

Antwortcodes

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

Antwortheader

Informationen zu allgemeinen Antwortheadern finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.

Antworttext

Bei Erfolg wird ein JSON-serialisiertes Microsoft.Clm.Shared.Smartcards.Smartcard-Objekt mit den folgenden Eigenschaften zurückgegeben:

Name	BESCHREIBUNG
AssignedUserUuid	Der Bezeichner des Benutzers, dem die Smartcard zugewiesen ist.
Atr	Die ATR-Zeichenfolge (Antwort zum Zurücksetzen) der Smartcard für die Karte, die derzeit initialisiert wird.
Comment	Der Kommentar, der die Smartcard beschreibt.
Flags	Die Flags, die die Smartcard beschreiben.
Middleware	Die Middleware für die Smartcard.
ParentSmartcardUuid	Der Bezeichner der alten Smartcard, die von der Smartcard ersetzt wurde.
PermanentSmartcardUuid	Der Bezeichner für die permanente Smartcard, der mit der Smartcard zugewiesen wird.
PrimarySmartcardUuid	Der Bezeichner der primären Smartcard.
ProfileTemplateUuid	Der Bezeichner der Profilvorlage, die die Richtlinien und Einstellungen enthält, die die Smartcard bestimmen.
ProfileTemplateVersion	Die Version der Profilvorlage zum Zeitpunkt der Erstellung der Smartcard.
SerialNumber	Die Seriennummer der Smartcard.
Status	Der Status der Smartcard.
Uuid	Der Bezeichner für das Profil der Smartcard.

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"
}

Weitere Informationen

Microsoft.Clm.Shared.Smartcards.Smartcard-Klasse

Freigeben über