Como conectar o Authentik ao Immich usando SSO

Última atualização: 31/08/2026

  • Configurando um provedor OpenID no Authentik para gerar credenciais de cliente.
  • Vinculação da aplicação no Immich utilizando o URL do emissor e os segredos de autenticação.
  • Ajustar URIs de redirecionamento específicos para garantir o funcionamento correto do aplicativo móvel.
  • Implementação de registro automático e inicialização automática para automatizar o acesso do usuário.

Como conectar o Authentik com o Immich

Como faço para conectar o Authentik ao Immich? Se você estiver configurando seu próprio servidor de fotos em casa, provavelmente já sabe disso. Immich é uma verdadeira joia.Mas gerenciar usuários individualmente pode ser uma dor de cabeça. Para evitar ter que digitar a senha mil vezes ou criar contas manualmente para toda a família, a solução mais inteligente é configurar um sistema de... Autenticação única (SSO)E é aí que a Authentik entra em cena.

A ideia é simples: o Authentik atua como o guardião do seu servidor, validando sua identidade para que você possa então Entrando em Immich sem complicaçõesEmbora configurar o OIDC (OpenID Connect) possa parecer um mundo de complicações técnicas, uma vez que você entenda como os dois aplicativos se comunicam, torna-se muito fácil e facilita bastante a implantação. Acabamento profissional e muito mais seguro.

Proteja a interface web aberta com uma senha.
Artigo relacionado:
Como proteger a interface web do Open com senha e limitar o registro de usuários

Preparando o terreno em Authentik

Antes de mexer em qualquer coisa no Immich, precisamos informar à Authentik que existe um aplicativo de fotos que ela deseja permitir que seus usuários utilizem. Para isso, o primeiro passo é acessar a interface de administração e criar um provedor do tipo OpenIDAo configurar este provedor, você verá que o sistema gera automaticamente um ID do cliente e segredo do clienteAnote esses dados em um bloco de notas, pois essas são as chaves mestras que colaremos posteriormente na configuração do Immich.

Conteúdo exclusivo - Clique aqui  Quão seguro é o servidor de monitoramento de rede Little Snitch?

Um detalhe importante é o fluxo de autorização: se você não quiser que seus usuários precisem aceitar permissões sempre que fizerem login, você pode selecionar a opção fluxo implícito Para agilizar o processo. Em relação aos URIs de redirecionamento, não exagere e use exatamente os especificados na documentação da Immich, pois se um único caractere estiver errado, o sistema exibirá um erro e impedirá o login. Se você estiver usando versões muito antigas do Authentik (anteriores à 2026.5), lembre-se de que Todos os URIs são tratados como tipo de autorização.Portanto, não complique as coisas configurando URIs de logout.

Assim que tiver o fornecedor definido, o próximo passo é criar o O próprio aplicativo No painel Authentik, basta dar um nome (como "Minhas Fotos" ou "Immich") e vinculá-lo ao provedor que você acabou de criar. Por fim, volte aos detalhes do provedor e copie o código. URL do emissor (Emissor de configuração OpenID), que é o endereço que Immich usará para descobrir como se autenticar.

Configuração detalhada em Immich

Visualização de uma galeria de fotos digital em um smartphone, resultado final da instalação de Immich.

Agora vamos para o site da Immich. Você precisa acessar a seção sobre Administração e, em seguida, Configurações Procure pela seção Autenticação OAuth. Ative a caixa de seleção e você verá um formulário que parece intimidante, mas na verdade é muito simples. É aqui que você cola o URL do emissor, ID do cliente e segredo do cliente que você salvou anteriormente.

Conteúdo exclusivo - Clique aqui  O antivírus Comodo é melhor que outros?

Para uma experiência tranquila, recomendo ativar o Registro automáticoque cria automaticamente a conta Immich do usuário na primeira vez que ele faz login via Authentik, e o Inicialização automáticaque redireciona o usuário diretamente para o login do Authentik sem passar pela tela inicial do Immich. Observação: se você ativar a Inicialização Automática, Você pode ficar de fora. da sua conta de administrador local. Para fazer login com a conta de administrador original, você precisará usar o URL especial adicionando ?autoLaunch=0 ao final do endereço de login.

O enigma dos URIs e do acesso móvel

Detalhe dos cabos de rede conectados a um switch, representando a configuração de URIs e a conectividade entre contêineres.

É aqui que muitas pessoas cometem erros. O Immich precisa de vários URIs de redirecionamento, dependendo de onde você está acessando. Para a web, você precisará adicionar /auth/login e /user-settings juntamente com o seu domínio. Mas o mais importante é o aplicativo móvel: você deve incluir o URI. app.immich:///oauth-callbackSe o seu servidor de autenticação não aceitar esse esquema personalizado, a solução é configurar um endpoint HTTP que atue como uma ponte e redirecione o tráfego para esse endereço, especificando-o posteriormente no arquivo de configuração. Opção de substituição do URI de redirecionamento para dispositivos móveis Por Immich.

Se você encontrar um erro 500 ou problemas de rede, especialmente em ambientes Docker ou Unraid, o problema pode ser que os contêineres não conseguem se comunicar usando seus nomes de domínio público. Alguns usuários resolveram isso usando IPs locais em vez de domínios ou ajustando a rede do host para que o tráfego flua corretamente entre o proxy reverso e os serviços de autenticação.

Conteúdo exclusivo - Clique aqui  É seguro usar o CCleaner Portable?

Gerenciamento de usuários e permissões

Administrador de sistemas analisando a infraestrutura de servidores em um centro de dados moderno.

Para testar se tudo está funcionando, não use a conta de administrador do Authentik. Acesse o diretório de usuários, Criar novo usuário com sua própria senha e tente fazer login no Immich com essa conta. Se tudo estiver correto, você será redirecionado para o Authentik, insira seus dados e pronto!, você estará na sua galeria de fotos. Lembre-se de que você pode explorar as opções disponíveis. reivindicações de armazenamento Na configuração do Immich, é possível atribuir quotas de disco específicas a cada usuário com base nas informações que o Authentik envia no token.

A integração dessas duas ferramentas permite centralizar a segurança e evitar a sobrecarga de senhas, delegando a validação de identidade a um sistema robusto. Ao configurar corretamente os fluxos OIDC e as rotas de redirecionamento, tanto na web quanto no aplicativo móvel, você cria um ecossistema onde o acesso é transparente para o usuário final, mas estritamente controlado pelo administrador, otimizando o gerenciamento de identidade em seu ambiente de laboratório.

Cristian Garcia

Cristian Garcia

Apaixonado por tecnologia desde pequeno. Adoro estar atualizado no setor e, acima de tudo, comunicá-lo. É por isso que há muitos anos me dedico à comunicação em sites de tecnologia e videogames. Você pode me encontrar escrevendo sobre Android, Windows, MacOS, iOS, Nintendo ou qualquer outro tópico relacionado que lhe vier à mente.