> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xorlab.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Pages under /latest/ document the current release. Paths that begin with a version number, for example /10.0/, are frozen snapshots of superseded releases kept for reference only — never present their instructions as current. If the reader's version is unknown, answer from /latest/ and say which version the answer describes.
> xorlab is deployed on-premises, hybrid, or as a cloud service, and integrates with either Microsoft 365 or on-premises mail infrastructure. Configuration steps often differ between these. State which deployment and integration mode an instruction applies to instead of presenting one as universal.
> Distinguish inline mode from monitoring mode when describing anything that acts on email. Monitoring mode observes a copy and cannot block or quarantine; inline mode routes mail through xorlab and can.
> Write the product name as lowercase 'xorlab'. Use the documented component names: xorlab Control Center (XCC), xorlab MTA, xorlab Sandbox (DANA), xorlab Natural Language Understanding (NLU). After the first mention, use the short forms XCC, MTA, Sandbox, and NLU. Do not use DANA as a standalone name for the Sandbox, but keep it where it is a literal string in configuration keys, container names, and hostnames.
> Do not invent configuration keys, rule parameters, list names, log properties, or API fields. If a value is not present in this documentation, say that it is not documented rather than guessing.

# Enable Attachment Airlock

> Hold emails with encrypted attachments in the Self-Service Quarantine until the user supplies a password, then re-analyze them.

Only attachments that cannot be decrypted through other means are affected.

<Warning>
  **Prerequisites**

  * Complete [Set Up the SSQ](/latest/ssq-setup)
</Warning>

Follow the steps below to activate this feature:

1. In [Expert Editor](/latest/expert-editor), navigate to `activeguard/core/rule_sets/90_local/params/local.properties`.

2. Edit the file by inserting the following lines:
   ```text theme={null}
   # Enable Attachment Airlock
   ATTACHMENT_AIRLOCK_decision_state=ACTIVE
   ```
   This parameter activates the Attachment Airlock feature. If, for any reason, you wish to deactivate this feature in the future, simply change the parameter from `ACTIVE` to `DISABLED`.

3. Click **Publish**. The rule-set configuration becomes active within about one minute.

## Password Compatibility

Attachment Airlock expects passwords to be UTF-8 encoded. If a file is encrypted with a password containing special characters (e.g., ç, ü, ñ) using older tools or systems that use legacy encodings like CP437 or ISO-8859-1, unlocking may fail due to encoding mismatches.

## Using Attachment Airlock

With Attachment Airlock enabled, users can unlock password-protected attachments in a secure environment and have them analyzed by xorlab. When an email with a password-protected attachment is sent to an xorlab user, and the password protection can’t be automatically cracked by xorlab, the user receives the following notification email:

<img src="https://mintcdn.com/xorlab/O_O2TUa6eRBR54aI/latest/assets/airlock-notification.png?fit=max&auto=format&n=O_O2TUa6eRBR54aI&q=85&s=197a0c48b878165a1639be1c009dd348" alt="Airlock notification" width="1306" height="1422" data-path="latest/assets/airlock-notification.png" />

By clicking the **Unlock safely** link, you are redirected to the [SSQ portal](/latest/ssq-overview) with the preview of the quarantined message (if the main SSQ page is opened instead, just click the **Attachments** tab and click the message):

<Info>
  The **Attachments** tab in the SSQ shows the contents of the `Airlock` quarantine — the quarantine you configure under that name in `guarded_tenants.yml`, see [List of Quarantines](/latest/ssq-list-of-quarantines).
</Info>

<img src="https://mintcdn.com/xorlab/O_O2TUa6eRBR54aI/latest/assets/airlock-preview.jpeg?fit=max&auto=format&n=O_O2TUa6eRBR54aI&q=85&s=e63e80541b59aa4bdb962cc77bae4328" alt="Airlock message preview" width="3172" height="1738" data-path="latest/assets/airlock-preview.jpeg" />

To unlock the message, click **Unlock** and enter the password for the attachment:

<img src="https://mintcdn.com/xorlab/O_O2TUa6eRBR54aI/latest/assets/airlock-password.png?fit=max&auto=format&n=O_O2TUa6eRBR54aI&q=85&s=b4a4072d25ff3cc13b7789cd9e800421" alt="Enter the attachment password" width="1250" height="756" data-path="latest/assets/airlock-password.png" />

With the provided password, xorlab starts analyzing the attachment and informs you about it:

<img src="https://mintcdn.com/xorlab/O_O2TUa6eRBR54aI/latest/assets/airlock-unlocking.png?fit=max&auto=format&n=O_O2TUa6eRBR54aI&q=85&s=f628309bb7181603e3771f7d955f8f8f" alt="Unlocking the attachment" width="2634" height="1116" data-path="latest/assets/airlock-unlocking.png" />

After a successful analysis, if the attachment is safe, the message is unlocked and delivered to your mailbox:

<img src="https://mintcdn.com/xorlab/O_O2TUa6eRBR54aI/latest/assets/airlock-unlocked.png?fit=max&auto=format&n=O_O2TUa6eRBR54aI&q=85&s=52acd38cb90b619457208d5e98fda93c" alt="Unlocked message" width="3186" height="1366" data-path="latest/assets/airlock-unlocked.png" />
