Differences

This shows you the differences between two versions of the page.

--- 72:editor_unmanaged [2023/01/10 16:54] – ohh
+++ 72:editor_unmanaged [2023/08/03 12:42] – [Example: Embed videos into process descriptions] emr
@@ Line 1: / Line 1: @@
 ====== Unmanaged Sections ======
-You can insert HTML code into a description text with an Unmanaged Section. It is called "unmanaged" because Stages does not validate this HTML code. Stages will send this code to the web browser unchanged.
+Unmanaged Sections provide the ability to insert HTML code into a description text. They are called "unmanaged" because Stages does not validate this HTML code. Stages sends this code to the web browser unchanged.
-** <font inherit/inherit;;#c0392b;;inherit>Therefore, for IT security reasons, this feature is deactivated by default.</font> ** ** <font inherit/inherit;;#c0392b;;inherit></font> **Please, contact a Stages Product Consultant before activating this feature.
+** <font inherit/inherit;;#c0392b;;inherit>Considering IT security, this feature is disabled by default.</font>  **Please get in touch with a Stages Product Consultant before enabling it.
-Unmanaged Sections can be
+Unmanaged Sections can be created
-  * created manually using the toolbar's Unmanaged HTML Section button,
+  * manually using the **Unmanaged HTML Section**  button in the toolbar.
-  * created automatically by the validation/migration process from Stages 6 to Stages 7.
+  * automatically through the validation process when migrating from Stages 6 to Stages 7.
-To change/edit an Unmanaged Section, double-click the **Unmanaged HTML Section**  symbol at the text position.
+To modify an Unmanaged Section, double-click the **Unmanaged HTML Section**  icon at the text position.
-To delete an Unmanaged Section, delete the **Unmanaged HTML Section**  symbol at the text position.
+To delete an Unmanaged Section, delete the **Unmanaged HTML Section**  icon at the text position.
+===== Example: Embed videos into process descriptions =====
+The following two configuration properties need to to be set for enabling the display and editing of unmanaged sections:
+<code>
+<!-- For editing HTML sections even when secure mode is active -->
+<property name="global.secureMode.allowHTMLPlugin" value="true" />
+<!-- For displaying HTML sections -->
+<property name="process.description.displayUnmanagedSections.enabled" value="true" />
+</code>
+In addition to this, displaying external content in iframes must be explicitly allowed:
+<code>
+<!-- For allowing iframes from YouTube and Vimeo -->
+<property name="global.secureMode.csp.additional.framesrc" value="https://www.youtube.com https://www.vimeo.com" />
+</code>
+When these three configuration properties are set, you should be able to insert the embed HTML code from the video site in an unmanaged section.
+**Warning:** modifying the configuration properties can impact the security of the system by enabling cross-site scripting. Please make sure that your security team approves this change.