SAML: add <mdui:UIInfo> element examples (#8718)

add some mdui:UIInfo element examples for saml2_config in homeserver.yaml

3 files changed, 45 insertions, 0 deletions

diff --git a/changelog.d/8718.misc b/changelog.d/8718.misc
new file mode 100644

index 0000000000..f1868ce709
--- /dev/null
+++ b/changelog.d/8718.misc
@@ -0,0 +1 @@
+Add some `mdui:UIInfo` element examples for `saml2_config` in the homeserver config.
diff --git a/docs/sample_config.yaml b/docs/sample_config.yaml

index 7e2cf97c3e..c0cd009230 100644
--- a/docs/sample_config.yaml
+++ b/docs/sample_config.yaml
@@ -1560,6 +1560,28 @@ saml2_config:
     #description: ["My awesome SP", "en"]
     #name: ["Test SP", "en"]
 
+    #ui_info:
+    #  display_name:
+    #    - lang: en
+    #      text: "Display Name is the descriptive name of your service."
+    #  description:
+    #    - lang: en
+    #      text: "Description should be a short paragraph explaining the purpose of the service."
+    #  information_url:
+    #    - lang: en
+    #      text: "https://example.com/terms-of-service"
+    #  privacy_statement_url:
+    #    - lang: en
+    #      text: "https://example.com/privacy-policy"
+    #  keywords:
+    #    - lang: en
+    #      text: ["Matrix", "Element"]
+    #  logo:
+    #    - lang: en
+    #      text: "https://example.com/logo.svg"
+    #      width: "200"
+    #      height: "80"
+
     #organization:
     #  name: Example com
     #  display_name:
diff --git a/synapse/config/saml2_config.py b/synapse/config/saml2_config.py

index 778750f43b..2ff7dfb311 100644
--- a/synapse/config/saml2_config.py
+++ b/synapse/config/saml2_config.py
@@ -271,6 +271,28 @@ class SAML2Config(Config):
             #description: ["My awesome SP", "en"]
             #name: ["Test SP", "en"]
 
+            #ui_info:
+            #  display_name:
+            #    - lang: en
+            #      text: "Display Name is the descriptive name of your service."
+            #  description:
+            #    - lang: en
+            #      text: "Description should be a short paragraph explaining the purpose of the service."
+            #  information_url:
+            #    - lang: en
+            #      text: "https://example.com/terms-of-service"
+            #  privacy_statement_url:
+            #    - lang: en
+            #      text: "https://example.com/privacy-policy"
+            #  keywords:
+            #    - lang: en
+            #      text: ["Matrix", "Element"]
+            #  logo:
+            #    - lang: en
+            #      text: "https://example.com/logo.svg"
+            #      width: "200"
+            #      height: "80"
+
             #organization:
             #  name: Example com
             #  display_name: