Compartir a través de

Obtención de perfiles de tarjeta inteligente

  • Artículo

Obtiene una lista de perfiles de tarjeta inteligente para un usuario. La lista incluye las posibles operaciones que el usuario actual puede realizar. 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
GET /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 tal y como se indica en administración de certificados (CM) de Microsoft Identity Manager (MIM). El valor corresponde al campo "uuid" del objeto Microsoft.Clm.Shared.Smartcards.Smartcards .

Parámetros de consulta

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

Encabezados de solicitud

Para ver los encabezados de solicitud comunes, consulte Encabezados de solicitud y respuesta HTTP en los detalles del servicio de LA API REST de CM.

Cuerpo de la solicitud

Ninguno.

Response

En esta sección se describe la respuesta.

Códigos de respuesta

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

Encabezados de respuesta

Para ver los encabezados de respuesta comunes, consulte Encabezados de solicitud HTTP y respuesta en los detalles del servicio de LA API REST de CM.

Response body

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

Nombre Descripción
AssignedUserUuid Identificador del usuario al que está asignada la tarjeta inteligente.
Atr Cadena ATR de tarjeta inteligente de la tarjeta que se está inicializando actualmente.
Comentario Comentario que describe la tarjeta inteligente.
Marcas Marcas que describen la tarjeta inteligente.
Software intermedio Middleware de la tarjeta inteligente.
ParentSmartcardUuid Identificador de la antigua tarjeta inteligente a la que ha reemplazado la nueva.
PermanentSmartcardUuid Identificador de la tarjeta inteligente permanente que está 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.
SerialNumber Número de serie de la tarjeta inteligente.
Status Estado de la tarjeta inteligente.
Uuid Identificador del perfil de la 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