From 4042760a16b05149193b48c7427d311800447c7b Mon Sep 17 00:00:00 2001 From: Ben Vincent Date: Sun, 28 Jun 2026 11:55:26 +1000 Subject: [PATCH] Initial scaffold - Terraform module for groups, SAML/OAuth2/LDAP providers, applications, and LDAP outposts - Data-driven YAML config with Terragrunt config loader - Environment: identity.unkin.net with Consul backend - Provider: goauthentik/authentik 2026.5.0 - Woodpecker CI pipelines (pre-commit, plan, apply) - Makefile with Vault AppRole and K8s auth support --- .gitignore | 6 ++ .pre-commit-config.yaml | 24 ++++++ .woodpecker/apply.yaml | 23 +++++ .woodpecker/plan.yaml | 21 +++++ .woodpecker/pre-commit.yaml | 18 ++++ Makefile | 34 ++++++++ README.md | 34 +++++++- config/config.hcl | 31 +++++++ .../identity.unkin.net/terragrunt.hcl | 24 ++++++ environments/root.hcl | 32 +++++++ modules/authentik/main.tf | 85 +++++++++++++++++++ modules/authentik/variables.tf | 56 ++++++++++++ 12 files changed, 387 insertions(+), 1 deletion(-) create mode 100644 .gitignore create mode 100644 .pre-commit-config.yaml create mode 100644 .woodpecker/apply.yaml create mode 100644 .woodpecker/plan.yaml create mode 100644 .woodpecker/pre-commit.yaml create mode 100644 Makefile create mode 100644 config/config.hcl create mode 100644 environments/identity.unkin.net/terragrunt.hcl create mode 100644 environments/root.hcl create mode 100644 modules/authentik/main.tf create mode 100644 modules/authentik/variables.tf diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..13275b0 --- /dev/null +++ b/.gitignore @@ -0,0 +1,6 @@ +.terraform/ +*.tfstate +*.tfstate.backup +*.tfplan +backend.tf +.terragrunt-cache/ diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml new file mode 100644 index 0000000..646cd65 --- /dev/null +++ b/.pre-commit-config.yaml @@ -0,0 +1,24 @@ +repos: + - repo: https://github.com/pre-commit/pre-commit-hooks + rev: v4.4.0 + hooks: + - id: end-of-file-fixer + types: [yaml] + - id: trailing-whitespace + types: [yaml] + - repo: https://github.com/gruntwork-io/pre-commit + rev: v0.1.30 + hooks: + - id: tofu-fmt + - id: tofu-validate + - id: tflint + - id: terragrunt-hcl-fmt + - repo: https://github.com/adrienverge/yamllint.git + rev: v1.37.1 + hooks: + - id: yamllint + args: + [ + "-d {extends: relaxed, rules: {line-length: disable}, ignore: chart}", + "-s", + ] diff --git a/.woodpecker/apply.yaml b/.woodpecker/apply.yaml new file mode 100644 index 0000000..8c3e60f --- /dev/null +++ b/.woodpecker/apply.yaml @@ -0,0 +1,23 @@ +when: + - event: push + branch: main + +steps: + - name: apply + image: git.unkin.net/unkin/almalinux9-opentofu:20260606 + environment: + VAULT_AUTH_METHOD: kubernetes + commands: + - dnf install vault -y + - make plan + - make apply + backend_options: + kubernetes: + serviceAccountName: terraform-authentik + resources: + requests: + memory: 512Mi + cpu: 1 + limits: + memory: 2Gi + cpu: 2 diff --git a/.woodpecker/plan.yaml b/.woodpecker/plan.yaml new file mode 100644 index 0000000..9f7952c --- /dev/null +++ b/.woodpecker/plan.yaml @@ -0,0 +1,21 @@ +when: + - event: pull_request + +steps: + - name: plan + image: git.unkin.net/unkin/almalinux9-opentofu:20260606 + environment: + VAULT_AUTH_METHOD: kubernetes + commands: + - dnf install vault -y + - make plan + backend_options: + kubernetes: + serviceAccountName: terraform-authentik + resources: + requests: + memory: 512Mi + cpu: 1 + limits: + memory: 2Gi + cpu: 2 diff --git a/.woodpecker/pre-commit.yaml b/.woodpecker/pre-commit.yaml new file mode 100644 index 0000000..5c5738f --- /dev/null +++ b/.woodpecker/pre-commit.yaml @@ -0,0 +1,18 @@ +when: + - event: pull_request + +steps: + - name: pre-commit + image: git.unkin.net/unkin/almalinux9-opentofu:20260606 + commands: + - uvx pre-commit run --all-files + backend_options: + kubernetes: + serviceAccountName: default + resources: + requests: + memory: 512Mi + cpu: 1 + limits: + memory: 2Gi + cpu: 2 diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..fe3ec71 --- /dev/null +++ b/Makefile @@ -0,0 +1,34 @@ +.PHONY: init plan apply format + +VAULT_AUTH_METHOD ?= approle +VAULT_K8S_ROLE ?= woodpecker_terraform_authentik +VAULT_K8S_MOUNT ?= auth/k8s/au/syd1 +VAULT_K8S_JWT_PATH ?= /var/run/secrets/kubernetes.io/serviceaccount/token + +define vault_env + @export VAULT_ADDR="https://vault.service.consul:8200" && \ + if [ "$(VAULT_AUTH_METHOD)" = "kubernetes" ]; then \ + export VAULT_TOKEN=$$(vault write -field=token $(VAULT_K8S_MOUNT)/login role=$(VAULT_K8S_ROLE) jwt=$$(cat $(VAULT_K8S_JWT_PATH))); \ + else \ + export VAULT_TOKEN=$$(vault write -field=token auth/approle/login role_id=$$VAULT_ROLEID); \ + fi && \ + export CONSUL_HTTP_TOKEN=$$(vault read -field=token consul_root/au/syd1/creds/terraform-authentik) +endef + +init: + @$(call vault_env) && \ + terragrunt run --all --non-interactive init -- -upgrade + +plan: init + @$(call vault_env) && \ + terragrunt run --all --parallelism 4 --non-interactive plan + +apply: init + @$(call vault_env) && \ + terragrunt run --all --parallelism 2 --non-interactive apply + +format: + @echo "Formatting OpenTofu files..." + @tofu fmt -recursive . + @echo "Formatting Terragrunt files..." + @terragrunt hcl fmt diff --git a/README.md b/README.md index 5a88def..12f5c53 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,35 @@ # terraform-authentik -Terraform configuration for managing Authentik identity provider \ No newline at end of file +Terraform configuration for managing the Authentik identity provider at identity.unkin.net. + +## Managed Resources + +- **Groups** — roles and group hierarchy (users are invited manually) +- **SAML providers** — SAML application integrations +- **OAuth2/OIDC providers** — OAuth2 and OpenID Connect integrations +- **LDAP providers** — LDAP provider and outpost configuration +- **Applications** — application definitions linked to providers + +## Configuration + +Resources are defined as YAML files under `config/`: + +``` +config/ +├── groups/ # Group definitions +├── providers_saml/ # SAML provider definitions +├── providers_oauth2/ # OAuth2/OIDC provider definitions +└── providers_ldap/ # LDAP provider definitions +``` + +## Usage + +```sh +make plan # init + plan +make apply # init + plan + apply +make format # format all .tf and .hcl files +``` + +### Authentication + +Set `VAULT_ROLEID` for local AppRole auth, or `VAULT_AUTH_METHOD=kubernetes` for CI. diff --git a/config/config.hcl b/config/config.hcl new file mode 100644 index 0000000..97eeed2 --- /dev/null +++ b/config/config.hcl @@ -0,0 +1,31 @@ +locals { + config_files = fileset(".", "**/*.yaml") + + all_configs = { + for file_path in local.config_files : + file_path => yamldecode(file(file_path)) + } + + config = { + groups = { + for file_path, content in local.all_configs : + trimsuffix(basename(file_path), ".yaml") => content + if startswith(file_path, "groups/") + } + providers_saml = { + for file_path, content in local.all_configs : + trimsuffix(basename(file_path), ".yaml") => content + if startswith(file_path, "providers_saml/") + } + providers_oauth2 = { + for file_path, content in local.all_configs : + trimsuffix(basename(file_path), ".yaml") => content + if startswith(file_path, "providers_oauth2/") + } + providers_ldap = { + for file_path, content in local.all_configs : + trimsuffix(basename(file_path), ".yaml") => content + if startswith(file_path, "providers_ldap/") + } + } +} diff --git a/environments/identity.unkin.net/terragrunt.hcl b/environments/identity.unkin.net/terragrunt.hcl new file mode 100644 index 0000000..e5d25b3 --- /dev/null +++ b/environments/identity.unkin.net/terragrunt.hcl @@ -0,0 +1,24 @@ +include "root" { + path = find_in_parent_folders("root.hcl") + expose = true +} + +include "config" { + path = "${get_repo_root()}/config/config.hcl" + expose = true +} + +locals { + config = include.config.locals.config +} + +terraform { + source = "../../modules/authentik" +} + +inputs = { + groups = local.config.groups + providers_saml = local.config.providers_saml + providers_oauth2 = local.config.providers_oauth2 + providers_ldap = local.config.providers_ldap +} diff --git a/environments/root.hcl b/environments/root.hcl new file mode 100644 index 0000000..8574f82 --- /dev/null +++ b/environments/root.hcl @@ -0,0 +1,32 @@ +generate "backend" { + path = "backend.tf" + if_exists = "overwrite" + contents = <