Installation

ezoidc is made up of two components:

• ezoidc-server - a server that validates tokens from an OIDC provider, evaluates the policy and fetches the allowed variables.
• ezoidc - a CLI to consume the variables from a server.

The server must be configured with a policy, variables, and a list issuers that are allowed to use the server.

Installation

Docker

docker pull ghcr.io/ezoidc/ezoidc/cli
docker pull ghcr.io/ezoidc/ezoidc/server

When using the server container, the configuration file can be mounted into the container and its path provided as the first argument.

docker run --rm -it -p 127.0.0.1:3501:3501 \
  -v $PWD/config.yaml:/config.yaml:ro \
  ghcr.io/ezoidc/ezoidc/server

Go

ezoidc requires Go 1.23 or higher.

Go install

go install github.com/ezoidc/ezoidc/cmd/ezoidc@latest
go install github.com/ezoidc/ezoidc/cmd/ezoidc-server@latest

Building from source

git clone https://github.com/ezoidc/ezoidc && cd ezoidc
go build ./cmd/ezoidc
go build ./cmd/ezoidc-server