API-Sheriff

Status

Build & Quality

Benchmarks

Understand Performance Metrics

What is it?

A security-focused API Gateway with a lightweight approach, built with Quarkus.

Table of Contents

• Status
• What is it?
• Maven Coordinates
• Modules
  • API Sheriff
  • Integration Tests
  • Performance Benchmarking
• Deployment
  • Production Docker Image
• External Resources

Maven Coordinates

<dependency>
    <groupId>de.cuioss.sheriff.api</groupId>
    <artifactId>api-sheriff</artifactId>
</dependency>

Modules

API Sheriff

The deployable Quarkus application module — core library, CDI producers, REST endpoints, and native executable target.

Integration Tests

Integration test coordinator — Docker infrastructure, native container builds, and IT suites with HTTPS support.

Performance Benchmarking

Integration benchmarks using WRK HTTP load testing with containerized environments.

Understand Performance Metrics

Deployment

Production Docker Image

Build the native executable and production Docker image:

# Build native executable
./mvnw clean install -Pnative -pl api-sheriff -am -DskipTests

# Build production Docker image
docker build -f api-sheriff/src/main/docker/Dockerfile.native -t api-sheriff:latest api-sheriff/

Run with TLS certificates mounted at runtime:

docker run -p 8443:8443 \
  -v /path/to/certs:/certs:ro \
  -e QUARKUS_HTTP_SSL_CERTIFICATE_FILES=/certs/server.crt \
  -e QUARKUS_HTTP_SSL_CERTIFICATE_KEY_FILES=/certs/server.key \
  api-sheriff:latest

• Port 8443 — All endpoints (/api/health, /api/info, /q/health, /q/metrics)

External Resources

• Generated Documentation on GitHub Pages