You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/authentication/authentication.rst
+52-18Lines changed: 52 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,38 +32,50 @@ To turn on SAML support in Mautic, you first need the IDP's metadata XML which t
32
32
:width:800
33
33
:alt:Screenshot of the User Role Permission
34
34
35
+
.. vale off
36
+
35
37
Configuring the IDP
36
38
===================
39
+
40
+
.. vale on
41
+
37
42
The IDP may ask for the following settings:
38
43
39
-
#. Entity ID - this is site URL, displayed at the top of User/Authentication Settings. Copy this exactly 'as is' to the IDP.
44
+
.. vale off
45
+
46
+
#. **Entity ID** - This is the site URL, displayed at the top of **User/Authentication Settings**. Copy this exactly as is to the IDP.
40
47
41
-
#. Service Provider Metadata - if the provider requires a URL, use ``https://example.com/saml/metadata.xml``. To use as a file rather than a URL, browse to that URL and save the content as an XML file.
48
+
.. note::
42
49
43
-
#. Assertion Consumer Service - Use ``https://example.com/s/saml/login_check``.
50
+
If you use a custom domain, set the site URL in **Configuration** > **System Settings** to match it. This keeps your SAML setup working correctly.
44
51
45
-
#. Issuer - this should come from the IDP but is often configurable. If it's a URL, be sure that the scheme - ``http://`` and ``https://`` - aren't part of it.
52
+
#. **Service Provider Metadata** - If the provider requires a URL, use ``https://example.com/saml/metadata.xml``. If it needs a file instead of a URL, open the URL in a browser and save the content as an XML file.
53
+
#. **Assertion Consumer Service** - Use ``https://example.com/s/saml/login_check``.
54
+
#. **Issuer** - It should come from the IDP but is often configurable. If it's a URL, be sure that the scheme - ``http://`` or ``https://`` - isn't part of it.
55
+
#. **Verify request signatures or an SSL certificate** - If the IDP supports encrypting and validating request signatures from Mautic to the IDP, generate a self-signed SSL certificate. Upload the certificate and private key through Mautic's **Configuration** > **User/Authentication Settings** under the "**Use a custom X.509 certificate and private key to secure communication between Mautic and the IDP**" section. Then upload the certificate to the IDP.
56
+
#. **Custom attributes** - Mautic requires three custom attributes in the IDP responses - email, first name, and last name - and can optionally include a username. Configure the attribute names used by the IDP in Mautic's **Configuration** > **User/Authentication Settings** under the "**Enter the names of the attributes the configured IDP uses for the following Mautic User fields**" section.
46
57
47
-
#. Verify request signatures or a SSL certificate - If the IDP supports encrypting and validating request signatures from Mautic to the IDP, generate a self signed SSL certificate. Upload the certificate and private key through Mautic's Configuration > User/Authentication Settings under the 'Use a custom X.509 certificate and private key to secure communication between Mautic and the IDP' section. Then upload the certificate to the IDP.
58
+
.. vale on
48
59
49
-
#. Custom attributes - Mautic requires three custom attributes in the IDP responses for the User Email, first name and last name. Username is also supported but is optional. Configure the attribute names used by the IDP in Mautic's Configuration > User/Authentication Settings under the 'Enter the names of the attributes the configured IDP uses for the following Mautic User fields' section.
60
+
.. vale off
50
61
51
62
Example - Azure SAML SSO
52
63
========================
53
64
54
-
1) Register new Enterprise applications by navigating to ``Create your own Application`` and then ``Integrate any other application you don't find in the gallery (Non-gallery)``
55
-
2) Go to Single Sign-On
56
-
3) ``Identifier (Entity ID)`` - this is the site URL located at the top of User/Authentication Settings. Copy this exactly as is to the IDP.
57
-
4) ``Reply URL (Assertion Consumer Service URL)`` - Use ``https://example.com/s/saml/login_check``
58
-
5) Download Federation Metadata XML from 3. SAML Certificates
59
-
6) Upload the downloaded Federation Metadata XML to Mautic
60
-
7) X.509-Certificate isn't required
61
-
8) Use the following for the custom attributes fields:
65
+
#. Register a new application by going to **Enterprise Applications**, clicking **Create your own application**, and selecting **Integrate any other application you don't find in the gallery (Non-gallery)**.
66
+
#. Go to the **Single sign-on** menu.
67
+
#. **Entity ID** - This is the site URL, displayed at the top of **User/Authentication Settings**. Copy this exactly as is to the IDP.
68
+
#. **Reply URL (Assertion Consumer Service URL)** - Use ``https://example.com/s/saml/login_check``.
69
+
#. In the **SAML Certificates** section, download the **Federation Metadata XML**.
70
+
#. Upload the downloaded **Federation Metadata XML** file to the **Identity provider metadata file** field in Mautic, and leave the **X.509 Certificate** field blank.
71
+
#. Use the following for the custom attributes fields:
@@ -72,6 +84,28 @@ Once configured with the IDP and the IDP with Mautic, Mautic redirects all login
72
84
73
85
Login to the IDP, which then redirects you back to Mautic. If the exchange is successful Mautic creates a User if it doesn't already exist, and logs the User into the system.
74
86
87
+
.. vale off
88
+
89
+
Managing passwords for SAML-authenticated Users
90
+
===============================================
91
+
92
+
.. vale on
93
+
94
+
.. vale off
95
+
96
+
Mautic hides the password fields on the Account page and User edit form for SAML-authenticated Users. SAML-authenticated Users log in through the identity provider, so they manage their passwords there, not in Mautic.
97
+
98
+
.. vale on
99
+
100
+
Recovering from a login error
101
+
=============================
102
+
103
+
.. vale off
104
+
105
+
A SAML login can fail if the session expires or if Mautic receives an unexpected response from the IDP, such as the intermittent 'Unknown Response' error. When this happens, Mautic clears the session and shows a retry screen. Select the login button to try again. If the error keeps happening, contact your administrator.
Copy file name to clipboardExpand all lines: docs/builders/email_landing_page.rst
+48-3Lines changed: 48 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -60,6 +60,28 @@ Asset manager
60
60
61
61
With the Asset Manager is easier to organize your media files and it's enough to double click the image to change it.
62
62
63
+
Editing text
64
+
============
65
+
66
+
GrapesJS uses inline text editing powered by CKEditor. Double click a text Component to open the inline editor and edit directly on the canvas.
67
+
68
+
The inline editor includes standard formatting options:
69
+
70
+
* Bold, italic, underline and strikethrough
71
+
* Font family, font color and font background color
72
+
* Text alignment
73
+
* Ordered and unordered lists
74
+
* Headings
75
+
* Links and anchors
76
+
* Tables
77
+
* Tokens for personalization
78
+
79
+
You can paste content from external sources like Microsoft Word or Google Docs. The editor keeps basic formatting and adapts it for Email and Landing Page layouts.
80
+
81
+
.. tip::
82
+
83
+
Click outside the text Component to finish editing and return to the canvas.
84
+
63
85
About the builder
64
86
*****************
65
87
@@ -125,12 +147,35 @@ Themes
125
147
126
148
If you search through the list of available Themes, the new MJML Themes ``Brienz``, ``Paprika`` and ``Confirm Me`` display only with the new Builder.
127
149
128
-
To learn more about creating Themes please :doc:`check the documentation</builders/creating_themes>`.
150
+
To learn more about creating Themes, see :doc:`/builders/creating_themes`.
151
+
152
+
Typography
153
+
**********
154
+
155
+
The Style Manager includes a Typography section for styling text Components. Select a text Component on the canvas, then open the Style panel to reach these controls:
156
+
157
+
* **Font family** - choose from the available fonts
158
+
* **Font size** - set the text size in pixels
159
+
* **Font weight** - adjust the weight from light to bold
160
+
* **Letter spacing** - control the spacing between characters
161
+
* **Color** - set the text color
162
+
* **Line height** - adjust the vertical spacing between lines
163
+
* **Text align** - align text left, center, right, or justify
164
+
* **Text decoration** - apply none, underline, or strikethrough
165
+
* **Font style** - switch between normal and italic
166
+
167
+
Mautic resolves typography across three levels, where each level overrides the one before it:
168
+
169
+
#. **Theme defaults** - the base styles defined by the Theme.
170
+
#. **Component typography** - the Style Manager settings listed in this section, which apply to the selected Component.
171
+
#. **Inline editor** - the formatting you apply to individual characters or words with the CKEditor inline toolbar when you double click a text Component.
172
+
173
+
Use the Component typography controls to fine-tune headings, paragraphs, and other text elements in legacy Themes that lack modern styling flexibility.
129
174
130
175
Custom fonts
131
-
************
176
+
============
132
177
133
-
From Mautic 5.x you can extend the Style Manager > Typography > Fonts list to include custom fonts.
178
+
You can extend the **Typography** > **Fonts** list to include custom fonts.
![promptless[bot]](https://avatars.githubusercontent.com/in/979718?v=4&size=40){kind=avatar}
0 commit comments