verify - verify

참조

Service:: Key Vault

API Version:: 7.4

지정된 키를 사용하여 서명을 확인합니다.
VERIFY 작업은 Azure Key Vault 저장된 대칭 키에 적용할 수 있습니다. VERIFY는 Azure Key Vault에 저장된 비대칭 키의 경우에는 반드시 수행할 필요가 없습니다. 키의 공개 부분을 사용하면 서명 확인을 수행할 수 있기 때문입니다. 그러나 이 작업은 키 참조만 있고 키의 공개 부분은 없는 호출자를 위한 편의 기능으로 지원됩니다. 이 작업을 수행하려면 키/확인 권한이 필요합니다.

POST {vaultBaseUrl}/keys/{key-name}/{key-version}/verify?api-version=7.4

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
key-name	path	True	string	키의 이름입니다.
key-version	path	True	string	키의 버전입니다.
vaultBaseUrl	path	True	string	자격 증명 모음 이름(예 https://myvault.vault.azure.net: )입니다.
api-version	query	True	string	클라이언트 API 버전입니다.

요청 본문

Name	필수	형식	Description
alg	True	JsonWebKeySignatureAlgorithm	서명/확인 알고리즘입니다. 가능한 알고리즘 형식에 대한 자세한 내용은 JsonWebKeySignatureAlgorithm을 참조하세요.
digest	True	string	서명에 사용되는 다이제스트입니다.
value	True	string	확인할 서명입니다.

응답

Name	형식	Description
200 OK	KeyVerifyResult	확인 결과입니다.
Other Status Codes	KeyVaultError	작업이 실패한 이유를 설명하는 오류 응답을 Key Vault.

예제

Verify

Sample Request

HTTP

POST https://myvault.vault.azure.net//keys/testkey/9885aa558e8d448789683188f8c194b0/verify?api-version=7.4

{
  "alg": "RS512",
  "value": "RUE3Nzg4NTQ4QjQ5RjFFN0U2NzAyQzhDNEMwMkJDOTA1MTYyOTUzNjI5NDhBNzZDQTlFOTM1NDA2M0ZGMjk2Mg",
  "digest": "aKFG8NXcfTzqyR44rW42484K_zZI_T7zZuebvWuNgAoEI1gXYmxrshp42CunSmmu4oqo4-IrCikPkNIBkHXnAW2cv03Ad0UpwXhVfepK8zzDBaJPMKVGS-ZRz8CshEyGDKaLlb3J3zEkXpM3RrSEr0mdV6hndHD_mznLB5RmFui5DsKAhez4vUqajgtkgcPfCekMqeSwp6r9ItVL-gEoAohx8XMDsPedqu-7BuZcBcdayaPuBRL4wWoTDULA11P-UN_sJ5qMj3BbiRYhIlBWGR04wIGfZ3pkJjHJUpOvgH2QajdYPzUBauOCewMYbq9XkLRSzI_A7HkkDVycugSeAA"
}

Sample Response

Status code:: 200

{
  "value": true
}

정의

Name	Description
Error	키 자격 증명 모음 서버 오류입니다.
JsonWebKeySignatureAlgorithm	서명/확인 알고리즘 식별자입니다. 가능한 알고리즘 형식에 대한 자세한 내용은 JsonWebKeySignatureAlgorithm을 참조하세요.
KeyVaultError	키 자격 증명 모음 오류 예외입니다.
KeyVerifyParameters	키 확인 매개 변수입니다.
KeyVerifyResult	키 확인 결과입니다.

Error

키 자격 증명 모음 서버 오류입니다.

Name	형식	Description
code	string	오류 코드입니다.
innererror	Error	키 자격 증명 모음 서버 오류입니다.
message	string	오류 메시지입니다.

JsonWebKeySignatureAlgorithm

서명/확인 알고리즘 식별자입니다. 가능한 알고리즘 형식에 대한 자세한 내용은 JsonWebKeySignatureAlgorithm을 참조하세요.

Name	형식	Description
ES256	string	에 설명된 https://tools.ietf.org/html/rfc7518대로 P-256 및 SHA-256을 사용하는 ECDSA
ES256K	string	에 설명된 대로 P-256K 및 SHA-256을 사용하는 ECDSA https://tools.ietf.org/html/rfc7518
ES384	string	에 설명된 대로 P-384 및 SHA-384를 사용하는 ECDSA https://tools.ietf.org/html/rfc7518
ES512	string	에 설명된 대로 P-521 및 SHA-512를 사용하는 ECDSA https://tools.ietf.org/html/rfc7518
PS256	string	에 설명된 대로 SHA-256 및 MGF1을 SHA-256과 함께 사용하는 RSASSA-PSS https://tools.ietf.org/html/rfc7518
PS384	string	에 설명된 대로 SHA-384 및 MGF1과 SHA-384를 사용하는 RSASSA-PSS https://tools.ietf.org/html/rfc7518
PS512	string	에 설명된 대로 SHA-512 및 MGF1을 SHA-512와 함께 사용하는 RSASSA-PSS https://tools.ietf.org/html/rfc7518
RS256	string	에 설명된 대로 SHA-256을 사용하는 RSASSA-PKCS1-v1_5 https://tools.ietf.org/html/rfc7518
RS384	string	에 설명된 대로 SHA-384를 사용하는 RSASSA-PKCS1-v1_5 https://tools.ietf.org/html/rfc7518
RS512	string	에 설명된 대로 SHA-512를 사용하는 RSASSA-PKCS1-v1_5 https://tools.ietf.org/html/rfc7518
RSNULL	string	예약됨

KeyVaultError

키 자격 증명 모음 오류 예외입니다.

Name	형식	Description
error	Error	키 자격 증명 모음 서버 오류입니다.

KeyVerifyParameters

키 확인 매개 변수입니다.

Name	형식	Description
alg	JsonWebKeySignatureAlgorithm	서명/확인 알고리즘입니다. 가능한 알고리즘 형식에 대한 자세한 내용은 JsonWebKeySignatureAlgorithm을 참조하세요.
digest	string	서명에 사용되는 다이제스트입니다.
value	string	확인할 서명입니다.

KeyVerifyResult

키 확인 결과입니다.

Name	형식	Description
value	boolean	서명이 확인되면 True이고, 그렇지 않으면 false입니다.

Share via