amusarra/quarkus-mtls-auth repository overview

⁠Quarkus mTLS Auth

This Docker image provides a sample Quarkus application configured for mutual TLS (mTLS) authentication. The project demonstrates how to secure REST endpoints using mTLS, manage client and server certificates, role and attribute mapping, and access policies.

⁠Main Features

• mTLS Authentication: Only clients with a valid certificate can access the APIs.
• Access Policies: Role control via custom extensions in client certificates.
• Protected REST Endpoints: /api/v1/connection-info/info and /api/v1/connection-info/user-identity.
• Easy Configuration: Environment variables to customize port, certificates, and policies.
• Ready for Testing and Development: Includes sample certificates and configurations for local environments.

⁠Usage

docker pull amusarra/quarkus-mtls-auth:latest
docker run -p 8443:8443 amusarra/quarkus-mtls-auth:latest

The application will be available at https://localhost:8443.

⁠Documentation

For details on configuration, certificate generation, and mTLS testing, see:

• Complete Guide⁠
• GitHub Repository⁠