> Source: [sk109760](https://support.checkpoint.com/results/sk/sk109760)

# sk109760 - Capsule Workspace Document Control Feature

| Property | Value |
|----------|-------|
| Solution ID | sk109760 |
| Date Created | 2016-01-24 |
| Last Modified | 2023-11-07 |
| Technical Level | General |
| OS | Android, iOS |
| Platform | Mobile Devices |

## Solution

Capsule Workspace Document Control {#Capsule Workspace Document Control}
------------------------------------------------------------------------

This feature allows the administrator to have granular control over the data passed between Capsule Workspace and the mobile device, based on user / user group and file type. The feature handles the two data transfer directions:

* Outbound file sharing control  
  * Share documents from the Saved Files using external apps.
  * Open file within Capsule Workspace using external apps (Android only).
* Inbound file control  
  * Using device's camera to take photos and videos within Capsule Workspace Saved Files or as mail attachment.
  * Bring external files into Capsule Workspace boundaries using Capsule Workspace Saved Files, as mail attachment, or chose Capsule Workspace and the handler app of external file ("Open With" / "Send Mail" / "Share with").

See [sk110957](https://supportcenter.checkpoint.com/supportcenter/portal?eventSubmit_doGoviewsolutiondetails=&solutionid=sk110957 "sk110957") for details on file viewing and editing in Capsule Workspace.

Configuring Document Control {#Configuring Document Control}
------------------------------------------------------------

Before implementing the procedure below, backup your entire Management Server database:

1. Connect with SmartConsole / SmartDashboard to Security Management Server / Domain Management Server.

2. Go to ***Main*** menu / ***File*** menu - click on ***Database Revision Control...*** - create a revision snapshot.

   Note: Database Revision Control is not supported for VSX objects ([sk65420](https://supportcenter.checkpoint.com/supportcenter/portal?eventSubmit_doGoviewsolutiondetails=&solutionid=sk65420)).

   In addition, refer to:
   * [sk108902 - Best Practices - Backup on Gaia OS](https://supportcenter.checkpoint.com/supportcenter/portal?eventSubmit_doGoviewsolutiondetails=&solutionid=sk108902)
   * [sk91400 - System Backup and Restore feature in Gaia](https://supportcenter.checkpoint.com/supportcenter/portal?eventSubmit_doGoviewsolutiondetails=&solutionid=sk91400)
   * [sk54100 - How to back up your system on SecurePlatform](https://supportcenter.checkpoint.com/supportcenter/portal?eventSubmit_doGoviewsolutiondetails=&solutionid=sk54100)
   * [sk98153 - How to take a snapshot of Endpoint Security Management Server database](https://supportcenter.checkpoint.com/supportcenter/portal?eventSubmit_doGoviewsolutiondetails=&solutionid=sk98153)
   * [sk92570 - How to exclude logs from Provider-1 backup on Gaia](https://supportcenter.checkpoint.com/supportcenter/portal?eventSubmit_doGoviewsolutiondetails=&solutionid=sk92570)
   * [sk62226 - How to test Provider-1 MDS Backup file](https://supportcenter.checkpoint.com/supportcenter/portal?eventSubmit_doGoviewsolutiondetails=&solutionid=sk62226)

Procedure:

*

  ### Instructions for Management Server R77.30 and higher

  **Note:** To support configuration of Document Control in R77.30 SmartDashboard, you must install and activate the [R77.30 Add-on](https://supportcenter.checkpoint.com/supportcenter/portal?eventSubmit_doGoviewsolutiondetails=&solutionid=sk105412).

  Follow these steps to enable the new GUI (so you could enable the GUI objects):
  1. Download the *[sharing_control_3.txt](https://supportcenter.checkpoint.com/supportcenter/portal/role/supportcenterUser/page/default.psml/media-type/html?action=portlets.DCFileAction&eventSubmit_doGetdcdetails=&fileid=48076)* file to your computer.

  2. Transfer the downloaded *sharing_control_3.txt* file from your computer to the Security Management Server / Multi-Domain Security Management Server (into some directory, e.g., */some_path_to_file/*).

  3. Close all SmartConsole windows (SmartDashboard, SmartView Tracker, SmartView Monitor, etc.).  
     Verify by running the "*cpstat mg* " command on Security Management Server / in the context of *each* Domain Management Server.

  4. Connect to the command line on the Security Management Server / Multi-Domain Security Management Server.

  5. Log in to the Expert mode.

  6. On the Multi-Domain Security Management Server, switch to the context of the relevant Domain Management Server:

     ***\[Expert@HostName:0\]# mdsenv \<Name or IP of Domain Management Server\>***
  7. Import the required configuration using the [***DBedit***](https://supportcenter.checkpoint.com/supportcenter/portal?eventSubmit_doGoviewsolutiondetails=&solutionid=skI3301) tool to Security Management Server / Domain Management Server database:

     ***\[Expert@HostName:0\]# dbedit -local -f /some_path_to_file/sharing_control_3.txt***
  8. Connect with SmartConsole (R80 and higher) / SmartDashboard (R77.30) to the Security Management Server / Domain Management Server.

  9. Go to the ***Mobile Access*** tab.

  10. In the left upper tree, expand the ***Capsule Workspace Settings***.

  11. Select the desired profile.

  12. Scroll down to the ***General*** section.

  13. Fill in the values.

  14. Click the ***Save*** button.

  15. Install the Security Policy on the relevant Mobile Access Security Gateway / Cluster object.

*

  ### Instructions for Management Server R77.20

  **Note:** R77.20 does *not* support GUI configuration for Document Control.

  Follow these steps to configure the desired Mobile Access profile:
  1. Close all SmartConsole windows (SmartDashboard, SmartView Tracker, SmartView Monitor, etc.).

     Verify by running the "*cpstat mg* " command on Security Management Server / in the context of *each* Domain Management Server.
  2. Connect with the [GuiDBedit Tool](https://supportcenter.checkpoint.com/supportcenter/portal?eventSubmit_doGoviewsolutiondetails=&solutionid=sk13009) to the Security Management Server / Domain Management Server.

  3. In the upper left pane, go to ***Table*** - ***Other*** - ***mobile_profiles***.

  4. In the upper right pane, select the desired profile Mobile Access profile (that shows "**`mobile_profile`** " in the "**`Class Name`**" column).

  5. Press CTRL+F (or go to ***Search*** menu - ***Find*** ) - paste ***future_compatibility_fields*** - click on ***Find Next***.

  6. In the lower pane, right-click on the ***future_compatibility_fields*** - select ***Add...*** -  
     do **not** enter anything in the ***Name*** field - do **not** change anything in the ***Value*** field - click on ***OK***.

     *Example:*   
     ![](https://sc1.checkpoint.com/sc/SolutionsStatics/sk109760/Example1_1702160257.png)
  7. New fields will be added below the ***future_compatibility_fields***.

     ![](https://sc1.checkpoint.com/sc/SolutionsStatics/sk109760/Example2_1702160257.png)
  8. Define the desired Key-Value pair in the new created fields:

     **Note:** Possible Key-Value pairs are describes in the Document Control Configuration Attributes" section below.
     1. Double-click on the ***field_name*** - in the ***Value*** field, enter the desired key string - click on ***OK***

     2. Double-click on the ***field_value*** - in the ***Value*** field, enter the desired value string - click on ***OK***

     *Example:*   
     ![](https://sc1.checkpoint.com/sc/SolutionsStatics/sk109760/Example3_1702160257.png)
  9. If more than one Key-Value pair needs to be defined, then repeat the above Steps 5-8 for each new Key-Value pair:

     1. Right-click on the ***future_compatibility_fields*** - select ***Add...*** - do not enter/change anything - click on OK

        *Example:*   
        ![](https://sc1.checkpoint.com/sc/SolutionsStatics/sk109760/Example4_1702160258.png)
     2. Double-click on the ***field_name*** - in the ***Value*** field, enter the desired key string - click on ***OK***

     3. Double-click on the ***field_value*** - in the ***Value*** field, enter the desired value string - click on ***OK***

     *Example:*   
     ![](https://sc1.checkpoint.com/sc/SolutionsStatics/sk109760/Example5_1702160258.png)
  10. Key-Value pairs that were not defined explicitly, will have default values, as described in the Document Control Configuration Attributes" section below.

  11. Save the changes: go to ***File*** menu - click on ***Save All***.

  12. Close the GuiDBedit Tool.

  13. Connect with SmartDashboard to the Security Management Server / Domain Management Server.

  14. Install the Network Security Policy on the relevant Mobile Access Security Gateway / Cluster object.

Document Control Configuration Attributes {#Document Control Configuration Attributes}
--------------------------------------------------------------------------------------

|-------------------------------------------------------------------------------------------------|-------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------|----------------------|
| Attribute                                                                                       | Key                                       | Description                                                                                                                                                                                                                                                                                                                                                   | Accepted String Value                              | Default String Value |
| Share protected files with these extensions with external apps                                  | `key_00100_share_protected_extensions`    | Describes which extensions can "exit the boundaries" of Workspace. **This holds only for Capsule Docs protected files.** * In Android, this holds for "share" action. * In iOS, this holds for all actions that involve a file going out of Workspace.                                                                                                        | Comma separated extensions (see explanation below) | `$all`               |
| Share unprotected files with these extensions with external apps                                | `key_00110_share_unprotected_extensions`  | Describes which extensions can "exit the boundaries" of Workspace. **This holds only for files not protected by Capsule Docs.** * In Android, this holds for "share" action. * In iOS, this holds for all actions that involve a file going out of Workspace.                                                                                                 | Comma separated extensions (see explanation below) | `none`               |
| Open the following extensions with external apps when they cannot be opened with Capsule viewer | `key_00120_open_extensions`               | By default, Capsule Workspace will open some extensions with the internal office viewer regardless of this rule. This rule describes which extensions can "exit the boundaries" of Workspace when the internal viewer cannot handle the files. The user will be asked to pick his favorite app (depends on what is installed on his device) to open the file. | Comma separated extensions (see explanation below) | `none`               |
| Allow taking photos and videos                                                                  | `key_00130_allow_camera`                  | Is the device camera allowed to be used to take pictures and videos and bring them inside Workspace?                                                                                                                                                                                                                                                          | `true`, or `false`                                 | `true`               |
| Allow importing media from gallery                                                              | `key_00140_allow_import_from_gallery`     | **This rule applies only in iOS.** Will the user be allowed to import media from the device into Capsule Workspace?                                                                                                                                                                                                                                           | `true`, or `false`                                 | `true`               |
| Accept protected files with these extensions from external apps                                 | `key_00150_accept_protected_extensions`   | Describes which extensions can "enter the boundaries" of Workspace. **This holds only for Capsule Docs protected files.**                                                                                                                                                                                                                                     | Comma separated extensions (see explanation below) | `$all`               |
| Accept unprotected files with these extensions from external apps                               | `key_00160_accept_unprotected_extensions` | Describes which extensions can "enter the boundaries" of Workspace. **This holds only for files not protected by Capsule Docs.**                                                                                                                                                                                                                              | Comma separated extensions (see explanation below) | `$all`               |

***Comma Separated Extensions***

Document extensions can be grouped into macros to shorten the syntax.

**For example:**   
`$word, avi, mp3`  
(`$word` holds a few extensions)

Here are the detailed expansions:

* **`$all`** = Match any extension (even ones not listed below). Actually, a more intuitive explanation is to ignore the extension and apply this rule to all files.
* **$none** = Match no extension. Basically use to block any type of file from sharing or importing. (Require Capsule version higher than 1012.0.34 iOS or 9.2.3 Android).
* **`$word`** = doc, dot, docx, docm, dotx, dotm, docb
* **`$excel`** = xls, xlt, xlm, xlsx, xlsm, xltx, xltm, xlsb, xla, xlam, xll, xlw
* **`$powerpoint`** = ppt, pot, pps, pptx, pptm, potx, potm, ppam, ppsx, ppsm, sldx, sldm
* **`$office`** = `$word`, `$excel`, `$powerpoint`
* **`$media`** = gif, jpg, jpeg, png, svg, bmp, tif, tiff, wav, m4a, aac, mp3, aif, aifc, aiff, mp4, m4c, mov

---

# Agent Instructions

This content is from the Check Point Support Center (https://support.checkpoint.com), the official knowledge base for Check Point cybersecurity products.

## Navigating This Knowledge Base

- **Complete index**: [llms.txt](https://support.checkpoint.com/llms.txt)
- **All SK articles**: [SecureKnowledge Sitemap](https://support.checkpoint.com/sitemaps/secureknowledge-sitemap-index.xml)
- **SK article URL pattern**: `https://support.checkpoint.com/results/sk/{skId}`
- **Markdown responses**: AI bot User-Agents automatically receive `text/markdown` content
