Contact Us 1-800-596-4880
  1. Homepage
  2. Omni Gateway (1.13)
  3. Securing Omni Gateway Instances with Policies
  4. Inbound Policies Directory

  5. SOAP Schema Validation

SOAP Schema Validation Policy

Policy Name

SOAP Schema Validation

Summary

Validates incoming traffic against a specified WSDL schema

Category

Security

First Omni Gateway version available

v1.10.0

Release Notes

SOAP Schema Validation Policy

Returned Status Codes

The policy returns a 400 for a client error or 500 for a server error. Error messages are defined by SOAP standard responses.

Summary

The Schema Validation policy only supports SOAP 1.1 and 1.2 APIs.

Use the SOAP Schema Validation policy to block incoming requests that don’t conform to the the defined WSDL schema. This policy prevents malformed or malicious SOAP messages from reaching the backend and enforces contract compliance between clients and services.

Configuring Policy Parameters

Omni Gateway Local Mode

When you apply the policy via declarative configuration files, Refer to the following policy definition and table of parameters:

- policyRef:
    name: soap-validation
  config:
    wsdlUrl: <string> // REQUIRED
    encoding: <string> // REQUIRED, default 'UTF-8'
    serviceName: <string> // REQUIRED
    servicePort: <string> // REQUIRED

Determines if the schema is specified in this YAML resource, or if it’s specified in the API Context from Exchange (Connected Mode only). Supported values: inline or context. You must specify inline when configuring the policy in Local Mode.

Parameter Required Default Value Description

wsdlUrl

Yes

NA

URL of where to access the WSDL

encoding

Yes

UTF-8

Encoding of the WSDL

serviceName

Yes

NA

SOAP service name defined in the WSDL that validates requests

servicePort

Yes

NA

SOAP port name defined in the WSDL that validates requests

Resource Configuration Example

- policyRef:
    name: soap-validation
  config:
    wsdlUrl:
    encoding: UTF-8
    serviceName:
    servicePort:

Managed Omni Gateway and Omni Gateway Connected Mode

When you apply the policy from the UI, the following parameters are displayed:

Field Description

Service Name

SOAP service name defined in the WSDL that validates requests

Service Port

SOAP port name defined in the WSDL that validates requests

See Also