README.md

User Service

The user service manages user accounts and authentication. It creates and signs JWTs that are used by other services to authenticate users.

Implemented in Python with Flask.

Endpoints

Endpoint	Type	Auth?	Description
/login	GET		Returns a JWT if authentication is successful.
/ready	GET		Readiness probe endpoint.
/users	POST		Validates and creates a new user record.
/version	GET		Returns the contents of $VERSION

Environment Variables

• VERSION

  • a version string for the service

• PORT

  • the port for the webserver

• PRIV_KEY_PATH

  • the path to the private key for JWT signing, mounted as a secret

• TOKEN_EXPIRY_SECONDS

  • how long JWTs are valid before forcing user logout

• LOG_LEVEL

  • the service-specific logging level (default: INFO)

• ConfigMap environment-config:

  • LOCAL_ROUTING_NUM
    • the routing number for our bank
  • PUB_KEY_PATH
    • the path to the JWT signer's public key, mounted as a secret

• ConfigMap accounts-db-config:

  • ACCOUNTS_DB_URI
    • the complete URI for the accounts-db database

Kubernetes Resources

• deployments/userservice
• service/userservice