From 219e349f5e00299e21c207699397c89fc20a82b0 Mon Sep 17 00:00:00 2001 From: mcgin314 Date: Wed, 16 Apr 2025 12:54:20 -0400 Subject: [PATCH] Update documentation --- README.md | 4 ++++ simple-arch.svg | 36 ++++++++++++++++++++++++++++++++++++ 2 files changed, 40 insertions(+) create mode 100644 simple-arch.svg diff --git a/README.md b/README.md index bc977c9..63a9699 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,10 @@ Terraform module for deploying and configuring Keycloak on EKS clusters. +Keycloak is a temporary OIDC solution to our clusters for enabling SSO login to the three web applications core to observability with the platform, ie. the Kubernetes Dashboard, Grafana and Kiali. Eventually, Keycloak will be replaced with OKTA provided OIDC, once TCO is ready for supporting this integration. Keycloak works in concert with GoGatekeeper that serves as an OIDC proxy fronting the web applications and validating the tokens originating from Keycloak. In our current configuration, we have a single generic user named `user` that acts as a master key for authenticating with Keycloak in the `cluster-user` realm, which is created by this module, and may access any of these applications. To retrieve the generic user password, run the following command: `kubectl get secret -n keycloak keycloak-user-creds -o jsonpath="{.data.password}" | base64 --decode ; echo` + +![Explanation of architecture](./simple-arch.svg "Explanation of architecture") + ## Overview - Deploys Keycloak identity and access management solution - Configures AWS integration for authentication diff --git a/simple-arch.svg b/simple-arch.svg new file mode 100644 index 0000000..e354988 --- /dev/null +++ b/simple-arch.svg @@ -0,0 +1,36 @@ + + + + + +
+ + +