Repository navigation
Release v1.0.0
·
196 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
Initial public release.
Client and Service Inspection
WSDL::Clientloads WSDL 1.1 documents from URLs or file paths- Auto-discover services, ports, and operations
- Convenience shortcuts for single-service/single-port WSDLs
- Introspect operation contracts with schema-aware type information
- Generate request templates (minimal or full) for quick prototyping
- WSDL 2.0 documents are detected and rejected with a clear error
WSDL and XSD Parsing
- Full WSDL 1.1 parsing with recursive XSD import/include resolution
- Strict and relaxed schema import modes for incomplete or malformed schemas
- In-memory LRU cache with configurable TTL and max entries for parsed definitions
- Sandbox path restrictions to prevent path traversal attacks
- Configurable iteration limits for schema import cycles
Request DSL and Serialization
- Fluent DSL via
operation.prepare { ... }for building SOAP envelopes tag,text,cdata,comment,pi,xmlns, andattributeDSL methods- Request validation against schema contracts (strict and relaxed modes)
- SOAP 1.1 and 1.2 envelope serialization with automatic namespace handling
- Support for document/literal and rpc/literal operation styles
- Element count, attribute count, and depth limits enforcement
Response Parsing
- Schema-aware type coercion (numeric, boolean, date/time, Base64 binary)
- Smart array handling based on
maxOccursschema metadata - SOAP fault detection and structured parsing for SOAP 1.1 and 1.2
- Raw XML and XPath query access with namespace mapping
- Configurable response size limits to prevent DoS
WS-Security
- UsernameToken authentication with plain text and SHA-1 digest modes
- Timestamps with configurable TTL and optional signing
- X.509 certificate signing with RSA and EC key support
- Configurable digest algorithms: SHA-1, SHA-256, SHA-512 (SHA-256 default)
- Three key reference methods: BinarySecurityToken, IssuerSerial, SubjectKeyIdentifier
- Response verification pipeline with three modes:
disabled,if_present,required - Signature verification with timing-safe digest comparison
- Certificate chain validation against configurable trust stores
- Timestamp freshness validation with clock skew tolerance
Security Hardening
- XML safety: DOCTYPE rejection, NONET parsing, entity expansion prevention
- Threat detection: pre-parse scanning for ENTITY, SYSTEM/PUBLIC, deep nesting, and attribute bombing
- XSW attack protection: duplicate ID detection, signature location validation, element position checks
- XPath injection prevention: NCName validation before ID interpolation into XPath queries
- Algorithm whitelisting: unknown algorithms raise
UnsupportedAlgorithmError(no silent fallbacks) - SSRF prevention: redirect target validation with DNS resolution checks and private network blocking
HTTP
- Stdlib
net/httpadapter with no external HTTP dependencies - HTTPS-only by default with configurable TLS settings
- Redirect following with SSRF-safe target validation
- Transparent gzip decompression disabled to prevent gzip bomb attacks
- Configurable timeouts and response size limits
Configuration and Limits
- Global and per-client configuration with thread-safe defaults
- 11 configurable resource limits (document size, schema count, nesting depth, and more)
- Pluggable logger (defaults to silent
NullLogger) - Pluggable HTTP adapter and cache implementations
Dependencies
- nokogiri (>= 1.19.1) for XML parsing and C14N
- base64 for encoding/decoding
- All cryptography delegated to Ruby's built-in OpenSSL