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:

O que se guarda, e para onde vai

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.

  1. No painel da Cloudflare, vá a Zero Trust → Access controls → Service credentials → Service Tokens e escolha Create Service Token.
  2. Dê-lhe um nome e uma duração e escolha Generate token. Copie já o Client Secret: a Cloudflare só o mostra uma vez.
  3. 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.
  4. 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.

  1. 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
  2. Ponha o ficheiro no aparelho, num sítio a que o selector de ficheiros chegue.
  3. 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.

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