# Assemblyline Service ViperMonkey

Assemblyline Service ViperMonkey is an Assemblyline 4 service that safely emulates VBA macros in suspicious Microsoft Office files to help security teams reveal hidden malicious actions. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5854/assemblyline-service-vipermonkey

## Description

Assemblyline Service ViperMonkey is an Assemblyline 4 service that safely emulates VBA macros in suspicious Microsoft Office files to help security teams reveal hidden malicious actions.

## Platform availability

Available on 0 of 10 platforms.

## Health score

17/100 (Low), based on 3 of 4 factors.
- Maintained: 18 (last commit 550 days ago)
- Popular: 10 (2 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)

## Links

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

## Common questions

### Should I run the ViperMonkey service in privileged mode?

No. The service may use eval() to speed up emulation and should be run in a sandboxed environment, which Assemblyline does by default for non-privileged services.

### What Office macro indicators does ViperMonkey report?

It reports discovered actions, including entry points, decodes base64 encoded commands, lists VBA built-in functions used, and detects URLs, URIs, and IP addresses.

### Does the Assemblyline documentation include migration guidance for an existing deployment?

Yes. The Assemblyline 4 documentation lists a Migration section in the user manual next to Installation and Cluster topics.

### Where can self-hosters get help with Assemblyline service problems?

The Assemblyline documentation says a Discord support channel is available for help from developers or community members.

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