🐋 Whale Sentinel Services

🔧 Overview

Whale Sentinel Services is the centralized backend of the Whale Sentinel threat detection ecosystem. These microservices perform real-time threat detection, agent coordination, DGA analysis, and web attack inspection, enabling deep security observability and active protection for connected applications.

🧩 Services & Images

🚀 Getting Started

🛠️ Prerequisites

1. Create an IAM User

   • Go to AWS IAM console and create a user with permissions for Secrets Manager, EC2, and RDS.
   • Generate and securely store:
     • AWS_ACCESS_KEY_ID
     • AWS_SECRET_ACCESS_KEY

2. Create a Secret in AWS Secrets Manager

   • Secret name: AWS_SECRET_NAME
   • Keys to include:
     • WHALE_SENTINEL_AGENT_SECRET_KEY_NAME
     • WHALE_SENTINEL_SERVICE_SECRET_KEY_NAME
     • WHALE_SENTINEL_CONTROLLER_SECRET_KEY_NAME

📦 Deployment Steps

1. Download the Deployment Package

• Visit the Releases page.
• Download the latest deployment package and extract it.

2. Configure Docker Compose

mv docker-compose.example.yml docker-compose.yml

• (Optional) Update the default Redis password in redis/redis.conf and docker-compose.yml.

3. Replace Config Placeholders

Update the following values in docker-compose.yml, fluent-bit.conf, and .env:

4. Start All Services

docker-compose up -d

🤝 Contributing

We welcome contributions and feedback. Please fork the repository and open a pull request with your suggested changes.

📄 License

This project is licensed under the MIT License.

🛡️ Security & Reporting

If you discover a vulnerability, please report it responsibly via GitHub Issues or contact the maintainers privately.