DataPower Gateway

유효성 검증 - DataPower Gateway (v5 compatible)

온라인에서 편집하기

유효성 검증 정책을 사용하여 어셈블리 플로우의 페이로드를 JSON 또는 XML 스키마에 대해 유효성 검증하십시오.

게이트웨이 지원

참고: 이 주제에서는 DataPower® Gateway (v5 compatible)의 유효성 검증 정책 구현에 대해 설명합니다. 를 사용하고 DataPower API Gateway계신다면, Validate - DataPower API Gateway 를 참조하십시오.

다른 유형의 게이트웨이에 대한 정보는 API Connect 게이트웨이 유형을 참조하십시오.

표 1. 이 정책을 지원하는 게이트웨이와 해당 정책 버전을 보여주는 표
게이트웨이 정책 버전
DataPower Gateway (v5 compatible) 1.0.0

이 항목에서는 어셈블리 사용자 인터페이스에서 정책을 구성하는 방법을 설명합니다. OpenAPI 소스에서 정책을 구성하는 방법에 대한 자세한 내용은 validate - DataPower Gateway ( v5 호환) 을 참조하십시오.

제한사항:
  • XML을 나타내는 스키마는 하나의 XML 네임스페이스만 참조할 수 있습니다.
  • 스카마는 다형 XML 요소를 참조할 수 없습니다.
  • 유효성 검증이 output/context 변수가 아니라 message.body 변수에서 작동합니다. 호출 정책이 구성된 응답 오브젝트 변수를 포함한 경우 message.body가 설정되지 않고 유효성 검증을 수행할 수 없습니다.
  • API를 위한 스키마 정의에서 multipleOf 키워드를 사용하는 경우 반올림 동작으로 인해 지정된 값은 다음의 조건을 충족해야 합니다. 그렇지 않으면 API가 호출될 때 유효성 검증에 실패합니다.
    • 값은 0.000000999999999999999848869 미만이지 않아야 합니다.
    • 값이 1 이상인 경우, 10진수 위치 앞의 양이 999999999999999934463 보다 크지 않아야 합니다.

정보

이 정책을 다음 API 플로우에 첨부할 수 있습니다.
  • REST
다음과 같이 어셈블리 플로우에서 필요한 위치에 이 정책을 배치하십시오.
  • 원래 입력의 유효성을 검증하려면 플로우의 시작 부분에 유효성 검증 정책을 배치하십시오.
  • 다른 호출 조치 또는 태스크에서 리턴되는 중간 응답의 유효성을 검증하려면 해당 조치 또는 태스크 뒤에 유효성 검증 정책을 배치하십시오.
  • 클라이언트 애플리케이션에 리턴되는 응답의 유효성을 검증하려면 응답을 조합하는 태스크 뒤에 유효성 검증 정책을 배치하십시오.

API 레벨에서 지정된 스키마 정의 세트에서 선택하거나 조작 레벨에서 스키마 정의를 선택하여 각 유효성 검증 정책에 다른 OpenAPI 스키마 정의를 적용할 수 있습니다.

특성

다음 표에서는 정책 특성을 나열하고, 특성이 필수인지 여부를 표시하며, 올바른 입력 값과 기본 입력 값을 지정하고, 값의 데이터 유형을 지정합니다.

표 2. 정책 속성 확인
특성 레이블 필수 설명 데이터 유형
제목 예 해당 정책의 제목입니다.

기본값은 validate입니다.

 문자열
설명 아니오 정책의 설명입니다. 문자열
정의 예 페이로드의 유효성을 검증하는 데 사용할 스키마 정의를 지정합니다.
유효 값:
  • request: 이 오퍼레이션의 요청 매개변수에 대해 유형 필드에 지정된 스키마 정의와 비교하여 요청 입력의 유효성을 검증하려면 이 값을 선택하십시오. 요청 매개변수를 작성하는 방법에 대한 정보는 조작 구성을 참조하십시오.
  • response: 이 오퍼레이션의 응답 매개변수에 대해 스키마 필드에 지정된 스키마 정의와 비교하여 클라이언트 애플리케이션에 리턴될 응답의 유효성을 검증하려면 이 값을 선택하십시오. 응답 매개변수 작성 방법에 대한 정보는 조작 구성을 참조하십시오.
  • #/definitions/definition_name: 어셈블리 플로우의 다른 호출 조치 또는 태스크에서 리턴되는 페이로드의 유효성을 검증하는 데 사용될 이전에 정의된 스키마 정의의 경우 이 값을 선택하십시오. API 정의의 스키마 정의에 대한 정보는 API 정의 편집을 참조하십시오.
 문자열