> ## 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 VirusTotal

> Enable VirusTotal threat intelligence in the email detail view. Informational only, not used for detection.

To enable VirusTotal:

1. Open the file `xcc.yml` in the Expert Editor and add the following with your key:

   ```yaml xcc.yml {2} theme={null}
   virusTotal:
     apiKey: "add_your_key_here"
     ## Optional proxy configuration
     # http:
        # host: https://www.virustotal.com # Mandatory in case you provide settings for http
        # proxy:
         #  host: proxy.xorlab.com
         #  port: 8080
           ## Optional credentials:
           # credentials:
             # user: "proxy-user"
             # password: "pwd"
     ## Enables the TLS/SSL support with no certificate validation
     # trustAll: false
   ```

2. Click **Publish**, then [restart the XCC](/latest/activate-configuration#configuration-files). The `virusTotal` setting is a general `xcc.yml` setting and requires the XCC restart to take effect.

## Information about the integration

xorlab sends only the SHA256 hash of an attachment to VirusTotal, not the entire attachment. URLs are submitted as-is without prior hashing. By adding your VirusTotal key you agree that this information will be sent to VirusTotal. Please visit [VirusTotal website](https://www.virustotal.com) for their Terms and Services and their Privacy Policy as by submitting data those will apply.

xorlab only uses the VirusTotal API for items that are manually opened in xorlab, e.g., when opening a message in the detail view. No VirusTotal API requests are performed when an email is not viewed.

The following VirusTotal API endpoints are used:

* [https://developers.virustotal.com/reference#file-info](https://developers.virustotal.com/reference#file-info)
* [https://developers.virustotal.com/reference#url-info](https://developers.virustotal.com/reference#url-info)
* [https://developers.virustotal.com/reference#domain-info](https://developers.virustotal.com/reference#domain-info)
* [https://developers.virustotal.com/reference#ip-info](https://developers.virustotal.com/reference#ip-info)