IMAGO
Ligar a um servidor protegido
A maioria das pessoas liga o IMAGO ao Immich com um endereço e uma chave API, e não precisa de mais nada. Esta página é para quando o servidor está atrás de algo que pede mais antes de deixar passar: um túnel Cloudflare com Access, uma proxy que verifica um cabeçalho secreto, um servidor que pede um certificado ao telemóvel, ou um certificado de uma sua autoridade. No IMAGO tudo isto está em Avançado, no formulário que adiciona um servidor ou um endereço.
Estas opções estão em teste. São novas e foram experimentadas em poucas configurações. Se alguma coisa não funcionar na sua, diga-nos: é assim que melhoram.
Primeiro, o mais simples
Antes de configurar o que se segue, três coisas evitam-no, e o projecto Immich recomenda-as em vez das opções de rede da sua própria app, que descreve como experimentais:
- Dois endereços na mesma biblioteca. Junte o endereço de casa e o de fora com Acrescentar endereço; o IMAGO usa o que responder.
- Uma VPN, como o Tailscale ou o WireGuard. Para o IMAGO é só mais um endereço.
- Um certificado de uma autoridade pública, como o Let’s Encrypt, num domínio seu.
O que se guarda, e para onde vai
- Os cabeçalhos e os certificados pertencem a um endereço, não à app: o endereço de casa não recebe o que o de fora precisa.
- Só são enviados por https://, e só para esse endereço. Se um pedido for redireccionado para outro anfitrião, não o acompanham.
- Ficam cifrados no aparelho, nunca vão para os servidores do IMAGO, nunca entram na sincronização da conta e nunca são escritos no relatório de suporte. O relatório só diz que um endereço tem cabeçalhos ou um certificado, nunca quais.
Atrás do Cloudflare Access
O IMAGO não consegue mostrar uma página de login, por isso usa um service token, que a Cloudflare criou para apps e scripts.
- No painel da Cloudflare, vá a Zero Trust → Access controls → Service credentials → Service Tokens e escolha Create Service Token.
- Dê-lhe um nome e uma duração e escolha Generate token. Copie já o Client Secret: a Cloudflare só o mostra uma vez.
- Na política da sua aplicação Access, ponha a acção em Service Auth e inclua esse service token. Com qualquer outra acção, o Access pede um login que o IMAGO não consegue fazer.
- No IMAGO, abra o Avançado ao adicionar o servidor e toque em Token do Cloudflare Access. O botão acrescenta os dois cabeçalhos; preencha o Client ID e o Client Secret como valores.
Os dois cabeçalhos são CF-Access-Client-Id e CF-Access-Client-Secret. O token tem prazo: quando acaba, o servidor responde como se algo à frente pedisse autenticação, e o IMAGO di-lo.
Uma proxy que verifica um cabeçalho
Se a sua proxy só deixa passar um pedido que traga um cabeçalho que escolheu, junte-o em Avançado → Adicionar cabeçalho. O nome e o valor são seus. O IMAGO não aceita os nomes que gere sozinho, como x-api-key, Host ou Cookie.
Seja qual for a proxy, o Immich pede-lhe que reencaminhe todos os cabeçalhos, aceite envios grandes e suporte WebSockets. A página do Immich sobre proxies inversas tem os pormenores.
Um servidor que pede um certificado (mTLS)
Com TLS mútuo, a proxy recusa qualquer aparelho que não apresente um certificado em que confie. O IMAGO aceita o certificado num ficheiro .p12 ou .pfx, com a chave privada lá dentro e uma palavra-passe.
- Crie ou obtenha um certificado de cliente assinado pela autoridade em que a sua proxy confia. Se o gerir com o OpenSSL, isto junta um certificado e a sua chave num ficheiro que o IMAGO lê:
openssl pkcs12 -export -inkey client.key -in client.crt -out client.p12 - Ponha o ficheiro no aparelho, num sítio a que o selector de ficheiros chegue.
- No IMAGO, Avançado → Importar certificado (.p12), escolha o ficheiro e escreva a palavra-passe. O IMAGO mostra para quem é o certificado, quem o emitiu e até quando vale.
A configuração do servidor é sua. No nginx, por exemplo, é um ficheiro da autoridade e ssl_verify_client on. O IMAGO avisa 30 dias antes de o certificado expirar; depois dessa data o servidor recusa o aparelho sem dizer porquê.
Um certificado de uma autoridade sua
Se o servidor usa um certificado emitido por uma autoridade que criou (um laboratório em casa, por exemplo), o aparelho tem de conhecer essa autoridade.
- Android: instale o certificado da autoridade nas definições do sistema (o nome do ecrã muda com o telemóvel; procure «instalar certificado» nas definições e escolha certificado de CA). O IMAGO passa a confiar nele para os seus servidores Immich, e só para eles: os serviços do próprio IMAGO continuam a confiar apenas nas autoridades do sistema.
- Windows: abra o ficheiro do certificado da autoridade, escolha Instalar Certificado e ponha-o em Autoridades de Certificação de Raiz Fidedignas. O IMAGO lê os arquivos de certificados do Windows.
O IMAGO não tem opção para ignorar erros de certificado, de propósito: desligaria a protecção para quem estiver pelo meio.
O que dizem as mensagens
- Alguma coisa à frente do servidor respondeu antes do Immich
- Uma proxy ou serviço de acesso pediu autenticação: uma página de login, um redireccionamento para outro anfitrião, ou uma recusa que não é do Immich. Abra o Avançado e confirme os cabeçalhos. Confirme que o token não expirou e que a política o permite.
- O servidor pede um certificado de cliente
- Importe um em Avançado, ou confirme que o importado é o que a proxy aceita e que não expirou.
- Este aparelho não confia no certificado do servidor
- O certificado é de uma autoridade que o aparelho não conhece, é para outro nome, ou expirou. Instale a autoridade (acima) ou use um certificado público.
- O servidor está inacessível
- Nada respondeu. Confirme o endereço, a rede e se o servidor está a correr. Uma proxy a funcionar com o Immich em baixo também mostra isto.
Se nada disto explicar, contacte o suporte em Definições → Suporte e diagnóstico. O relatório que revê antes de enviar diz que tipo de falha foi, nunca o endereço, a chave nem os cabeçalhos.
Fontes
- Cloudflare: service tokens
- Immich: proxy inversa
- Immich: FAQ, sobre as funcionalidades de rede da app móvel