Mediator

Field reference for the Mediator editor in the Agent Gateway dashboard, covering the Overview and connection fields.

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. Use this page to register a DIDComm relay and enable or disable it independently from any connection points that use it.

For conceptual background on G2G routing and why mediators are needed, see Gateways. For step-by-step setup, see Connect two gateways.

Fields

SettingRequiredEditableDescription
NameYesYesHuman-readable label for this mediator. Used as a display identifier across the dashboard.
DescriptionNoYesOptional free-text description of the mediator’s purpose or operator.
DIDYesNo (after creation)The DID of the mediator service. The gateway uses this to resolve the mediator’s DIDComm endpoint and route outbound messages through it. Set at creation and cannot be changed. To use a different DID, create a new mediator.
Mediator Enabled—YesWhether this mediator is active. See Status values.

Status values

StatusMeaning
ActiveThe mediator is enabled. The gateway routes DIDComm messages through it when it is selected for an outbound connection.
DisabledThe 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.

  • 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.