Intelligenskártya-profilok lekérése

  • Cikk

Lekéri a felhasználók intelligenskártya-profiljainak listáját. A lista tartalmazza az aktuális felhasználó által végrehajtható lehetséges műveleteket. Ezután a megadott műveletek bármelyikéhez kezdeményezhető kérelem.

Megjegyzés

A cikkben szereplő URL-címek az API-telepítés során kiválasztott gazdagépnévhez (például https://api.contoso.com) kapcsolódnak.

Kérés

Metódus URL-cím kérése
GET /CertificateManagement/api/v1.0/smartcards
/CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

URL-paraméterek

Tulajdonság Leírás
smartcarduuid Választható. Az intelligens kártya UUID azonosítója, amelyet a Microsoft Identity Manager (MIM) Tanúsítványkezelés (CM) jelöl. Az érték a Microsoft.Clm.Shared.Smartcards.Smartcard objektum "uuid" mezőjének felel meg.

Lekérdezési paraméterek

Tulajdonság Leírás
cardid Választható. Az intelligens kártya UUID azonosítója, amelyet a MIM CM jelöl. Az érték a Microsoft.Clm.Shared.Smartcards.Smartcard objektum "uuid" mezőjének felel meg.

Kérésfejlécek

A gyakori kérésfejlécekért lásd: HTTP-kérés- és válaszfejlécek a CM REST API szolgáltatás részleteiben.

A kérés törzse

Nincsenek.

Reagálás

Ez a szakasz a választ ismerteti.

Válaszkódok

Code Description
200 OK
204 Nincs tartalom
403 Forbidden
500 Belső hiba

Válaszfejlécek

A gyakori válaszfejlécekért lásd: HTTP-kérés- és válaszfejlécek a CM REST API szolgáltatás részleteiben.

Választörzs

Sikeres végrehajtás esetén egy JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard objektumot ad vissza a következő tulajdonságokkal:

Név Leírás
AssignedUserUuid Annak a felhasználónak az azonosítója, amelyhez az intelligens kártya hozzá van rendelve.
Atr Az inicializálás alatt álló kártya válasz-visszaállítás (ATR) sztringje.
Megjegyzés Az intelligens kártyát leíró megjegyzés.
Zászlók Az intelligens kártyát leíró jelzők.
Közbenső szoftver Az intelligens kártya köztes szoftvere.
ParentSmartcardUuid Annak a régi intelligens kártyának az azonosítója, amelyet az intelligens kártya lecserélt.
PermanentSmartcardUuid Az intelligens kártyához társított állandó intelligens kártya azonosítója.
PrimarySmartcardUuid Az elsődleges intelligens kártya azonosítója.
ProfileTemplateUuid Az intelligens kártyát szabályozó szabályzatokat és beállításokat tartalmazó profilsablon azonosítója.
ProfileTemplateVersion A profilsablon verziója az intelligenskártya-profil létrehozásakor.
Sorozatszám Az intelligens kártya sorozatszáma.
Állapot Az intelligens kártya állapota.
Uuid Az intelligenskártya-profil azonosítója.

Példa

Ez a szakasz egy példát mutat be egy felhasználó intelligenskártya-profiljainak lekérésére.

Példa: 1. kérelem

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

Példa: 1. válasz

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

Példa: 2. kérelem

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

Példa: 2. válasz

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

Lásd még