Skip to content

Release v1.0.0

Choose a tag to compare

@rubiii rubiii released this 06 Mar 20:53
· 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::Client loads 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, and attribute DSL 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 maxOccurs schema 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/http adapter 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