Gateway Communication node

The Gateway Communication node provides a secure communication channel with PingGateway directly from within a journey.

Compatibility

Product	Compatible?
Advanced Identity Cloud	Yes
PingAM (self-managed)	No
Ping Identity Platform (self-managed)	No

Product

Compatible?

Advanced Identity Cloud

Yes

PingAM (self-managed)

Ping Identity Platform (self-managed)

Inputs

Any data in the shared state that must be sent to PingGateway.

Dependencies

To use this node, you must configure the Gateway Communication service.

Configuration

The configurable properties for this node are:

Property Usage

Property	Usage
Identity Gateway Service	PingGateway service set up used for this communication.
IG Route	The name of the route to take when PingGateway is reached.
Mapping to Gateway	Map data sent in a JWT to PingGateway from the shared state in the journey. This is an optional property that is used only when PingGateway needs data. The key is the `Shared State Key` containing the data to map. The value is the `Claim Key Name` in the shared state sent in the claim.
Mapping from Gateway	Map data returned from PingGateway to the shared state in the journey. The key is the PingGateway key in the claim. The value is returned by PingGateway and saved to the shared state.

Identity Gateway Service

PingGateway service set up used for this communication.

IG Route

The name of the route to take when PingGateway is reached.

Mapping to Gateway

Map data sent in a JWT to PingGateway from the shared state in the journey. This is an optional property that is used only when PingGateway needs data.

The key is the Shared State Key containing the data to map.
The value is the Claim Key Name in the shared state sent in the claim.

Mapping from Gateway

Map data returned from PingGateway to the shared state in the journey.

The key is the PingGateway key in the claim.
The value is returned by PingGateway and saved to the shared state.

Outputs

Any data mapped from the claims returned by PingGateway that is stored in the shared state of the journey.

Outcomes

Success: The gateway successfully returned a valid signed and encrypted JWT.
Error: Any error that occurred during an attempt to communicate with the gateway.

Troubleshooting

If this node logs an error, review the log messages to find the reason for the error and address the issue appropriately.

Examples

This example journey highlights the use of the Gateway Communication node to authenticate internal accesses.

Advanced Identity Cloud provides sample journeys you can download to understand and address the most common Gateway Communication use cases.