Udostępnij przez

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
id Identyfikator karty inteligentnej specyficzny dla zarządzania certyfikatami programu 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 zapytań

Aby uzyskać typowe nagłówki żądań, zobacz nagłówki żądań i odpowiedzi HTTP w szczegółach usługi interfejsu API REST CM.

Ciało żądania

Żaden.

Odpowiedź

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

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

Nagłówki odpowiedzi

Aby uzyskać typowe nagłówki odpowiedzi, zobacz nagłówki żądań HTTP i odpowiedzi w szczegółach usługi API REST.

Ciało odpowiedzi

W przypadku powodzenia 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
  • Last updated on