시작하기 전에
- 인증서 유효성 확인 API

인증서 유효성 확인하기

인증 과정에서 사용된 토스인증서가 유효한 상태인지 확인할 수 있어요. 토스인증 연동에서 반드시 확인해야 되는 정보는 아니지만 필요에 따라 활용이 가능합니다.

시작하기 전에

토스인증을 완료합니다.
결과조회 API에서 확인한 signature를 SIGNED_DOC="" 따옴표 안에 채워넣습니다. (일반, 복수 전자서명은 signedDoc으로 확인합니다.)
전체를 복사한 뒤 터미널을 실행시켜 입력하고, 다음의 명령어를 실행합니다.
echo $SIGNED_DOC | openssl base64 -d -A | openssl pkcs7 -print_certs -inform DER | openssl x509
변환된 PEM 형식의 데이터를 확인합니다.

터미널 명령어 확인하기

인증서 유효성 확인 API

토스인증서의 유효성을 확인합니다.

EndPoint

POST /api/v1/certificate/validate

요청

curl --location --request POST 'https://cert.toss.im/api/v1/certificate/validate' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJraWQiOiJjZXJ0IiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiJ0ZXN0X2E4ZTIzMzM2ZDY3M2NhNzA5MjJiNDg1ZmU4MDZlYjJkIiwiYXVkIjoidGVzdF9hOGUyMzMzNmQ2NzNjYTcwOTIyYjQ4NWZlODA2ZWIyZCIsIm5iZiI6MTY0OTIyMjk3OCwic2NvcGUiOlsiY2EiXSwiaXNzIjoiaHR0cHM6XC9cL2NlcnQudG9zcy5pbSIsImV4cCI6MTY4MDc1ODk3OCwiaWF0IjoxNjQ5MjIyOTc4LCJqdGkiOiI4MDNjNDBjOC1iMzUxLTRmOGItYTIxNC1iNjc5MmNjMzBhYTcifQ.cjDZ0lAXbuf-KAgi3FlG1YGxvgvT3xrOYKDTstfbUz6CoNQgvd9TqI6RmsGZuona9jIP6H12Z1Xb07RIfAVoTK-J9iC5_Yp8ZDdcalsMNj51pPP8wso86rn-mKsrx1J5Rdi3GU58iKt0zGr4KzqSxUJkul9G4rY03KInwvl692HU19kYA9y8uTI4bBX--UPfQ02G0QH9HGTPHs7lZsISDtyD8sB2ikz5p7roua7U467xWy4BnRleCEWO2uUaNNGnwd7SvbjhmsRZqohs9KzDUsFjVhSiRNdHL53XJQ5zFHwDF92inRZFLu6Dw8xttPtNHwAD1kT84uXJcVMfEHtwkQ' \
--data-raw '{
          "certificate" : "-----BEGIN CERTIFICATE-----\nMIIGIDCCBAigA...(중간생략)...wIBAgIDJEsaMA0GCSqGSIb3DQEBCwUAMFExCzAJBgNVBAYMAktS\nMRswGQYDVQQKDBJWaXZhIFJlcHVibGljYSBJbmMxEjAQBgNVBAsMCVRvc3MgQ2Vy\ndDERMA8GA1UEAwwIVG9zcyBDQTEwHhcNMjExMjE1MTM0NjA0WhcNMjQxMjE0MTQ1\nOTU5WjB8MQswCQYDVQQGEwJLUjEbMBkGlcnQxKDAmBgoJkiaJk/IsZAEBDBg3MDAyNzIzMjAy\nMTExMzA4MDTB7Yd3+p9qcw2mKxP2252UViBXbwnMIOIXzJX5tdefNVZSZ1OIBP5\n-----END CERTIFICATE-----"
    }'

요청 헤더

certificate 필수 · String
PEM형식의 유효성 확인이 필요한 인증서

성공응답

{
  "resultType": "SUCCESS",
  "success": {
    "valid": true,
    "enabled": true
  }
}

JSON

실패응답

{
  "resultType": "FAIL",
  "error": {
    "errorType": 0,
    "errorCode": "CE1000",
    "reason": "토큰이 유효하지 않습니다.",
    "data": {},
    "title": null
  },
  "success": null
}

JSON

응답 파라미터

valid 필수 · Boolean
인증서의 유효 여부
- true : 유효한 인증서
- false: 유효기간 만료 혹은 삭제된 인증서
enabled 필수 · Boolean
인증서의 현재 이용 여부
- true : 사용중인 인증서
- false: 사용되지 않는 인증서