スマート カードの提案された PIN を取得する

サーバーで生成されたユーザー PIN を取得します。

重要

サーバーは、プロファイル テンプレート ポリシーで実行する必要がある場合にのみ PIN を設定します。 それ以外の場合、ユーザーは PIN を指定する必要があります。

Note

この記事の URL は、API のデプロイ中に選択されたホスト名 (例: ) を基準にしています https://api.contoso.com

Request

Method 要求 URL
GET /CertificateManagement/api/v1.0/smartcards/{id}/serverproposedpin

URL パラメーター

パラメーター 説明
id 証明書管理 (CM) Microsoft Identity ManagerにMIMスマート カード ID。 この ID は Microsft.Clm.Shared.Smartcard オブジェクトから取得されます。

クエリ パラメーター

パラメーター 説明
atr スマート カードの ATR (Answer To Reset) 文字列。
cardid スマート カード ID。
challenge スマート カードによって発行されるチャレンジを表す base-64 でエンコードされた文字列。

要求ヘッダー

一般的な要求ヘッダーについては、CM の HTTP 要求ヘッダーと応答ヘッダーに関するページREST APIを参照してください

要求本文

[なし] :

Response

このセクションでは、応答について説明します。

応答コード

コード 説明
200 [OK]
204 コンテンツはありません
403 Forbidden
500 内部エラー

応答ヘッダー

一般的な応答ヘッダーについては 、CM サービスの HTTP 要求ヘッダー と応答ヘッダーに関するページREST API を参照してください

応答本文

成功すると、サーバーによって提案された PIN を表す文字列が返されます。

このセクションでは、サーバーによって生成されたユーザー PIN を取得する例を示します。

例: 要求

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

例: 応答

HTTP/1.1 200 OK

... body coming soon