Obtención del PIN propuesto de tarjeta inteligente

Obtiene el PIN de usuario generado por el servidor.

Importante

El servidor solo establece el PIN si la directiva de plantilla de perfil indica que debe realizarse. De lo contrario, el usuario debe proporcionar el PIN.

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/{id}/serverproposedpin

Parámetros de dirección URL

Parámetro	Descripción
identificación	Identificador de tarjeta inteligente específico de Administración de certificados (CM) de Microsoft Identity Manager (MIM). El identificador se obtiene del objeto Microsft.Clm.Shared.Smartcard.

Parámetros de consulta

Parámetro	Descripción
Atr	Cadena de respuesta a restablecimiento de tarjeta inteligente (ATR).
cardid	Identificador de tarjeta inteligente.
desafiar	Cadena codificada en base 64 que representa el desafío emitido por la tarjeta inteligente.

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 una cadena que representa el PIN propuesto por el servidor.

Ejemplo

En esta sección se proporciona un ejemplo para obtener el PIN de usuario generado por el servidor.

Ejemplo: solicitud

GET GET /CertificateManagement/api/v1.0/smartcards/C6BAD97C-F97F-4920-8947-BE980C98C6B5/serverproposedpin HTTP/1.1

Ejemplo: respuesta

HTTP/1.1 200 OK

... body coming soon