Compartir a través de

Obtención de perfiles de tarjeta inteligente

Obtiene una lista de perfiles de tarjeta inteligente para un usuario. La lista incluye las posibles operaciones que puede realizar el usuario actual. Después, se puede iniciar una solicitud para cualquiera de las operaciones especificadas.

Nota:

Las direcciones URL de este artículo son relativas al nombre de host elegido durante la implementación de la API, como https://api.contoso.com.

Solicitud

Método URL de solicitud
OBTÉN /CertificateManagement/api/v1.0/smartcards
/CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

Parámetros de dirección URL

Propiedad Descripción
smartcarduuid Opcional. UuID de tarjeta inteligente como se indica en Microsoft Identity Manager (MIM) Certificate Management (CM). El valor corresponde al campo "uuid" del objeto Microsoft.Clm.Shared.Smartcards.Smartcard.

Parámetros de consulta

Propiedad Descripción
cardid Opcional. UUID de tarjeta inteligente como se indica en MIM CM. El valor corresponde al campo "uuid" del objeto Microsoft.Clm.Shared.Smartcards.Smartcard.

Encabezados de solicitud

Para obtener encabezados de solicitud comunes, consulte encabezados de solicitud y respuesta HTTP en detalles del servicio de API REST de CM.

Cuerpo de la solicitud

Ninguno.

Respuesta

En esta sección se describe la respuesta.

Códigos de respuesta

Código Descripción
200 De acuerdo
204 Sin contenido
403 Prohibido
500 Error interno

Encabezados de respuesta

Para obtener encabezados de respuesta comunes, consulte encabezados de solicitud y respuesta HTTP en detalles del servicio de API REST de CM.

Cuerpo de la respuesta

Si se ejecuta correctamente, devuelve un objeto JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcard con las siguientes propiedades:

Nombre Descripción
AssignedUserUuid Identificador del usuario al que se asigna la tarjeta inteligente.
Atr Cadena de respuesta a restablecimiento de tarjeta inteligente (ATR) para la tarjeta que se está inicializando actualmente.
Comentario Comentario que describe la tarjeta inteligente.
Flags Marcas que describen la tarjeta inteligente.
Middleware Middleware para la tarjeta inteligente.
ParentSmartcardUuid Identificador de la tarjeta inteligente antigua que ha reemplazado la tarjeta inteligente.
PermanentSmartcardUuid Identificador de la tarjeta inteligente permanente asociada a la tarjeta inteligente.
PrimarySmartcardUuid Identificador de la tarjeta inteligente principal.
ProfileTemplateUuid Identificador de la plantilla de perfil que contiene las directivas y la configuración que rigen la tarjeta inteligente.
ProfileTemplateVersion Versión de la plantilla de perfil en el momento en que se creó el perfil de tarjeta inteligente.
Número de serie. Número de serie de la tarjeta inteligente.
Estado Estado de la tarjeta inteligente.
Uuid Identificador del perfil de tarjeta inteligente.

Ejemplo

En esta sección se proporciona un ejemplo para obtener perfiles de tarjeta inteligente para un usuario.

Ejemplo: Solicitud 1

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

Ejemplo: Respuesta 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"
}

Ejemplo: Solicitud 2

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

Ejemplo: Respuesta 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"
}

Consulte también