Django Authentication Gateway

✅ Features

• JWT-based authentication (OAuth2 ready)
• Token validation middleware
• Proxying/forwarding to internal services
• Request/response transformation
• Role/permission middleware
• Basic service health-check endpoints

🐳 Docker

Pull from Docker Hub:

docker pull theisaac/django_authentication_gateway:latest

---

⚙️ Requirements

• Python 3.9+
• Django 4.2+
• PostgreSQL / MySQL

🛠️ Setup

# 1. Clone repo
git clone https://github.com/Mount-Isaac/django_authentication_gateway.git
cd django_authentication_gateway

# 2. Virtual environment
python -m venv venv
source venv/bin/activate  # or venv\Scripts\activate for Windows

# 3. Install deps
pip install -r requirements.txt

# 4. Configure env
cp .env.example .env

---

🔐 Environment Variables

DEBUG=False
SECRET_KEY=your-django-secret
DATABASE_URL=postgres://user:password@localhost/db
JWT_SECRET_KEY=your-jwt-secret

---

🧭 Microservice Routing

Define services in config.yaml or directly in settings.py:

MICROSERVICES = {
    'users': {
        'url': 'http://users-service:5000',
        'timeout': 15,
    },
    'orders': {
        'url': 'http://orders-service:5001',
        'timeout': 15,
    }
}

---

🔁 Authentication Flow

1. POST /api/auth/token/ — get a JWT token
2. Add header: Authorization: Bearer <token>
3. Gateway validates token
4. Routes request to correct microservice

---

📦 Request Forwarding Example

Client → GET /users/profile/
Gateway → Auth → Proxy → http://users-service/profile/

---

🛡️ Security

• Use HTTPS in production
• Short-lived access tokens
• Rate limiting (via caching or middleware)
• Header sanitization
• IP + request logging

📊 Monitoring Endpoints

Endpoint	Description
/health/	Gateway health check
/metrics/	Performance stats
/services/status/	Microservice availability

---

🧪 Dev & Testing

# Install dev tools
pip install -r requirements-dev.txt

# Run tests
python manage.py test

---

➕ Add a New Microservice

1. Register it in MICROSERVICES config.yaml
2. Set up any auth or routing rules if needed
3. Deploy and test

🙋 Contact

• Email: isadechair019@gmail.com
• WhatsApp: Chat Now

---

🧠 Pro Tip

Start multiple Django apps at once:

for app in app1 app2 app3; do python manage.py startapp $app; done