Contents
Contents

Integration Styles Integration Broker Cannot Handle

If you work with PeopleSoft long enough, you’ll eventually have a vendor or an internal architect ask you to connect to a streaming API, subscribe to a Kafka topic, or open a WebSocket.

The short answer is: don’t try to force Integration Broker to do this natively.

PeopleSoft Integration Broker is highly effective for a specific, narrow class of integrations: synchronous HTTPS request/reply with XML or JSON, plus local-to-local asynchronous queues for staging inbound payloads or propagating data between PeopleSoft databases.

Outside that sweet spot, trying to use IB is either unsupported, extremely awkward, or requires a custom proxy service to bridge the gap.

In this chapter, I want to map out the architectural boundaries of Integration Broker. We’ll examine the four root constraints of its design, catalog what doesn’t work, and discuss how to design clean edge solutions that keep PeopleSoft stable.


The Four Root Constraints of IB Design

Almost every integration failure I’ve had to clean up traces back to a developer trying to fight one of these four design constraints. Instead of memorizing a list of unsupported technologies, it is much more useful to understand these core limits:

  1. REST is Synchronous Request/Reply Only: PeopleSoft cannot hold a REST response stream open, cannot push updates to a connected REST client, and cannot consume long-lived response streams from external APIs. (For more details, see Sync versus Async).
  2. Text Payloads Only (XML or JSON): Integration Broker is built on character strings. It has no native support for binary framing protocols like Protocol Buffers, MessagePack, Avro, CBOR, or Thrift.
  3. HTTP/1.1-Era Transport Assumptions: The listening and target connectors are built around HTTP/1.1 semantics. There is no native WebSocket upgrade handler, no HTTP/2 multiplexing for server-initiated push frames, and no HTTP/3/QUIC.
  4. No Enterprise Event Substrate: The internal pub/sub queues are designed for database replication and local staging. They are not a distributed log and cannot act as a replacement for NATS, Kafka, RabbitMQ, or cloud event buses (like AWS SNS/SQS or Azure Service Bus). There are no native connectors for these platforms.

At a Glance: What Won’t Work Natively

When an architect asks if PeopleSoft can support a specific pattern, you can use this table to quickly find the root constraint and the recommended workaround:

Pattern / Protocol Root Constraint Use Instead
WebSockets (Server or Client) 1, 3 Run a small sidecar service (Node.js, Go) to host the socket; have it push data into PeopleSoft via standard REST.
Server-Sent Events (SSE) 1, 3 Terminate the SSE stream in an external proxy; relay the events into PeopleSoft using standard REST or a staging-table queue.
HTTP Long Polling (as Server) 1 This pattern burns app server worker threads. Redesign using webhooks or standard client-side polling.
Chunked / Streaming Responses 1, 3 Integration Broker buffers full responses. If the client requires incremental data, terminate the call in a gateway proxy and stream from there.
gRPC (Server or Client) 2, 3 Use an API Gateway or Envoy proxy to translate gRPC calls into standard REST/JSON before they hit PeopleSoft.
Binary Serialization (Protobuf, Avro) 2 Translate to JSON in a sidecar or gateway before sending payload to PeopleSoft.
GraphQL (as Server) 1, 2 (plus model mismatch) Build a GraphQL gateway externally; let its resolvers make targeted REST/JSON calls to PeopleSoft.
Apache Kafka Consumer / Producer 4 Write a small bridge service (or use iPaaS) to consume from Kafka and write to PeopleSoft via REST.
Enterprise Brokers (RabbitMQ, NATS) 4 Same as Kafka: run a broker-side consumer to bridge messages to PeopleSoft REST endpoints.
Inbound API Rate Limiting 1 (plus no throttling controls) Put an API Gateway (like Kong or Apigee) in front of PeopleSoft to enforce rate limits and quotas.
Developer API Portal 1 (plus no credential manager) Use an API Gateway to handle authentication, API key issuance, and developer documentation.
Real-Time UI Feeds (Chat, Dashboards) 1, 3 Let an external service manage the persistent UI connections; query PeopleSoft only when state needs to be saved.

Architectural “Smells” to Watch Out For

In design meetings, pay close attention to the language being used. If you hear any of these phrases, it is a warning sign that you are trying to force Integration Broker into the wrong role:

  • “We need a persistent connection.” WebSockets, SSE, and long-polling all depend on keeping connections open indefinitely. PeopleSoft application servers are designed for rapid, short request/reply transactions. Keeping connections open burns worker threads and can degrade performance across the entire environment.
  • “We need to push updates to the browser in real time.” PeopleSoft has no push channel to web clients. Real-time updates require a sidecar.
  • “We need to consume a Kafka topic.” PeopleSoft cannot subscribe to Kafka. A bridge service must drain the broker and POST the records to PeopleSoft.
  • “We need to enforce per-client rate limits.” PeopleSoft has no built-in API throttling. Trying to write throttling logic in PeopleCode is slow and wastes database resources. Put a reverse proxy or gateway in front.
  • “We need to expose this to third-party developers.” PeopleSoft is not an API gateway. It has no developer portal, no key rotation workflows, and no credential self-service. Put a real gateway in front of it.
  • “We need to stream large files or response bodies.” Integration Broker buffers everything in memory. Large streams will exhaust application server resources.
  • “We need a binary wire format.” No native support. Translate to JSON at the network edge.

The takeaway is simple: PeopleSoft should own the transactional data, not the protocol terminations. If an integration requires a modern protocol, terminate it at a gateway, sidecar, or broker consumer, and let that component call PeopleSoft over standard REST/JSON.


What Integration Broker Is Good At

Lest this seem like a total indictment of the tool, there is a large class of integrations where Integration Broker is absolutely the right choice:

  • Synchronous REST/JSON APIs: Inbound REST service operations for standard transactional operations (e.g., “create a profile,” “update a record”) are right in IB’s wheelhouse. (See REST Services).
  • Scheduled Outbound REST Calls: An Application Engine running on a schedule, calling a vendor REST API, and processing the results. The Slate Dual Enrollment Case Study is a textbook example.
  • PeopleSoft-to-PeopleSoft Async Replication: Delivered services like USER_PROFILE and PERSON_BASIC_SYNC are exactly what the internal publish/subscribe queue was designed to do.
  • The Staged-Webhook Receiver Pattern: An inbound webhook hits PeopleSoft, the handler immediately writes the raw payload to a staging table and returns 200 OK, and a separate async process processes the staging table. This is the gold standard for handling long-running work triggered by external HTTP calls.

Author Profile
Chris Malek

Chris Malek is a PeopleTools® Technical Consultant with over two decades of experience. He is available for consulting engagements.

Work with Chris
Subscribe to Updates
SWS Bolt-On
PeopleSoft Simple Web Services

SWS turns SQL into production REST APIs — ready for AI, modern apps, and partner integrations. One install, unlimited potential.

  • Configuration-driven, no coding required
  • JSON, XML, and CSV output
  • Works across all PeopleSoft pillars
  • Built on 25+ years of PeopleSoft expertise
Read More & Purchase
SWS Bolt-On
PeopleSoft Simple Web Services

A powerful PeopleSoft bolt-on that makes REST web services easy. You bring the SQL, SWS handles the rest.

  • Go from idea to production in minutes
  • Zero code migrations after install
  • JSON, XML, and CSV output supported
  • No PeopleCode or Integration Broker expertise required
Read More & Purchase
SWS Bolt-On
PeopleSoft Simple Web Services

Traditional PeopleSoft web services cost $3,600–$13,000 each to develop. SWS deploys production REST APIs in under 5 minutes through configuration alone.

  • No PeopleCode or Integration Broker expertise required
  • Works across Campus Solutions, HCM, and Financials
  • Built-in pagination, caching, and nested data structures
  • Trusted by institutions across higher education and government
Read More & Purchase
SWS Bolt-On
PeopleSoft Simple Web Services

Turn PeopleSoft data into clean REST APIs for AI integrations, modern applications, and vendor data feeds. Configuration-driven — no PeopleCode required.

  • Deploy production APIs in under 5 minutes
  • AI and LLM ready (RAG, chatbots, intelligent search)
  • JSON, XML, and CSV output
  • Zero modifications to delivered PeopleSoft objects
Read More & Purchase
psLens Platform
psLens Operations & Intelligence

Look up any record, field, page, or component, audit security, and monitor Integration Broker across every database — in seconds.

  • 30+ object types browsable
  • 16 real-time alert types
  • Read-only by design
  • No App Designer or SQL required
Learn More
psLens Platform
psLens Operations & Intelligence

A web console built for the PeopleSoft community — operational monitoring, security auditing, and metadata browsing in one tool.

  • Sub-second object search
  • Catch stuck IB messages before users do
  • Audit service permissions from one screen
  • Works in any browser
Learn More
psLens Platform
psLens Operations & Intelligence

On-demand security and operational reports for your PeopleSoft environment — no client install required.

  • 14 on-demand reports
  • Markdown export for AI/LLM workflows
  • No shared tenancy
  • Built on 25+ years of PeopleSoft expertise
Learn More
psLens Platform
psLens Operations & Intelligence

Research any PeopleSoft object and monitor system health from a single browser tab — no App Designer, no SQL.

  • 30+ PeopleSoft object types browsable
  • Real-time alerts before users report problems
  • Read-only and secure
  • Private alpha — early access now
Learn More