feat(authentik): integrate Traefik dashboard with Authentik for admin access control and streamline secret management
ansible-core-net / deploy (push) Successful in 33s

This commit is contained in:
karpenok committed 2026-11-10 21:27:56 +07:00
1 parent 3a8ef2579b
commit 340964523e
8 files changed
+62 -34

No files matched your search

-4
View File
@@ -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
+8 -7
View File
@@ -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.
+8
View File
@@ -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"
@@ -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
+3 -1
View File
@@ -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
-1
View File
@@ -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') }}"
-14
View File
@@ -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 }}"
@@ -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 }}"