Quick Start

Quick Start

Run from source

Terminal 1: authorization server.

go run ./cmd/orionis-auth -config ./config/orionis.example.json

Terminal 2: protected billing service.

go run ./examples/gin-billing-service

Terminal 3: orders client.

go run ./examples/gin-orders-client

Expected output:

status=201
{"amount":1500,"called_by":"orders-service","invoice_id":"inv_demo_001","order_id":"ord_demo_001","scope":"billing.invoice.create"}

Run with Docker Compose

docker compose up --build --wait -d orionis-auth billing-api
docker compose run --rm orders-client
docker compose down --remove-orphans

Do not use docker compose down -v unless you intentionally want to delete the generated local signing key stored in the orionis-var volume.

Request a token manually

curl -s \
  -u 'orders-service:orders-local-secret-change-me' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'grant_type=client_credentials' \
  -d 'audience=billing-api' \
  -d 'scope=billing.invoice.create' \
  http://localhost:8080/oauth/token | jq

Validate JWKS

curl -s http://localhost:8080/.well-known/jwks.json | jq