a23n

README

a23n

A simple authentication and authorization gRPC service.

Running in Docker

docker run --rm -it \
  -e A23N_DB_DSN="postgres://postgres:postgres@localhost:5432/postgres?sslmode=disable" \
  -e A23N_SERVER_SECRET=$(for N in {1..12}; do echo -n $RANDOM; done | base64 | head -c 64) \
  ashep/a23n:latest

Running in Kubernetes

To do.

Configuring via environment variables

• required string A23N_DB_DSN. PostgreSQL DSN.
• optional int A23N_API_TOKEN_TTL. Authentication token time to live. Default is 86400.
• optional int A23N_SERVER_ADDRESS. HTTP/gRPC listen address. Default is localhost:9000.
• required string A23N_SERVER_SECRET. Global server secret.
• optional int A23N_DEBUG. Set to 1 to enable debug mode. Any other value being ignored.

gRPC API

To do.

HTTP API

To do.

To Do

• Add caching.
• Complete this readme.
• Write unit tests.
• Write functional tests.

Changelog

0.0.2 (2023-03-13)

• New UpdateEntity method added.
• Item attrs renamed to scope.
• Logging improved.
• Configuration parameter api.secret moved to server.secret.
• CORS headers and OPTIONS method support added.
• Found bugs fixed.

0.0.1 (2023-03-05)

Initial version.

Authors

• Oleksandr Shepetko. Initial work.