Werken bij MCX
nlEnglish
Zoeken

Blogs

PeopleSoft Integration Broker en SNI: een nieuwe optie in PeopleTools 8.62

27-01-2026
PeopleSoft Integration Broker (IB) had jarenlang een bekende beperking bij het uitvoeren van outbound HTTPS calls naar servers die SNI (Server Name Indication) vereisen. Standaard resolveert IB hostnames naar IP-adressen voordat de TLS handshake wordt opgezet. Hoewel dit in veel situaties werkt, voorkomt deze aanpak dat Java de hostname meestuurt in de TLS handshake. Hierdoor falen verbindingen naar endpoints waarvoor SNI verplicht is, iets wat steeds vaker voorkomt in moderne cloudomgevingen.

Historisch gezien was hiervoor een workaround nodig via het bestand integrationGateway.properties, waarbij alle service operation aliases die SNI vereisten expliciet moesten worden opgegeven:

ig.UseDomainName.ExternalOperationNames=MYSOP1.v1, MYSOP2.v1

Met deze instelling behield IB de hostname voor deze specifieke outbound calls, waardoor SNI correct werd ondersteund.

De nieuwe aanpak in PeopleTools 8.62

PeopleTools 8.62 introduceert een eenvoudigere en robuustere manier om met SNI om te gaan.

Nieuwe globale property: ig.UseDomainName

# By default, hostnames in URLs are converted to IP addresses in Integration Gateway.

# Setting this property to TRUE instructs Integration Gateway to use domain names for all HTTP/HTTPS connections,

# unless overridden by an individual HTTP Target Connector property (Use-DomainName=N).

ig.UseDomainName=TRUE

Voordelen van deze nieuwe optie

  • Het is niet langer nodig om een lange lijst met service operation aliases te onderhouden in
  • ig.UseDomainName.ExternalOperationNames.
  • De hostname wordt automatisch behouden voor alle outbound HTTPS calls, waardoor SNI support standaard werkt waar nodig.
  • Vereenvoudigt de configuratie en verlaagt de onderhoudslast, vooral in omgevingen met veel service operations.

Legacy optie blijft beschikbaar

Voor selectief gebruik blijft de bestaande property ondersteund:
ig.UseDomainName.ExternalOperationNames=MYSOP1.v1,MYSOP2.v1

  • Hiermee kan domain-name usage per specifieke integratie worden ingeschakeld.
  • Waarden zijn comma-separated, zonder spaties.

Stappen om de feature te activeren

    1. Open het bestand integrationGateway.properties.
    2. Voeg de nieuwe property toe of werk deze bij: ig.UseDomainName=TRUE
    3. (Optioneel) Voeg service operation aliases toe via de legacy property: ig.UseDomainName.ExternalOperationNames=
    4. Restart de Integration Gateway web server om de wijzigingen toe te passen.

images.png