modrole

The Synapse modrole tool can be used to add or modify a role in a Synapse service.

Syntax

modrole is executed using python -m synapse.tools.modrole. The command usage is as follows:

python -m synapse.tools.modrole -h

usage: synapse.tools.modrole [-h] [--svcurl SVCURL] [--add] [--del] [--list]
                             [--allow ALLOW] [--deny DENY] [--gate GATE]
                             [rolename]

Add or modify a role in a Synapse service.

positional arguments:
  rolename         The rolename to add/edit.

options:
  -h, --help       show this help message and exit
  --svcurl SVCURL  The telepath URL of the Synapse service.
  --add            Add the role if they do not already exist.
  --del            Delete the role if it exists.
  --list           List existing roles, or rules of a specific role.
  --allow ALLOW    A permission string to allow for the role.
  --deny DENY      A permission string to deny for the role.
  --gate GATE      The iden of an auth gate to add/del rules on.