Skip to content

Initial Release - v1.0

Latest

Choose a tag to compare

@stuartasiimwe7 stuartasiimwe7 released this 06 Oct 21:30
· 6 commits to main since this release

A TypeScript/NestJS API for monitoring cloud security events from AWS CloudTrail.

Features

  • Security Event Collection: Pulls AWS CloudTrail events into PostgreSQL
  • REST API: Query stored events with filtering and pagination
  • JWT Authentication: Secure access to all endpoints
  • Scheduled Jobs: Automatic event collection every 10 minutes
  • TypeORM Integration: Robust database operations with migrations

Endpoints

  • GET /aws-security/fetch-events - Pull recent CloudTrail events
  • GET /aws-security/events - Fetch events directly from AWS
  • GET /aws-security/db-events - Query stored events with filters
  • POST /cloudtrail/test - Test event processing
  • POST /auth/dev-token - Generate JWT token

Quick Start

# Get a token
TOKEN=$(curl -s -X POST http://localhost:3000/auth/dev-token | jq -r .access_token)

# Pull events
curl -H "Authorization: Bearer $TOKEN" http://localhost:3000/aws-security/fetch-events

Installation

git clone https://github.com/stuartasiimwe7/cloud-security-monitoring-api.git
cd cloud-security-monitoring-api
npm install
npm run start:dev

Documentation

See README.md for complete setup and usage instructions.

What's Changed

New Contributors

Full Changelog: https://github.com/stuartasiimwe7/Cloud-Security-Monitoring-API/commits/v1.0