Skip to content

Latest commit

 

History

History
31 lines (25 loc) · 1.15 KB

bridge-integration.md

File metadata and controls

31 lines (25 loc) · 1.15 KB
Raw

Bridge Integration

To help natural bridge integration into the regular usage of a Matrix client, mxisd provides a way for bridge to reply to 3PID queries if no mapping was found, allowing seamless bridging to a network.

This is performed by implementing a specific endpoint on the bridge to map a 3PID lookup to a virtual user.

NOTE: This document is incomplete and might be misleading. In doubt, come in our Matrix room.
You can also look at our Email Bridge README for an example of working configuration.

Configuration

lookup:
  recursive:
    bridge:
      enabled: <boolean>
      recursiveOnly: <boolean>
      server: <URL to the bridge endpoint for all 3PID medium>
      mappings:
        <3PID MEDIUM HERE>: <URL to dedicated bridge for that medium>

Integration

Implement a simplified version of the Identity service single lookup endpoint with only the following parameters needed:

  • address
  • medium
  • mxid

Or an empty object if no resolution exists or desired.