Ottenere profili smart card

Articolo
09/14/2023

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 delle operazioni specificate.

Nota

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

Richiesta

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

Parametri URL

Proprietà	Descrizione
smartcarduuid	Facoltativa. L'UUID della smart card come denotato da Microsoft Identity Manager (MIM) Certificate Management (CM). Il valore corrisponde al campo "uuid" nell'oggetto Microsoft.Clm.Shared.Smartcards.Smartcards.

Parametri di query

Proprietà	Descrizione
cardid	Facoltativa. UUID della smart card come denotato da MIM CM. Il valore corrisponde al campo "uuid" nell'oggetto Microsoft.Clm.Shared.Smartcards.Smartcards.

Intestazioni della richiesta

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

Testo della richiesta

Nessuno.

Risposta

Questa sezione descrive la risposta.

Codici di risposta

Codice	Descrizione
200	OK
204	Nessun contenuto
403	Accesso negato
500	Errore interno

Intestazioni di risposta

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

Corpo della risposta

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

Nome	Descrizione
AssignedUserUuid	Identificatore dell'utente a cui è assegnata la smart card.
Atr	Stringa ATR (Answer To Reset) di smart card per la scheda in fase di inizializzazione.
Commento	Il commento che descrive la smart card.
Flags	I flag che descrivono la smart card.
Middleware	Il 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 criteri e impostazioni che controllano la smart card.
ProfileTemplateVersion	La versione del modello di profilo al momento della creazione del profilo della smart card.
SerialNumber	Numero di serie della smart card.
Stato	Lo stato della smart card.
Uuid	Identificatore del profilo della smart card.

Esempio

Questa sezione fornisce un esempio per ottenere profili 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"
}

Vedi anche

Classe Microsoft.Clm.Shared.Smartcards.Smartcard

Condividi tramite