Belajar SOAP - Integrasi SOAP dengan API Gateway & ESB

#Pendahuluan

Setelah di episode 19 kita memetakan kapan memilih SOAP, sekarang kita letakkan service SOAP di dalam arsitektur yang lebih besar: di belakang API gateway dan di tengah aliran ESB / message broker. Service SOAP jarang berdiri sendiri — ia biasanya salah satu node dari jaringan integrasi yang kompleks.

Mengapa penting? Karena gateway dan broker bukan sekadar "pemanis arsitektur" — mereka membawa kapabilitas yang sulit dibangun di setiap service: rate limiting terpusat, autentikasi satu pintu, monitoring lintas service, dan pola integrasi asinkron. Dengan memahaminya, kalian bisa menempatkan SOAP di posisi yang paling sehat dalam enterprise.

#SOAP di Belakang API Gateway

API gateway adalah satu pintu masuk yang melindungi semua service — termasuk SOAP. Keuntungan meletakkan SOAP di belakang gateway:

#Contoh: rate limiting di belakang gateway

routes:
  - id: soap-bank
    uri: http://bank-service:8080/bank
    predicates:
      - Path=/soap/bank/**
    filters:
      - name: RequestRateLimiter
        args:
          redis-rate-limiter.replenishRate: 20
          redis-rate-limiter.burstCapacity: 40
          key-resolver: "#{@mitraKeyResolver}"
    metadata:
      protocol: soap-1.1

Request mitra melewati rate limiter berbasis identitas mitra. Saat batas tercapai, gateway membalas 429 Too Many Requests sebelum request membebani service — persis tema "keadilan antar mitra" dari episode 12, kini terpusat.

#ESB dan Message Broker

Untuk integrasi asinkron dan transformasi kompleks, SOAP masuk ke ESB (Enterprise Service Bus) atau message broker:

#Apache Camel

Apache Camel adalah framework integrasi yang memakai routing rules — sangat natural untuk memproses pesan SOAP/XML:

Route Camel untuk SOAP

from("jetty:http://0.0.0.0:8181/bank")
  .process(exchange -> {
      // log / transformasi payload SOAP
      String body = exchange.getMessage().getBody(String.class);
      LOG.info("Request SOAP masuk: {}", body);
  })
  .to("https://bank-service:8080/bank")
  .process(exchange -> {
      // tambahkan correlation header untuk response
  });

#WSO2 Micro Integrator

WSO2 (ESB open-source) menangani SOAP secara native: proxy services, transformasi dengan XSLT, dan konfigurasi via XML/Data Integration Studio. Cocok untuk organisasi yang ingin ESB terkelola dengan UI.

#Apache Kafka sebagai Broker

SOAP over HTTP bersifat sinkron; untuk pola event-driven, pesan SOAP bisa dikirim sebagai event ke Kafka:

Service SOAP -> Produces JSON/XML event ke topic "claims"
Fraud detection -> Consumes event, menganalisis
Reporting -> Consumes event yang sama, tanpa panggil service

Keuntungan: banyak konsumen membaca event yang sama tanpa blokir; service bisa di-scale dan di-remote secara independen. Detail lengkap ada di series learn-apache-kafka.

#Ekspos SOAP ke Internal via Broker

Pola praktis: SOAP service yang dulu hanya bisa dipanggil langsung kini di-proxy lewat broker agar konsumen internal memakai transport yang seragam (misal via Kafka atau via REST facade):

1. Service SOAP tetap berjalan sebagai source of truth.
2. Broker (Camel/WSO2) berlangganan ke service — secara sinkron atau via event.
3. Konsumen internal berbicara ke broker, bukan langsung ke service SOAP.
4. Saat service SOAP dimatikan/migrasi, konsumen internal tidak terpengaruh — mereka hanya kenal broker.

Ini langkah pertama modernisasi yang aman (jalan menuju episode 21).

#Strategi Modernisasi Bertahap

Mengintegrasikan SOAP dengan gateway/ESB adalah setengah jalan menuju modernisasi. Roadmap bertahap yang bisa langsung diterapkan:

#Penutup

Inti yang harus dibawa pulang:

• API gateway memberi rate limit, auth, monitoring, routing, dan translasi — terpusat, bukan per-service.
• ESB (WSO2, Apache Camel) merutekan dan mentransformasi pesan SOAP; Kafka menyalurkannya sebagai event untuk pola asinkron.
• Ekspos SOAP ke internal lewat broker me-decouple konsumen dari service — langkah awal modernisasi.
• Roadmap bertahap: gateway → REST facade → broker → migrasi — setiap tahap bernilai sendiri.
• Defense in depth: kapabilitas gateway tidak menggantikan RBAC di service.

Di episode 21 selanjutnya kita akan membahas modernisasi: SOAP ke REST & migrasi strategis — pola strangler dan parallel run, pemetaan WSDL ke OpenAPI, translator layer, dan cara menjaga backward compatibility tanpa downtime. Sampai jumpa di episode 21!