スマート カード認証応答を取得する
基本暗号化サービス プロバイダー (CSP) 認証チャレンジへの応答を取得します。
注意
この記事の URL は、API のデプロイ中に選択されたホスト名 (など https://api.contoso.com) に対して相対的です。
Request
| Method | 要求 URL |
|---|---|
| GET | /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}/authenticationresponse |
URL パラメーター
| パラメーター | 説明 |
|---|---|
| reqid | 必須です。 Microsoft Identity Manager (MIM) 証明書管理 (CM) に固有の要求識別子。 |
| scid | 必須です。 MIM CM に固有のスマート カード識別子。 scid は、 Microsoft.Clm.Shared.Smartcards.Smartcard オブジェクトから取得されます。 |
クエリ パラメーター
| パラメーター | 説明 |
|---|---|
| atr | 省略可能。 スマート カードの ATR (Answer To Reset) 文字列。 |
| cardid | 必須です。 スマート カード ID。 |
| challenge | 必須です。 スマート カードによって発行される課題を表す base-64 でエンコードされた文字列。 |
| diversified | 必須です。 スマート カード管理キーが分散されたかどうかを示すブール型 (Boolean) フラグ。 |
要求ヘッダー
一般的な要求ヘッダーについては、「CM REST API サービスの詳細」の HTTP 要求ヘッダーと応答ヘッダーに関するページを参照してください。
要求本文
なし。
Response
このセクションでは、応答について説明します。
応答コード
| コード | 説明 |
|---|---|
| 200 | OK |
| 204 | コンテンツはありません |
| 403 | Forbidden |
| 500 | 内部エラー |
応答ヘッダー
一般的な応答ヘッダーについては、「CM REST API サービスの詳細」の HTTP 要求ヘッダーと応答ヘッダーに関するページを参照してください。
応答本文
成功すると、チャレンジ応答を示すバイト BLOB が返されます。
例
このセクションでは、基本的な CSP 認証チャレンジへの応答を取得する例を示します。
例: 要求
GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9/authenticationresponse?cardid=bc88f13f-83ba-4037-8262-46eba1291c6e&challenge=1hFD%2Bcz%2F0so%3D&diversified=False HTTP/1.1
例: 応答
HTTP/1.1 200 OK
"F0Zudm4wPLY="