Uzyskiwanie proponowanego numeru PIN karty inteligentnej

Pobiera wygenerowany przez serwer numer PIN użytkownika.

Ważne

Serwer ustawia numer PIN tylko wtedy, gdy zasady szablonu profilu wskazują, że należy to zrobić. W przeciwnym razie użytkownik powinien podać numer PIN.

Uwaga

Adresy URL w tym artykule są powiązane z nazwą hosta wybraną podczas wdrażania interfejsu API, taką jak https://api.contoso.com.

Żądanie

Metoda	Adres URL żądania
GET	/CertificateManagement/api/v1.0/smartcards/{id}/serverproposedpin

Parametry URL

Parametr	Opis
identyfikator	Identyfikator karty inteligentnej specyficzny dla zarządzania certyfikatami Microsoft Identity Manager (MIM). Identyfikator jest uzyskiwany z obiektu Microsft.Clm.Shared.Smartcard.

Parametry zapytania

Parametr	Opis
Atr	Ciąg odpowiedzi na zresetowanie karty inteligentnej (ATR).
cardid	Identyfikator karty inteligentnej.
Wyzwanie	Ciąg zakodowany w formacie base-64 reprezentujący wyzwanie wystawione przez kartę inteligentną.

Nagłówki żądań

Aby zapoznać się z typowymi nagłówkami żądań, zobacz Nagłówki żądań HTTP i odpowiedzi w szczegółach usługi interfejsu API REST zarządzania konfiguracją.

Treść żądania

Brak.

Reakcja

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

Kod	Opis
200	OK
204	Brak zawartości
403	Forbidden
500	Błąd wewnętrzny

Nagłówki odpowiedzi

Typowe nagłówki odpowiedzi można znaleźć w temacie Http request and response headers in CM REST API details (Nagłówki żądań HTTP i odpowiedzi w szczegółach usługi interfejsu API REST zarządzania konfiguracją).

Treść odpowiedzi

Po pomyślnym powrocie zwraca ciąg reprezentujący numer PIN proponowany przez serwer.

Przykład

W tej sekcji przedstawiono przykład pobierania numeru PIN użytkownika wygenerowanego przez serwer.

Przykład: żądanie

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

Przykład: odpowiedź

HTTP/1.1 200 OK

... body coming soon