Instalação: Proxy inverso e chaves de acesso

Âmbito: DiscVault v26 estável · DiscVault v26 betaDocker · web≥ DiscVault v26helmerzNL/DiscVault · helmerzNL/DiscVault.EU2026-07-20

Objetivo e resultado

Conclua o procedimento específico da página para Instalação: Proxy inverso e chaves de acesso. Este procedimento utiliza FQDN · RP_ORIGINS · RP_ID · LEGACY_AUTH_ENABLED · /install/legacy-authentication/ · /api/next/health.

Aplicável a

Esta página aplica-se apenas a Instalação: Proxy inverso e chaves de acesso (Docker · web). Os limites de canal e dados são: DiscVault · ghcr.io/helmerznl/discvault:latest; RP_ID RP_ORIGINS · 6080; fora da exceção localhost, as passkeys requerem um nome de domínio completo e estável por HTTPS fidedigno; um endereço IP isolado ou HTTP simples não são suportados; DiscVault · ghcr.io/helmerznl/discvault:beta; RP_ID RP_ORIGINS · 6180; LEGACY_AUTH_ENABLED=true. Pontos de controlo desta página: FQDN · RP_ORIGINS · RP_ID · LEGACY_AUTH_ENABLED · /install/legacy-authentication/ · /api/next/health.

DiscVault v26 estável

• DiscVault · ghcr.io/helmerznl/discvault:latest
• RP_ID RP_ORIGINS · 6080
• fora da exceção localhost, as passkeys requerem um nome de domínio completo e estável por HTTPS fidedigno; um endereço IP isolado ou HTTP simples não são suportados

DiscVault v26 beta

• DiscVault · ghcr.io/helmerznl/discvault:beta
• RP_ID RP_ORIGINS · 6180
• LEGACY_AUTH_ENABLED=true

Pré-requisitos

• FQDN
• RP_ORIGINS
• RP_ID

Alternativa Legacy Authentication

Disponível em beta

Legacy Authentication com nome de utilizador, palavra-passe e autenticação de dois fatores (2FA) está disponível no DiscVault 26 beta quando não é possível usar passkeys.

Siga /install/legacy-authentication/ antes de ativar a funcionalidade ou criar o primeiro proprietário.

Procedimento

1. Escolher: FQDN · fora da exceção localhost, as passkeys requerem um nome de domínio completo e estável por HTTPS fidedigno; um endereço IP isolado ou HTTP simples não são suportados
2. Escolher: Instalação: Legacy Authentication · para um IP privado ou loopback direto sem FQDN deixe RP_ID e RP_ORIGINS vazios
3. Configurar: RP_ID
4. Configurar: RP_ORIGINS · HTTPS
5. Configurar: 6080 6180
6. Testar: GET /api/next/health
7. Registar: escolha o nome do anfitrião antes de registar passkeys; alterá-lo depois exige novo registo, enquanto localhost continua apenas uma exceção local

Comandos e definições

DiscVault v26 estável

RP_ID=discvault.example.com
RP_NAME=DiscVault
RP_ORIGINS=https://discvault.example.com
curl --fail https://discvault.example.com/api/next/health

DiscVault v26 beta

RP_ID=discvault.example.com
RP_NAME=DiscVault
RP_ORIGINS=https://discvault.example.com
LEGACY_AUTH_ENABLED=true
curl --fail http://localhost:6180/api/next/health

Resultado esperado

Aceite o resultado de Instalação: Proxy inverso e chaves de acesso apenas quando todos os resultados abaixo forem confirmados: HTTPS · HTTP 2xx; RP_ID; RP_ID é o nome do anfitrião sem esquema ou porta, enquanto RP_ORIGINS é a origem HTTPS completa exata; ambos devem corresponder ao endereço aberto no navegador. Pontos de controlo desta página: FQDN · RP_ORIGINS · RP_ID · LEGACY_AUTH_ENABLED · /install/legacy-authentication/ · /api/next/health.

• HTTPS · HTTP 2xx
• RP_ID
• RP_ID é o nome do anfitrião sem esquema ou porta, enquanto RP_ORIGINS é a origem HTTPS completa exata; ambos devem corresponder ao endereço aberto no navegador

Segurança e reversão

Cuidado

O limite de recuperação segura de Instalação: Proxy inverso e chaves de acesso exige estas ações antes de iniciar ou continuar: escolha o nome do anfitrião antes de registar passkeys; alterá-lo depois exige novo registo, enquanto localhost continua apenas uma exceção local; apenas um pedido privado ou loopback direto com RP inválido ou vazio pode oferecer arranque sem TOTP; mantenha TOTP para utilizador, palavra-passe e 2FA; restaure em conjunto o proxy e os valores RP e mantenha um método de recuperação do proprietário. Pontos de controlo desta página: FQDN · RP_ORIGINS · RP_ID · LEGACY_AUTH_ENABLED · /install/legacy-authentication/ · /api/next/health.

• escolha o nome do anfitrião antes de registar passkeys; alterá-lo depois exige novo registo, enquanto localhost continua apenas uma exceção local
• apenas um pedido privado ou loopback direto com RP inválido ou vazio pode oferecer arranque sem TOTP; mantenha TOTP para utilizador, palavra-passe e 2FA
• restaure em conjunto o proxy e os valores RP e mantenha um método de recuperação do proprietário

Próximo passo

Instalação: Primeiro arranque e verificação de estado

Fonte e estado

• helmerzNL/DiscVault@4352c060ccd6
• helmerzNL/DiscVault.EU@583f85c55dc2
• Moving beta source: Legacy Authentication deployment notes
• Pinned verification: next_auth.py
• Pinned verification: next_legacy_auth.py
• Pinned verification: Legacy Authentication schema
• Pinned verification: unified recovery codes
• Fonte e estado: 2026-07-20
• DiscVault Docs: 0.1.6