https://github.com/brakmic/angular-bff-keycloak
Angular frontend + Express.js BFF + Keycloak IAM implementation
https://github.com/brakmic/angular-bff-keycloak
angular bff expressjs keycloak oidc pkce
Last synced: 4 months ago
JSON representation
Angular frontend + Express.js BFF + Keycloak IAM implementation
- Host: GitHub
- URL: https://github.com/brakmic/angular-bff-keycloak
- Owner: brakmic
- License: mit
- Created: 2025-01-25T23:57:59.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-02-13T09:25:21.000Z (5 months ago)
- Last Synced: 2025-03-14T22:49:37.188Z (4 months ago)
- Topics: angular, bff, expressjs, keycloak, oidc, pkce
- Language: TypeScript
- Homepage: https://blog.brakmic.com/keycloak-angular-and-the-bff-pattern/
- Size: 692 KB
- Stars: 5
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Angular BFF with Keycloak Authentication
Secure authentication implementation using Angular, Express.js BFF pattern, and Keycloak with complete client-side token isolation.
## Key Features
- 🔐 Complete client-side token isolation (BFF pattern)
- 🌐 SSL/TLS encryption with custom CA
- 📦 Session management (in-memory or Redis)
- 🔄 Hot-reload development setup
- 🐳 Full Docker support
## Architecture
| Component | Technology | Port | Purpose |
|-----------|------------|------|---------|
| Frontend | Angular 19 | 4200 | Single Page Application |
| Backend | Express.js | 3000 | Backend-For-Frontend (BFF) |
| Keycloak | v26 | 8443 | Identity Provider |
| Redis | v7 | 6379 | Session Store (optional) |
## Quick Start
```bash
# Clone and enter project
git clone https://github.com/brakmic/Angular-BFF-Keycloak
cd Angular-BFF-Keycloak
# Setup SSL certificates
./scripts/setup_ssl.sh
# Start all services
docker compose up -d
```
Access the applications:
- Frontend: https://frontend.local.com:4200
- Backend: https://backend.local.com:3000
- Keycloak: https://keycloak.local.com:8443
## Prerequisites
- Docker 20.10+
- Node.js 18.x
- OpenSSL
- Local domain setup (see [Domain Setup](docs/DOMAINS.md))
## Documentation
- [Domain & SSL Setup](docs/DOMAINS.md)
- [Session Management](docs/SESSIONS.md)
- [Docker Configuration](docs/DOCKER.md)
- [Development Guide](docs/DEVELOPMENT.md)
- [Troubleshooting](docs/TROUBLESHOOTING.md)
## License
[MIT](./LICENSE)