Condividi tramite

Ottenere i profili di smart card

Ottiene un elenco di profili smart card per un utente. L'elenco include le possibili operazioni che possono essere eseguite dall'utente corrente. È quindi possibile avviare una richiesta per una qualsiasi delle operazioni specificate.

Nota

Gli URL in questo articolo sono relativi al nome host scelto durante la distribuzione dell'API, ad esempio https://api.contoso.com.

Richiesta

Metodo URL richiesta
GET /CertificateManagement/api/v1.0/smart cards
/CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

Parametri URL

Proprietà Descrizione
smartcarduuid Opzionale. UUID della smart card indicato da Gestione certificati di Microsoft Identity Manager (MIM). Il valore corrisponde al campo "uuid" nell'oggetto Microsoft.Clm.Shared.Smartcards.Smartcard s.Smartcard.

Parametri di query

Proprietà Descrizione
cardid Opzionale. UUID della smart card indicato da MIM CM. Il valore corrisponde al campo "uuid" nell'oggetto Microsoft.Clm.Shared.Smartcards.Smartcard s.Smartcard.

Header di richiesta

Per le intestazioni di richiesta comuni, vedere intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm .

Testo della richiesta

Nessuno.

Risposta

Questa sezione descrive la risposta.

Codici di risposta

Codice Descrizione
200 Va bene
204 Nessun contenuto
403 Vietato
500 Errore interno

Intestazioni di risposta

Per le intestazioni di risposta comuni, vedere intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm .

Corpo della risposta

In caso di esito positivo, restituisce un JSON-Serialized oggetto Microsoft.Clm.Shared.Smartcards.Smartcard con le proprietà seguenti:

Nome Descrizione
AssignedUserUuid Identificatore dell'utente a cui è assegnata la smart card.
Atr Stringa di risposta alla reimpostazione della smart card (ATR) per la scheda attualmente in fase di inizializzazione.
Commento Commento che descrive la smart card.
Bandiere Flag che descrivono la smart card.
Middleware Middleware per la smart card.
ParentSmartcardUuid Identificatore della smart card precedente sostituita dalla smart card.
PermanentSmartcardUuid Identificatore della smart card permanente associata alla smart card.
PrimarySmartcardUuid Identificatore della smart card primaria.
ProfileTemplateUuid Identificatore del modello di profilo che contiene i criteri e le impostazioni che regolano la smart card.
ProfileTemplateVersion Versione del modello di profilo al momento della creazione del profilo della smart card.
SerialNumber Numero di serie della smart card.
Stato Stato della smart card.
Uuid Identificatore del profilo della smart card.

Esempio

Questa sezione fornisce un esempio per ottenere profili di smart card per un utente.

Esempio: Richiesta 1

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

Esempio: Risposta 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"
}

Esempio: Richiesta 2

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

Esempio: Risposta 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"
}

Vedere anche

  • Last updated on