From 10cf792e4ef957a7aa8a65b15d95d8df56162a2c Mon Sep 17 00:00:00 2001 From: karpenok Date: Tue, 10 Nov 2026 19:40:54 +0700 Subject: [PATCH] feat(auth): deploy Authentik on CT 902 with Zero-Knowledge secret bootstrap and safe Traefik route --- .gitea/workflows/ansible-core-net.yml | 19 ++++ BOOTSTRAP.md | 3 + ansible/playbooks/core_net.yml | 4 +- ansible/roles/authentik/defaults/main.yml | 6 ++ ansible/roles/authentik/tasks/main.yml | 35 ++++++++ .../roles/authentik/templates/compose.yaml.j2 | 87 +++++++++++++++++++ .../core_net/files/dynamic/authentik.yml | 33 +++++++ 7 files changed, 185 insertions(+), 2 deletions(-) create mode 100644 ansible/roles/authentik/defaults/main.yml create mode 100644 ansible/roles/authentik/tasks/main.yml create mode 100644 ansible/roles/authentik/templates/compose.yaml.j2 create mode 100644 ansible/roles/core_net/files/dynamic/authentik.yml diff --git a/.gitea/workflows/ansible-core-net.yml b/.gitea/workflows/ansible-core-net.yml index 719dff5..2700093 100644 --- a/.gitea/workflows/ansible-core-net.yml +++ b/.gitea/workflows/ansible-core-net.yml @@ -6,6 +6,7 @@ on: - main paths: - 'ansible/roles/core_net/**' + - 'ansible/roles/authentik/**' - 'ansible/playbooks/core_net.yml' workflow_dispatch: @@ -41,6 +42,24 @@ jobs: eval "$(infisical export --domain="${INFISICAL_DOMAIN}" --token="${TOKEN}" --env=prod --projectId="${INFISICAL_PROJECT_ID}" --path="/services/traefik" --format=dotenv-export --silent)" export TRAEFIK_DASHBOARD_AUTH="${TRAEFIK_DASHBOARD_AUTH:-}" + # Проверяем наличие секретов Authentik в /services/authentik. + # При первом запуске раннер сам генерирует их и сохраняет в Infisical (Zero-Knowledge). + if ! infisical export --domain="${INFISICAL_DOMAIN}" --token="${TOKEN}" --env=prod --projectId="${INFISICAL_PROJECT_ID}" --path="/services/authentik" --format=dotenv-export --silent 2>/dev/null | grep -q 'AUTHENTIK_SECRET_KEY'; then + infisical secrets-manager folders create authentik --path /services --env prod --projectId "${INFISICAL_PROJECT_ID}" --domain "${INFISICAL_DOMAIN}" --token "${TOKEN}" --silent 2>/dev/null || true + GEN_SECRET_KEY=$(openssl rand -base64 48 | tr -dc 'a-zA-Z0-9' | head -c 50) + GEN_PG_PASS=$(openssl rand -hex 20) + infisical secrets set --domain="${INFISICAL_DOMAIN}" --token="${TOKEN}" --env=prod --projectId="${INFISICAL_PROJECT_ID}" --path="/services/authentik" \ + "AUTHENTIK_SECRET_KEY=${GEN_SECRET_KEY}" \ + "AUTHENTIK_POSTGRES_PASSWORD=${GEN_PG_PASS}" \ + --silent + unset GEN_SECRET_KEY GEN_PG_PASS + fi + + # Экспорт секретов Authentik из /services/authentik + eval "$(infisical export --domain="${INFISICAL_DOMAIN}" --token="${TOKEN}" --env=prod --projectId="${INFISICAL_PROJECT_ID}" --path="/services/authentik" --format=dotenv-export --silent)" + export AUTHENTIK_SECRET_KEY="${AUTHENTIK_SECRET_KEY:-}" + export AUTHENTIK_POSTGRES_PASSWORD="${AUTHENTIK_POSTGRES_PASSWORD:-}" + if [ -z "${RUNNER_SSH_KEY:-}" ]; then echo "В Infisical (/ci-cd) отсутствует RUNNER_SSH_KEY" >&2 exit 1 diff --git a/BOOTSTRAP.md b/BOOTSTRAP.md index 53fc2c9..d4986ae 100644 --- a/BOOTSTRAP.md +++ b/BOOTSTRAP.md @@ -43,6 +43,9 @@ API Endpoint (внутренний LAN): `http://192.168.1.102:8080/api` - `AUTH_SECRET`: base64 секрет сессий/JWT Infisical. - `/services/traefik`: - `TRAEFIK_DASHBOARD_AUTH`: строка basicAuth для дашборда (`user:$2y$05$...`). +- `/services/authentik`: + - `AUTHENTIK_SECRET_KEY`: случайный ключ шифрования сессий Authentik. + - `AUTHENTIK_POSTGRES_PASSWORD`: пароль БД PostgreSQL Authentik. - `/services/netbird`: - `COMPOSE_PROJECT_NAME`: имя docker compose проекта (`netbird`). - `NETBIRD_DOMAIN`: домен панели NetBird. diff --git a/ansible/playbooks/core_net.yml b/ansible/playbooks/core_net.yml index 0d5a14a..5abe01a 100644 --- a/ansible/playbooks/core_net.yml +++ b/ansible/playbooks/core_net.yml @@ -1,7 +1,7 @@ --- -- name: Развернуть сетевой шлюз Traefik (core-net) +- name: Развернуть сетевой шлюз и аутентификацию (core-net) hosts: core_net become: true roles: - core_net - + - authentik diff --git a/ansible/roles/authentik/defaults/main.yml b/ansible/roles/authentik/defaults/main.yml new file mode 100644 index 0000000..93c8826 --- /dev/null +++ b/ansible/roles/authentik/defaults/main.yml @@ -0,0 +1,6 @@ +--- +authentik_version: "2024.12.3" +authentik_dir: "/opt/authentik" +authentik_http_port: 9000 +authentik_secret_key: "{{ lookup('env', 'AUTHENTIK_SECRET_KEY') }}" +authentik_postgres_password: "{{ lookup('env', 'AUTHENTIK_POSTGRES_PASSWORD') }}" diff --git a/ansible/roles/authentik/tasks/main.yml b/ansible/roles/authentik/tasks/main.yml new file mode 100644 index 0000000..3b5ad72 --- /dev/null +++ b/ansible/roles/authentik/tasks/main.yml @@ -0,0 +1,35 @@ +--- +- name: Создать каталоги для сервиса Authentik + ansible.builtin.file: + path: "{{ item }}" + state: directory + owner: root + group: root + mode: "0750" + loop: + - "{{ authentik_dir }}" + - "{{ authentik_dir }}/db" + - "{{ authentik_dir }}/redis" + - "{{ authentik_dir }}/media" + - "{{ authentik_dir }}/custom-templates" + +- name: Проверить наличие обязательных секретов Authentik + ansible.builtin.assert: + that: + - authentik_secret_key is defined and authentik_secret_key | length > 0 + - authentik_postgres_password is defined and authentik_postgres_password | length > 0 + fail_msg: "Один или оба секрета Authentik (AUTHENTIK_SECRET_KEY, AUTHENTIK_POSTGRES_PASSWORD) не переданы через переменные окружения!" + +- name: Установить compose.yaml для Authentik + ansible.builtin.template: + src: compose.yaml.j2 + dest: "{{ authentik_dir }}/compose.yaml" + owner: root + group: root + mode: "0600" + no_log: true + +- name: Запустить сервисы Authentik через Docker Compose + ansible.builtin.command: docker compose -f {{ authentik_dir }}/compose.yaml up -d --remove-orphans + register: compose_up + changed_when: "'Started' in compose_up.stderr or 'Created' in compose_up.stderr or 'Recreated' in compose_up.stderr or 'Pulled' in compose_up.stderr" diff --git a/ansible/roles/authentik/templates/compose.yaml.j2 b/ansible/roles/authentik/templates/compose.yaml.j2 new file mode 100644 index 0000000..ec7b259 --- /dev/null +++ b/ansible/roles/authentik/templates/compose.yaml.j2 @@ -0,0 +1,87 @@ +services: + authentik-db: + image: postgres:16-alpine + container_name: authentik-db + restart: unless-stopped + environment: + POSTGRES_PASSWORD: {{ authentik_postgres_password }} + POSTGRES_USER: authentik + POSTGRES_DB: authentik + volumes: + - {{ authentik_dir }}/db:/var/lib/postgresql/data + healthcheck: + test: ["CMD-SHELL", "pg_isready -d authentik -U authentik"] + interval: 5s + timeout: 5s + retries: 10 + networks: + - authentik-net + + authentik-redis: + image: redis:alpine + container_name: authentik-redis + restart: unless-stopped + volumes: + - {{ authentik_dir }}/redis:/data + healthcheck: + test: ["CMD-SHELL", "redis-cli ping | grep PONG"] + interval: 5s + timeout: 5s + retries: 10 + networks: + - authentik-net + + authentik-server: + image: ghcr.io/goauthentik/server:{{ authentik_version }} + container_name: authentik-server + restart: unless-stopped + command: server + environment: + AUTHENTIK_REDIS__HOST: authentik-redis + AUTHENTIK_POSTGRESQL__HOST: authentik-db + AUTHENTIK_POSTGRESQL__USER: authentik + AUTHENTIK_POSTGRESQL__NAME: authentik + AUTHENTIK_POSTGRESQL__PASSWORD: {{ authentik_postgres_password }} + AUTHENTIK_SECRET_KEY: {{ authentik_secret_key }} + volumes: + - {{ authentik_dir }}/media:/media + - {{ authentik_dir }}/custom-templates:/templates + ports: + - "127.0.0.1:{{ authentik_http_port }}:9000" + depends_on: + authentik-db: + condition: service_healthy + authentik-redis: + condition: service_healthy + networks: + - authentik-net + + authentik-worker: + image: ghcr.io/goauthentik/server:{{ authentik_version }} + container_name: authentik-worker + restart: unless-stopped + command: worker + environment: + AUTHENTIK_REDIS__HOST: authentik-redis + AUTHENTIK_POSTGRESQL__HOST: authentik-db + AUTHENTIK_POSTGRESQL__USER: authentik + AUTHENTIK_POSTGRESQL__NAME: authentik + AUTHENTIK_POSTGRESQL__PASSWORD: {{ authentik_postgres_password }} + AUTHENTIK_SECRET_KEY: {{ authentik_secret_key }} + user: root + volumes: + - /var/run/docker.sock:/var/run/docker.sock + - {{ authentik_dir }}/media:/media + - {{ authentik_dir }}/custom-templates:/templates + depends_on: + authentik-db: + condition: service_healthy + authentik-redis: + condition: service_healthy + networks: + - authentik-net + +networks: + authentik-net: + name: authentik-net + driver: bridge diff --git a/ansible/roles/core_net/files/dynamic/authentik.yml b/ansible/roles/core_net/files/dynamic/authentik.yml new file mode 100644 index 0000000..ee4384b --- /dev/null +++ b/ansible/roles/core_net/files/dynamic/authentik.yml @@ -0,0 +1,33 @@ +http: + routers: + authentik: + rule: "Host(`auth.gunihome.ru`)" + entryPoints: + - websecure + service: authentik + tls: + certResolver: letsencrypt + + services: + authentik: + loadBalancer: + servers: + - url: "http://127.0.0.1:9000" + + middlewares: + authentik: + forwardAuth: + address: "http://127.0.0.1:9000/outpost.goauthentik.io/auth/traefik" + trustForwardHeader: true + authResponseHeaders: + - "X-authentik-username" + - "X-authentik-groups" + - "X-authentik-email" + - "X-authentik-name" + - "X-authentik-uid" + - "X-authentik-jwt" + - "X-authentik-meta-jwks" + - "X-authentik-meta-outpost" + - "X-authentik-meta-provider" + - "X-authentik-meta-app" + - "X-authentik-meta-version"