third_party_event_rules.py 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546
  1. # -*- coding: utf-8 -*-
  2. # Copyright 2019 The Matrix.org Foundation C.I.C.
  3. #
  4. # Licensed under the Apache License, Version 2.0 (the "License");
  5. # you may not use this file except in compliance with the License.
  6. # You may obtain a copy of the License at
  7. #
  8. # http://www.apache.org/licenses/LICENSE-2.0
  9. #
  10. # Unless required by applicable law or agreed to in writing, software
  11. # distributed under the License is distributed on an "AS IS" BASIS,
  12. # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. # See the License for the specific language governing permissions and
  14. # limitations under the License.
  15. from synapse.util.module_loader import load_module
  16. from ._base import Config
  17. class ThirdPartyRulesConfig(Config):
  18. section = "thirdpartyrules"
  19. def read_config(self, config, **kwargs):
  20. self.third_party_event_rules = None
  21. provider = config.get("third_party_event_rules", None)
  22. if provider is not None:
  23. self.third_party_event_rules = load_module(
  24. provider, ("third_party_event_rules",)
  25. )
  26. def generate_config_section(self, **kwargs):
  27. return """\
  28. # Server admins can define a Python module that implements extra rules for
  29. # allowing or denying incoming events. In order to work, this module needs to
  30. # override the methods defined in synapse/events/third_party_rules.py.
  31. #
  32. # This feature is designed to be used in closed federations only, where each
  33. # participating server enforces the same rules.
  34. #
  35. #third_party_event_rules:
  36. # module: "my_custom_project.SuperRulesSet"
  37. # config:
  38. # example_option: 'things'
  39. """