Pobieranie profilów kart inteligentnych

  • Artykuł

Pobiera listę profilów kart inteligentnych dla użytkownika. Lista zawiera możliwe operacje, które mogą być wykonywane przez bieżącego użytkownika. Następnie można zainicjować żądanie dla dowolnej z określonych operacji.

Uwaga

Adresy URL w tym artykule są powiązane z nazwą hosta wybraną podczas wdrażania interfejsu API, taką jak https://api.contoso.com.

Żądanie

Metoda Adres URL żądania
GET /CertificateManagement/api/v1.0/smartcards
/CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

Parametry URL

Właściwość Opis
smartcarduuid Opcjonalny. Identyfikator UUID karty inteligentnej oznaczany przez zarządzanie certyfikatami (CM) Microsoft Identity Manager (MIM). Wartość odpowiada polu "uuid" w obiekcie Microsoft.Clm.Shared.Smartcards.Smartcard.

Parametry zapytania

Właściwość Opis
cardid Opcjonalny. Identyfikator UUID karty inteligentnej jest oznaczony przez cm programu MIM. Wartość odpowiada polu "uuid" w obiekcie Microsoft.Clm.Shared.Smartcards.Smartcard.

Nagłówki żądań

Aby zapoznać się z typowymi nagłówkami żądań, zobacz Nagłówki żądań HTTP i odpowiedzi w szczegółach usługi interfejsu API REST zarządzania konfiguracją.

Treść żądania

Brak.

Reakcja

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

Kod Opis
200 OK
204 Brak zawartości
403 Forbidden
500 Błąd wewnętrzny

Nagłówki odpowiedzi

Typowe nagłówki odpowiedzi można znaleźć w temacie Http request and response headers in CM REST API details (Nagłówki żądań HTTP i odpowiedzi w szczegółach usługi interfejsu API REST zarządzania konfiguracją).

Treść odpowiedzi

Po pomyślnym wykonaniu polecenia zwraca obiekt JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcard o następujących właściwościach:

Nazwa Opis
AssignedUserUuid Identyfikator użytkownika, któremu przypisano kartę inteligentną.
Atr Ciąg odpowiedzi na zresetowanie karty inteligentnej (ATR) dla aktualnie inicjowanej karty.
Komentarz Komentarz opisujący kartę inteligentną.
Flagi Flagi opisujące kartę inteligentną.
Oprogramowanie pośredniczące Oprogramowanie pośredniczące dla karty inteligentnej.
ParentSmartcardUuid Identyfikator starej karty inteligentnej, która została zastąpiona przez kartę inteligentną.
PermanentSmartcardUuid Identyfikator trwałej karty inteligentnej skojarzonej z kartą inteligentną.
PrimarySmartcardUuid Identyfikator podstawowej karty inteligentnej.
ProfileTemplateUuid Identyfikator szablonu profilu, który zawiera zasady i ustawienia, które regulują kartę inteligentną.
ProfileTemplateVersion Wersja szablonu profilu w momencie utworzenia profilu karty inteligentnej.
SerialNumber Numer seryjny karty inteligentnej.
Stan Stan karty inteligentnej.
Identyfikator UUID Identyfikator profilu karty inteligentnej.

Przykład

Ta sekcja zawiera przykład pobierania profilów kart inteligentnych dla użytkownika.

Przykład: żądanie 1

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

Przykład: Odpowiedź 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"
}

Przykład: Żądanie 2

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

Przykład: Odpowiedź 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"
}

Zobacz też