Mediator
A mediator is a DIDComm relay that accepts and forwards DIDComm v2.1 messages on behalf of this gateway. When the gateway cannot be reached directly, for example in private networks or NAT environments, a mediator acts as a publicly reachable forwarding point.
For conceptual background on G2G routing and why mediators are needed, see Gateways. For step-by-step setup, see Connect two gateways.
Overview tab fields
| Setting | Required | Editable | Description |
|---|---|---|---|
| Name | Yes | Yes | Human-readable label for this mediator. Used as a display identifier across the dashboard. |
| Description | No | Yes | Optional free-text description of the mediator’s purpose or operator. |
| DID | Yes | Yes | The DID of the mediator service. The gateway uses this to resolve the mediator’s DIDComm endpoint and route outbound messages through it. |
| Status | — | Yes | Whether this mediator is active. See Status values. |
Status values
| Status | Meaning |
|---|---|
| Active | The mediator is enabled. The gateway routes DIDComm messages through it when it is selected for an outbound connection. |
| Disabled | The mediator is disabled. Outbound routes that reference this mediator will not resolve. Existing connection points that use it stop receiving messages until the mediator is re-enabled or replaced. |
Disabling a mediator does not delete it. The record is preserved so it can be re-enabled without re-entering the DID.
Metadata
The gateway records the creation and last-update timestamps for each mediator. These fields are read-only and are displayed in the mediator detail view.
| Field | Description |
|---|---|
| Mediator ID | Internal identifier assigned at creation. Used in API calls that reference this mediator. |
| Created | When this mediator record was created. |
| Updated | When this mediator record was last modified. |
Related
- Gateway reference: Field reference for the gateway editor, including the Global Policy tab.
- Connection point: Field reference for the connection point editor.
- Gateways: Conceptual overview of gateway types, connection points, and
fabric://routing.
Glad to hear it! Please tell us how we can improve more.
Sorry to hear that. Please tell us how we can improve.
Thank you for sharing your feedback so we can improve your experience.