https://github.com/elongl/viper

Remote control agent and controller.
https://github.com/elongl/viper

agent controller rat security

Last synced: 3 months ago
JSON representation

Remote control agent and controller.

• Host: GitHub
• URL: https://github.com/elongl/viper
• Owner: elongl
• Created: 2022-06-05T10:44:14.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-11-10T08:17:09.000Z (about 1 year ago)
• Last Synced: 2024-06-19T06:56:47.815Z (7 months ago)
• Topics: agent, controller, rat, security
• Language: Go
• Homepage:
• Size: 150 KB
• Stars: 13
• Watchers: 1
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Viper

Remote control software using gRPC and Go.

## Components

- **Agent**: Runs on the endpoint.

- **Controller**: The server that the _agents_ connect to.

- **Agent Manager**: The server that runs alongside the _controller_ to manage the _agents_.

- **Controller Client**: Talks to the _agent manager_.

## Features

- **Cross-platform Support**: Runs on all modern operating systems (Windows, Linux, macOS, etc).

- **Authentication & Encryption**: Connections are encrypted and verified using client certificates.

- **Persistence**: Keeps connection to the controller even if rebooted or disconnected momentarily.

- **Shell**: Execute shell commands.

- **File I/O**: Download and upload files.

- **Screenshots**: Capture screenshots.

- **Network Proxy**: Connect into the agent's network using [SOCKS](https://en.wikipedia.org/wiki/SOCKS).

## Build

1. Update the `config.json` according to your needs.

2. Run `make` to build the executables in `bin`.

## Usage

1. Run `controller` to accept agent connections.

2. Run the controller client to manage the agents: `ipython -i controller-client/main.py`.

```py

cnc.get_agents()

> [

    id: 0

    alive: true

    connect_time: "2022-06-19 15:22:13.17828 +0300 IDT m=+61.594837928"

]

agent = cnc.get_agent(agent_id=0)

agent.shell('whoami')

> 'root'

```