From 340964523e2693cf33e760c3077aa12af7b8ee98 Mon Sep 17 00:00:00 2001 From: karpenok Date: Tue, 10 Nov 2026 21:27:56 +0700 Subject: [PATCH] feat(authentik): integrate Traefik dashboard with Authentik for admin access control and streamline secret management --- .gitea/workflows/ansible-core-net.yml | 4 -- BOOTSTRAP.md | 15 +++---- ansible/playbooks/core_net.yml | 8 ++++ .../files/blueprints/traefik-dashboard.yaml | 42 +++++++++++++++++++ ansible/roles/authentik/tasks/main.yml | 4 +- ansible/roles/core_net/defaults/main.yml | 1 - ansible/roles/core_net/tasks/main.yml | 14 ------- .../templates/dynamic/dashboard.yml.j2 | 8 +--- 8 files changed, 62 insertions(+), 34 deletions(-) create mode 100644 ansible/roles/authentik/files/blueprints/traefik-dashboard.yaml diff --git a/.gitea/workflows/ansible-core-net.yml b/.gitea/workflows/ansible-core-net.yml index 2700093..01af788 100644 --- a/.gitea/workflows/ansible-core-net.yml +++ b/.gitea/workflows/ansible-core-net.yml @@ -38,10 +38,6 @@ jobs: # Экспорт SSH-ключа раннера из /ci-cd eval "$(infisical export --domain="${INFISICAL_DOMAIN}" --token="${TOKEN}" --env=prod --projectId="${INFISICAL_PROJECT_ID}" --path="/ci-cd" --format=dotenv-export --silent)" - # Экспорт секретов Traefik из /services/traefik - 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 diff --git a/BOOTSTRAP.md b/BOOTSTRAP.md index d4986ae..f10f20d 100644 --- a/BOOTSTRAP.md +++ b/BOOTSTRAP.md @@ -1,6 +1,6 @@ # Инструкция по развертыванию инфраструктуры (Bootstrap Guide) -Данный документ описывает полную топологию хоумлаба, порядок холодного развертывания с нуля и структуру управления секретами через Infisical. +Документ описывает контур, который поднимает этот репозиторий, порядок холодного старта и секреты в Infisical. Gitea в автоматизацию не входит: без неё не запустить пайплайны. --- @@ -18,7 +18,7 @@ |---|---|---|---|---| | **CT 109** | `pve` | `192.168.1.217` | `gitea` | Gitea (`:3000`), Postgres (`:5432`), Gitea Actions Runner (`dind`) | | **CT 901** | `netcore` | `192.168.1.102` | `core-secrets` | Infisical (`:8080`), Postgres, Redis, Vaultwarden (`:8000`) | -| **CT 902** | `netcore` | `192.168.1.104` | `core-net` | Traefik (`:80`, `:443`, `:8080`), ACME Let's Encrypt | +| **CT 902** | `netcore` | `192.168.1.104` | `core-net` | Traefik (`:80`, `:443`), Authentik (`127.0.0.1:9000`) | ### 1.3. Внешние узлы | Имя | IP | Роль | Стек | @@ -41,8 +41,6 @@ API Endpoint (внутренний LAN): `http://192.168.1.102:8080/api` - `POSTGRES_PASSWORD`: пароль БД Infisical. - `ENCRYPTION_KEY`: 32-байтный hex-ключ шифрования хранилища. - `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. @@ -89,10 +87,13 @@ API Endpoint (внутренний LAN): `http://192.168.1.102:8080/api` - `INFISICAL_CLIENT_ID` (Machine Identity: `ci-cd-runner`) - `INFISICAL_CLIENT_SECRET` -### Шаг 4. Маршрутизатор Traefik (CT 902) +Дальнейшие изменения этого стека накатывает пайплайн **`ansible-core-secrets`**. Первым запуском он не заменяет ручной старт: мастер-ключи ещё неоткуда прочитать. + +### Шаг 4. Traefik и Authentik (CT 902) 1. Запустить пайплайн **`ansible-core-net`** в Gitea Actions. -2. Раннер подключается напрямую к `http://192.168.1.102:8080/api`, забирает SSH-ключ раннера и `TRAEFIK_DASHBOARD_AUTH`, после чего накатывает конфигурацию Traefik на CT 902. -3. Проверить вход на внешние домены (`gitea.gunihome.ru`, `infisical.gunihome.ru`). +2. Раннер подключается напрямую к `http://192.168.1.102:8080/api`, забирает SSH-ключ раннера и секреты Authentik из `/services/authentik`. Если секретов Authentik ещё нет, раннер генерирует их и сохраняет в Infisical. +3. Плейбук поднимает на CT 902 Traefik и Authentik. Authentik слушает только `127.0.0.1:9000`; снаружи его публикует Traefik как `https://auth.gunihome.ru`. Blueprint создаёт группы `admins` и `family`, пользователей `karpenok` и `ksynia` и закрывает панель Traefik группой `admins`. Пароли blueprint не задаёт. +4. Проверить `https://auth.gunihome.ru`, `https://proxy.gunihome.ru`, `gitea.gunihome.ru` и `infisical.gunihome.ru`. Панель открывается учёткой из группы `admins`. Первый запуск Authentik создаёт `akadmin`; одноразовый пароль пишется в лог контейнера `authentik-server`. `akadmin` в группу `admins` не входит. ### Шаг 5. Внешние сервисы (NetBird на VPS) 1. Запустить пайплайн **`netbird-install`** в Gitea Actions. diff --git a/ansible/playbooks/core_net.yml b/ansible/playbooks/core_net.yml index 5abe01a..f3916ce 100644 --- a/ansible/playbooks/core_net.yml +++ b/ansible/playbooks/core_net.yml @@ -5,3 +5,11 @@ roles: - core_net - authentik + tasks: + - name: Закрыть панель Traefik через Authentik + ansible.builtin.template: + src: "{{ playbook_dir }}/../roles/core_net/templates/dynamic/dashboard.yml.j2" + dest: "{{ traefik_dynamic_dir }}/dashboard.yml" + owner: root + group: root + mode: "0644" diff --git a/ansible/roles/authentik/files/blueprints/traefik-dashboard.yaml b/ansible/roles/authentik/files/blueprints/traefik-dashboard.yaml new file mode 100644 index 0000000..f683f3b --- /dev/null +++ b/ansible/roles/authentik/files/blueprints/traefik-dashboard.yaml @@ -0,0 +1,42 @@ +# yaml-language-server: $schema=https://goauthentik.io/blueprints/schema.json +# Панель Traefik. Список providers у встроенного outpost полный: +# следующий proxy-провайдер добавляется сюда же. +version: 1 +metadata: + name: traefik-dashboard + labels: + blueprints.goauthentik.io/description: "Панель Traefik только для группы admins" +entries: + - model: authentik_providers_proxy.proxyprovider + id: provider-traefik-dashboard + identifiers: + name: traefik-dashboard + attrs: + mode: forward_single + external_host: https://proxy.gunihome.ru + authorization_flow: !Find [authentik_flows.flow, [slug, default-provider-authorization-implicit-consent]] + invalidation_flow: !Find [authentik_flows.flow, [slug, default-provider-invalidation-flow]] + + - model: authentik_core.application + id: app-traefik-dashboard + identifiers: + slug: traefik-dashboard + attrs: + name: Traefik + meta_launch_url: https://proxy.gunihome.ru + policy_engine_mode: any + provider: !KeyOf provider-traefik-dashboard + + - model: authentik_policies.policybinding + identifiers: + order: 0 + target: !KeyOf app-traefik-dashboard + attrs: + group: !Find [authentik_core.group, [name, admins]] + + - model: authentik_outposts.outpost + identifiers: + name: authentik Embedded Outpost + attrs: + providers: + - !KeyOf provider-traefik-dashboard diff --git a/ansible/roles/authentik/tasks/main.yml b/ansible/roles/authentik/tasks/main.yml index 3202772..78ab3ce 100644 --- a/ansible/roles/authentik/tasks/main.yml +++ b/ansible/roles/authentik/tasks/main.yml @@ -53,7 +53,9 @@ - name: Применить blueprint каталога пользователей Authentik ansible.builtin.command: >- docker compose -f {{ authentik_dir }}/compose.yaml exec -T authentik-worker - ak apply_blueprint /blueprints/custom/homelab-directory.yaml + ak apply_blueprint + /blueprints/custom/homelab-directory.yaml + /blueprints/custom/traefik-dashboard.yaml register: authentik_blueprint_apply changed_when: authentik_blueprint.changed retries: 18 diff --git a/ansible/roles/core_net/defaults/main.yml b/ansible/roles/core_net/defaults/main.yml index 4947095..e66f538 100644 --- a/ansible/roles/core_net/defaults/main.yml +++ b/ansible/roles/core_net/defaults/main.yml @@ -4,4 +4,3 @@ traefik_dir: "/opt/traefik" traefik_dynamic_dir: "/opt/traefik/dynamic" traefik_log_dir: "/var/log/traefik" traefik_acme_email: "vvkarpenok@gmail.com" -traefik_dashboard_auth: "{{ lookup('env', 'TRAEFIK_DASHBOARD_AUTH') }}" diff --git a/ansible/roles/core_net/tasks/main.yml b/ansible/roles/core_net/tasks/main.yml index c3cc5af..34f1d9a 100644 --- a/ansible/roles/core_net/tasks/main.yml +++ b/ansible/roles/core_net/tasks/main.yml @@ -60,12 +60,6 @@ group: root mode: "0644" -- name: Проверить наличие обязательных секретов Traefik - ansible.builtin.assert: - that: - - traefik_dashboard_auth is defined and traefik_dashboard_auth | length > 0 - fail_msg: "Переменная TRAEFIK_DASHBOARD_AUTH не передана из Infisical!" - - name: Синхронизировать динамические конфигурации маршрутов ansible.builtin.copy: src: dynamic/ @@ -74,14 +68,6 @@ group: root mode: "0644" -- name: Установить конфигурацию Traefik dashboard - ansible.builtin.template: - src: dynamic/dashboard.yml.j2 - dest: "{{ traefik_dynamic_dir }}/dashboard.yml" - owner: root - group: root - mode: "0644" - - name: Найти существующие файлы маршрутов на сервере ansible.builtin.find: paths: "{{ traefik_dynamic_dir }}" diff --git a/ansible/roles/core_net/templates/dynamic/dashboard.yml.j2 b/ansible/roles/core_net/templates/dynamic/dashboard.yml.j2 index fa92773..92a207e 100644 --- a/ansible/roles/core_net/templates/dynamic/dashboard.yml.j2 +++ b/ansible/roles/core_net/templates/dynamic/dashboard.yml.j2 @@ -6,12 +6,6 @@ http: - websecure service: api@internal middlewares: - - dashboard-auth + - authentik@file tls: certResolver: letsencrypt - - middlewares: - dashboard-auth: - basicAuth: - users: - - "{{ traefik_dashboard_auth }}"