matrix-saml-strip-hostname 0.2.2

SAML mapping provider to strip hostnames from mxids

This mapping provider strips the @domain.com part from UIDs coming from a SAML2 identity provider (IDP). This is useful for example when using Google Apps as an IDP, to avoid getting Matrix IDs like jane.doe=[e-mail] (instead you’ll get [e-mail]).

Note: At the time of this writing, the support for user-configurable mapping providers hasn’t been released yet. You will probably have to wait for Synapse 1.7 or 1.8, or install an unreleased version of Synapse.

Installation

Run the following command in the same virtual environment of your Synapse install:

pip install matrix-saml-strip-hostname

Then edit the homeserver.yaml file on your Synapse install to use the new mapping provider:

saml2_config:
  user_mapping_provider:
    module: matrix_saml_strip_hostname.mapping_providers.StripHostnameSamlMappingProvider

Configuration

This mapper inherits from the default mapping provider. It will first strip the hostname, and then pass the result to the synapse.handlers.saml_handler.DefaultSamlMappingProvider mapping provider. There is no support for disabling this post-processing.

Refer to the default configuration file for configuration options for the default provider.