次の方法で共有

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

  • [アーティクル]

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

重要

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

Note

この記事の URL は、 などの https://api.contoso.comAPI デプロイ中に選択されたホスト名に対する相対 URL です。

Request

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

URL パラメーター

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

クエリ パラメーター

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

要求ヘッダー

一般的な要求ヘッダーについては、「CM REST API サービスの詳細」の「HTTP 要求ヘッダーと応答ヘッダー」を参照してください。

要求本文

なし。

Response

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

応答コード

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

応答ヘッダー

一般的な応答ヘッダーについては、「CM REST API サービスの詳細」の「HTTP 要求ヘッダーと応答ヘッダー」を参照してください。

応答本文

成功した場合は、サーバーによって提案された 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