# Assemblyline-service-oletools

Assemblyline-service-oletools is a self-hosted security app. An Assemblyline service that inspects Microsoft Office and other OLE/XML documents, using py-oletools and hachoir to extract metadata and network information and flag suspicious macros and embedded threats. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/6583/assemblyline-service-oletools

## Description

An Assemblyline service that inspects Microsoft Office and other OLE/XML documents, using py-oletools and hachoir to extract metadata and network information and flag suspicious macros and embedded threats.

## Platform availability

Available on 0 of 10 platforms.

## Health score

38/100 (Low), based on 4 of 4 factors.
- Maintained: 72 (last commit 17 days ago)
- Popular: 10 (2 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Light to run: 10 (8 GB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/r/cccs/assemblyline-service-oletools
- GitHub: https://github.com/cybercentrecanada/assemblyline-service-oletools
- Documentation: https://cybercentrecanada.github.io/assemblyline4_docs
- Official website: https://cybercentrecanada.github.io/assemblyline4_docs/

## Common questions

### Can the OLEtools service be run standalone outside an Assemblyline deployment?

No. It is a service module for Assemblyline and should be deployed inside an Assemblyline deployment as the cccs/assemblyline-service-oletools Docker image.

### How can I stop the OLEtools service from flagging very large macro sections?

Set MACRO_SCORE_MAX_FILE_SIZE to the byte threshold. Macro sections larger than that value are not flagged in the results.

### When does the OLEtools service extract OLE metadata as a new file?

Set METADATA_SIZE_TO_EXTRACT to the size limit in bytes. If the OLE metadata is larger than that limit, the service extracts the metadata content as a new file.

### How can I suppress false-positive IOC strings reported by the OLEtools service?

Add the IOC substring to IOC_PATTERN_SAFELIST or the exact IOC to IOC_EXACT_SAFELIST. The service ignores those IOCs unless deep scan mode is enabled.

---
Source: Our Local Host (https://ourlocalhost.com/app/6583/assemblyline-service-oletools), the self-hosted and open-source app directory.
