指定されたIDをもとに保存されている検証結果を取得します。

保存される情報

署名検証を行うと、その結果が自動的に保存されます。
ただし、証明書に記載された情報(certificate_content)は当該APIを実行したときのみに返されます。このAPIを使用して後から結果を取得した際には返されません。

利用者IDの紐付け

署名検証時に利用者の特定を要求せず、利用者IDが割り当てられなかった場合であっても、
別の署名検証時や失効確認時に利用者特定が要求され、証明書に紐付く利用者が特定された場合には、当該証明書にも新しく割り当てられた利用者IDが紐付けられます。

したがって、情報が保存された際には利用者IDが紐付けられていない場合であっても、本APIによる取得時には利用者IDが存在している場合があります。

リクエストとレスポンスの詳細

Response

🟢200OK

application/json

Body

verification

object (Verification)

必須

検証結果

string <uuid>

必須

検証ID

result

enum<string>

必須

RESULT_OK: 検証成功

RESULT_SIGNATURE_MISMATCH: 検証失敗（署名不一致のため）

RESULT_CERTIFICATE_REVOKED: 検証失敗（証明書が失効していたため）

RESULT_CERTIFICATE_EXPIRED: 検証失敗（証明書の有効期限切れのため）

列挙型:

RESULT_UNSPECIFIEDRESULT_OKRESULT_SIGNATURE_MISMATCHRESULT_CERTIFICATE_REVOKEDRESULT_CERTIFICATE_EXPIRED

デフォルト値:

RESULT_UNSPECIFIED

hash_algorithm

enum<string>

必須

ダイジェストの作成に利用したハッシュ関数

列挙型:

sha256sha384sha512

digest

string <byte>

必須

署名対象データのダイジェスト（Base64エンコード文字列）

signature

string <byte>

必須

署名値（Base64エンコード）

created_at

string <date-time>

必須

検証時刻

certificate

object (Certificate)

可選

証明書データ

string <uuid>

必須

証明書ID

type

enum<string>

必須

証明書種別

列挙型:

jpki_card_digital_signaturejpki_card_user_authentication

latest

boolean

必須

現行世代の証明書かどうか

各利用者ごとに、同じ種別の証明書のうち最も発行された順番が新しいものを現行世代と呼び、それ以外の証明書は旧世代と呼びます。
証明書に紐付く利用者が特定されていない場合、旧世代の証明書として扱います。

created_at

string <date-time>

必須

証明書情報が保存された時刻

certificate_status

object (CertificateStatus)

可選

証明書失効状態の確認結果

string <uuid>

必須

証明書失効確認ID

status

enum<string>

必須

証明書の失効状態

列挙型:

goodrevoked

check_method

enum<string>

必須

証明書の失効状態を確認する手段

列挙型:

crlocsp

check_purpose

enum<string>

必須

証明書の失効状態を確認する目的

列挙型:

signature_verificationliveness_check

source_updated_at

string <date-time>

可選

証明書失効状態の確認に利用したデータソースの更新日時

CRLやOCSPレスポンスに含まれる thisUpdate に相当します。
CRLにシリアル番号が含まれない場合は設定されません。

revoked_at

string <date-time>

可選

失効した日時

失効していない場合は設定されません。

revocation_reason

enum<string>

可選

証明書の失効理由

この値は、RFC 5280 5.3.1に定義されるCRLReasonに対応します。
証明書が有効である場合には設定されません。

列挙型:

unspecifiedkey_compromiseca_compromiseaffiliation_changedsupersededcessation_of_operationcertificate_holdremove_from_crlprivilege_withdrawnaa_compromise

created_at

string <date-time>

必須

失効確認を行った時刻

user

object (User)

可選

利用者データ

string <uuid>

必須

利用者ID

created_at

string <date-time>

必須

利用者情報が保存された時刻

例

{
    "verification": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "result": "RESULT_UNSPECIFIED",
        "hash_algorithm": "sha256",
        "digest": "string",
        "signature": "string",
        "created_at": "2019-08-24T14:15:22Z"
    },
    "certificate": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "type": "jpki_card_digital_signature",
        "latest": true,
        "created_at": "2019-08-24T14:15:22Z"
    },
    "certificate_status": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "status": "good",
        "check_method": "crl",
        "check_purpose": "signature_verification",
        "source_updated_at": "2019-08-24T14:15:22Z",
        "revoked_at": "2019-08-24T14:15:22Z",
        "revocation_reason": "unspecified",
        "created_at": "2019-08-24T14:15:22Z"
    },
    "user": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "created_at": "2019-08-24T14:15:22Z"
    }
}

🟠400400

🟠401401

🟠404404

🔴500500

署名検証結果の取得

保存される情報

利用者IDの紐付け

リクエストとレスポンスの詳細

Requestパラメータ

サンプルコード

Response

署名検証結果の取得

保存される情報#

利用者IDの紐付け#

リクエストとレスポンスの詳細#

Requestパラメータ

サンプルコード

Response

保存される情報

利用者IDの紐付け

リクエストとレスポンスの詳細