DEV Community

Alef Ojeda de Oliveira
Alef Ojeda de Oliveira

Posted on

2

Instalando Keycloak usando Docker

Instalando o Keycloak Usando Docker

Introdução

Keycloak é uma ferramenta de gerenciamento de identidade e acesso que permite a autenticação e autorização de usuários em aplicações modernas. Ele é uma solução open-source que facilita o controle de segurança em diversos sistemas. Neste guia, vamos aprender a instalar o Keycloak utilizando Docker, de forma rápida e prática.

Pré-requisitos

Antes de começarmos, você precisa garantir que seu ambiente esteja preparado. Você precisará dos seguintes itens:

  1. Docker: Certifique-se de ter o Docker instalado em sua máquina. Você pode verificar se ele está instalado executando o comando docker --version. Caso não tenha, siga as instruções de instalação para o seu sistema operacional aqui.

Passo 1: Baixar a Imagem do Keycloak

Para instalar o Keycloak usando Docker, primeiro baixe a imagem oficial do Keycloak. Execute o seguinte comando no terminal:

docker pull quay.io/keycloak/keycloak:latest
Enter fullscreen mode Exit fullscreen mode

Este comando irá baixar a versão mais recente da imagem do Keycloak do repositório oficial.

Passo 2: Iniciar o Container do Keycloak

Depois de baixar a imagem, você pode iniciar o Keycloak com o seguinte comando:

docker run -p 8080:8080 -e KEYCLOAK_ADMIN=admin -e KEYCLOAK_ADMIN_PASSWORD=admin quay.io/keycloak/keycloak:latest start-dev
Enter fullscreen mode Exit fullscreen mode

Este comando possui as seguintes opções:

  • -p 8080:8080: Mapeia a porta 8080 do container para a porta 8080 do host, permitindo o acesso ao Keycloak pelo navegador.
  • -e KEYCLOAK_ADMIN=admin e -e KEYCLOAK_ADMIN_PASSWORD=admin: Define o usuário administrador (admin) e a senha (admin).
  • start-dev: Inicia o Keycloak no modo de desenvolvimento, que é mais adequado para testes e configurações iniciais.

Passo 3: Acessar o Keycloak

Depois de iniciar o container, você pode acessar o Keycloak pelo navegador. Basta ir para http://localhost:8080.

  • Use o nome de usuário admin e a senha admin (ou a senha que você definiu) para fazer login no painel administrativo do Keycloak.

Passo 4: Configuração Básica

Assim que estiver logado, você pode criar novos Realms (ambientes de autenticação isolados, que contêm configurações, usuários e permissões), Clients (aplicações que usam Keycloak para autenticação, como aplicativos web ou serviços backend) e configurar Usuários (indivíduos que serão autenticados no sistema).

Se precisar fazer ajustes mais avançados, recomendo explorar a documentação oficial do Keycloak: https://www.keycloak.org/documentation.

Passo 5: Como Criar um Realm

  1. No painel administrativo do Keycloak, clique em Realms no menu à esquerda.
  2. Clique em Add Realm.
  3. Insira um nome para o novo Realm e clique em Create.

Um Realm permite que você isole a configuração de autenticação, usuários e permissões, facilitando a administração de diferentes ambientes ou aplicações.

Passo 6: Como Criar um Client

  1. Dentro do Realm que você criou, clique em Clients no menu à esquerda.
  2. Clique em Create para adicionar um novo Client.
  3. Insira um identificador para o Client (como o nome da aplicação) e clique em Save.
  4. Configure o Client Protocol e outras configurações relevantes, como Access Type (confira se deseja confidential ou public, dependendo do tipo de aplicação).

O Client representa uma aplicação que utilizará Keycloak para autenticação, como uma aplicação web ou um serviço backend.

Passo 7: Como Criar um Usuário

  1. No painel administrativo, clique em Users no menu à esquerda.
  2. Clique em Add User para criar um novo usuário.
  3. Preencha os campos obrigatórios, como Username, e clique em Save.
  4. Depois de salvar, vá até a aba Credentials para definir uma senha para o usuário. Insira a senha desejada e clique em Set Password.

Com usuários criados, você poderá realizar testes de autenticação e configurar permissões específicas para cada um.

Comandos Úteis

  • Para parar o container:
  docker stop <container_id>
Enter fullscreen mode Exit fullscreen mode

Substitua <container_id> pelo ID do container que você deseja parar. Você pode obter o ID do container usando o comando docker ps.

  • Para ver os logs:
  docker logs -f <container_id>
Enter fullscreen mode Exit fullscreen mode

Substitua <container_id> pelo ID do container para visualizar os logs em tempo real.

Considerações Finais

Utilizando o Docker, o Keycloak pode ser instalado de maneira muito rápida e prática. Como próximos passos, considere explorar integrações com outras ferramentas, como um servidor LDAP ou uma aplicação backend. Além disso, para ambientes de produção, é altamente recomendável configurar medidas de segurança adicionais, como o uso de certificados SSL e ajustes nas permissões de acesso. Com isso, você tem uma infraestrutura poderosa de autenticação pronta para ser integrada a seus projetos.

Lembre-se de sempre manter o Keycloak e os componentes associados atualizados, garantindo assim maior segurança e estabilidade no seu sistema.

Image of Datadog

Master Mobile Monitoring for iOS Apps

Monitor your app’s health with real-time insights into crash-free rates, start times, and more. Optimize performance and prevent user churn by addressing critical issues like app hangs, and ANRs. Learn how to keep your iOS app running smoothly across all devices by downloading this eBook.

Get The eBook

Top comments (0)

Cloudinary image

Zoom pan, gen fill, restore, overlay, upscale, crop, resize...

Chain advanced transformations through a set of image and video APIs while optimizing assets by 90%.

Explore