https://valoryx.org/uk/docs/configuration/ Recent content in Конфігурація on Valoryx Hugo uk https://valoryx.org/uk/docs/configuration/environment/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/configuration/environment/ Змінні середовища DocPlatform зчитує конфігурацію зі змінних середовища. Встановіть їх в оболонці, у файлі .env в робочій директорії або в оркестраторі контейнерів. Сервер Змінна За замовчуванням Опис PORT 3000 HTTP порт прослуховування HOST 0.0.0.0 HTTP адреса прослуховування. Встановіть 127.0.0.1, щоб обмежити лише localhost. DATA_DIR .docplatform Коренева директорія для всіх даних DocPlatform (база даних, резервні копії, робочі простори, ключі) BASE_DOMAIN — Власний домен для опублікованої документації (наприклад, docs.yourcompany.com). Коли встановлено, опублікована документація використовує цей домен для канонічних URL та записів sitemap. https://valoryx.org/uk/docs/configuration/authentication/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/configuration/authentication/ Автентифікація DocPlatform підтримує локальну автентифікацію (email + пароль) одразу після встановлення, з опціональним входом через Google та GitHub OIDC для команд, що використовують цих провайдерів. Локальна автентифікація (за замовчуванням) Локальна автентифікація працює без жодної конфігурації. Користувачі реєструються з email та паролем, і входять з тими ж обліковими даними. Як це працює Реєстрація — Користувач надсилає email + пароль. Пароль хешується за допомогою argon2id (рекомендований алгоритм OWASP 2024). Вхід — Користувач надсилає облікові дані. https://valoryx.org/uk/docs/configuration/permissions/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/configuration/permissions/ Ролі та права доступу DocPlatform використовує контроль доступу на основі ролей (RBAC) на базі вбудованого авторизаційного рушія, що працює в процесі. Перевірка прав доступу виконується менш ніж за 0,1 мс без зовнішнього сервісу. Ієрархія ролей DocPlatform визначає 5 ролей у строгій ієрархії. Вищі ролі успадковують усі права нижчих ролей. Super Admin ← Повний доступ до платформи (усі робочі простори) │ Admin ← Управління налаштуваннями робочого простору, учасниками, git, темою │ Editor ← Створення та редагування сторінок (налаштовується для кожного workspace) │ Commenter ← Перегляд сторінок, залишення коментарів │ Viewer ← Лише перегляд сторінок Platform Owner — внутрішня роль для операторів самостійно розгорнутих екземплярів, призначена для обслуговування платформи (міграції бази даних, управління ліцензіями, конфігурація системи). https://valoryx.org/uk/docs/configuration/workspace-config/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/uk/docs/configuration/workspace-config/ Налаштування робочого простору Кожен робочий простір має власний конфігураційний файл за адресою .docplatform/workspaces/{workspace-id}/.docplatform/config.yaml. Редагуйте цей файл безпосередньо або використовуйте веб-інтерфейс (Settings → Workspace). Повний довідник конфігурації # Workspace identity workspace_id: 01KJJ10NTF31Z1QJTG4ZRQZ2Z2 # Auto-generated ULID name: "Engineering Docs" # Display name slug: eng-docs # URL slug for published docs description: "Internal engineering documentation" # Git synchronization git_remote: git@github.com:your-org/eng-docs.git git_branch: main git_auto_commit: true # Auto-commit editor saves to git sync_interval: 300 # Polling interval in seconds (0 = disabled) # Theme theme: mode: auto # light, dark, auto (follows system preference) accent: blue # Accent color for published site # Publishing defaults publishing: default_published: false # New pages published by default?