Uzyskiwanie proponowanego numeru PIN karty inteligentnej

Pobiera numer PIN wygenerowany przez serwer 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ą względne względem nazwy hosta wybranej podczas wdrażania interfejsu API, takiej 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 Microsoft Identity Manager (MIM) Certificate Management (CM). 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 uzyskać informacje o typowych nagłówkach żądań, zobacz Nagłówki żądań i odpowiedzi HTTP w sekcji Szczegóły usługi interfejsu API REST usługi CM.

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

Aby uzyskać informacje o typowych nagłówkach odpowiedzi, zobacz Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w te tematu CM REST API service details (Szczegółyusługi interfejsu API REST usługi CM).

Treść odpowiedzi

W przypadku powodzenia zwraca ciąg reprezentujący numer PIN proponowany przez serwer.

Przykład

Ta sekcja zawiera przykład uzyskania 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