Ansible Tower / AWX / Segurança do controlador de automação
Reading time: 9 minutes
tip
Aprenda e pratique Hacking AWS:HackTricks Training AWS Red Team Expert (ARTE)
Aprenda e pratique Hacking GCP: HackTricks Training GCP Red Team Expert (GRTE)
Aprenda e pratique Hacking Azure:
HackTricks Training Azure Red Team Expert (AzRTE)
Support HackTricks
- Confira os planos de assinatura!
- Junte-se ao 💬 grupo do Discord ou ao grupo do telegram ou siga-nos no Twitter 🐦 @hacktricks_live.
- Compartilhe truques de hacking enviando PRs para o HackTricks e HackTricks Cloud repositórios do github.
Informações Básicas
Ansible Tower ou sua versão de código aberto AWX também é conhecido como interface do usuário do Ansible, painel e API REST. Com controle de acesso baseado em função, agendamento de tarefas e gerenciamento gráfico de inventário, você pode gerenciar sua infraestrutura Ansible a partir de uma interface moderna. A API REST do Tower e a interface de linha de comando facilitam a integração com ferramentas e fluxos de trabalho atuais.
O Controlador de Automação é uma versão mais nova do Ansible Tower com mais capacidades.
Diferenças
De acordo com este, as principais diferenças entre Ansible Tower e AWX são o suporte recebido e o Ansible Tower possui recursos adicionais, como controle de acesso baseado em função, suporte para APIs personalizadas e fluxos de trabalho definidos pelo usuário.
Stack Tecnológico
- Interface Web: Esta é a interface gráfica onde os usuários podem gerenciar inventários, credenciais, modelos e tarefas. É projetada para ser intuitiva e fornece visualizações para ajudar a entender o estado e os resultados de suas tarefas de automação.
- API REST: Tudo o que você pode fazer na interface web, você também pode fazer via API REST. Isso significa que você pode integrar AWX/Tower com outros sistemas ou scriptar ações que normalmente você realizaria na interface.
- Banco de Dados: AWX/Tower usa um banco de dados (tipicamente PostgreSQL) para armazenar sua configuração, resultados de tarefas e outros dados operacionais necessários.
- RabbitMQ: Este é o sistema de mensagens usado pelo AWX/Tower para se comunicar entre os diferentes componentes, especialmente entre o serviço web e os executores de tarefas.
- Redis: Redis serve como um cache e um backend para a fila de tarefas.
Componentes Lógicos
- Inventários: Um inventário é uma coleção de hosts (ou nós) contra os quais tarefas (playbooks do Ansible) podem ser executadas. AWX/Tower permite que você defina e agrupe seus inventários e também suporta inventários dinâmicos que podem buscar listas de hosts de outros sistemas como AWS, Azure, etc.
- Projetos: Um projeto é essencialmente uma coleção de playbooks do Ansible provenientes de um sistema de controle de versão (como Git) para puxar os playbooks mais recentes quando necessário.
- Modelos: Modelos de tarefas definem como um determinado playbook será executado, especificando o inventário, credenciais e outros parâmetros para a tarefa.
- Credenciais: AWX/Tower fornece uma maneira segura de gerenciar e armazenar segredos, como chaves SSH, senhas e tokens de API. Essas credenciais podem ser associadas a modelos de tarefas para que os playbooks tenham o acesso necessário quando forem executados.
- Motor de Tarefas: É aqui que a mágica acontece. O motor de tarefas é construído sobre o Ansible e é responsável por executar os playbooks. As tarefas são despachadas para o motor de tarefas, que então executa os playbooks do Ansible contra o inventário designado usando as credenciais especificadas.
- Agendadores e Callbacks: Esses são recursos avançados no AWX/Tower que permitem que tarefas sejam agendadas para serem executadas em horários específicos ou acionadas por eventos externos.
- Notificações: AWX/Tower pode enviar notificações com base no sucesso ou falha das tarefas. Ele suporta vários meios de notificações, como e-mails, mensagens do Slack, webhooks, etc.
- Playbooks do Ansible: Playbooks do Ansible são ferramentas de configuração, implantação e orquestração. Eles descrevem o estado desejado dos sistemas de uma maneira automatizada e repetível. Escritos em YAML, os playbooks usam a linguagem de automação declarativa do Ansible para descrever configurações, tarefas e etapas que precisam ser executadas.
Fluxo de Execução de Tarefas
- Interação do Usuário: Um usuário pode interagir com AWX/Tower através da Interface Web ou da API REST. Essas fornecem acesso frontal a todas as funcionalidades oferecidas pelo AWX/Tower.
- Iniciação da Tarefa:
- O usuário, via Interface Web ou API, inicia uma tarefa com base em um Modelo de Tarefa.
- O Modelo de Tarefa inclui referências ao Inventário, Projeto (contendo o playbook) e Credenciais.
- Após a iniciação da tarefa, uma solicitação é enviada ao backend do AWX/Tower para colocar a tarefa na fila para execução.
- Fila de Tarefas:
- RabbitMQ gerencia a comunicação entre o componente web e os executores de tarefas. Uma vez que uma tarefa é iniciada, uma mensagem é despachada para o motor de tarefas usando RabbitMQ.
- Redis atua como o backend para a fila de tarefas, gerenciando tarefas enfileiradas aguardando execução.
- Execução da Tarefa:
- O Motor de Tarefas pega a tarefa enfileirada. Ele recupera as informações necessárias do Banco de Dados sobre o playbook associado à tarefa, inventário e credenciais.
- Usando o playbook do Ansible recuperado do Projeto associado, o Motor de Tarefas executa o playbook contra os nós do Inventário especificado usando as Credenciais fornecidas.
- À medida que o playbook é executado, sua saída de execução (logs, fatos, etc.) é capturada e armazenada no Banco de Dados.
- Resultados da Tarefa:
- Uma vez que o playbook termina de ser executado, os resultados (sucesso, falha, logs) são salvos no Banco de Dados.
- Os usuários podem então visualizar os resultados através da Interface Web ou consultá-los via API REST.
- Com base nos resultados das tarefas, Notificações podem ser despachadas para informar usuários ou sistemas externos sobre o status da tarefa. As notificações podem ser e-mails, mensagens do Slack, webhooks, etc.
- Integração com Sistemas Externos:
- Inventários podem ser dinamicamente obtidos de sistemas externos, permitindo que o AWX/Tower puxe hosts de fontes como AWS, Azure, VMware e mais.
- Projetos (playbooks) podem ser buscados de sistemas de controle de versão, garantindo o uso de playbooks atualizados durante a execução da tarefa.
- Agendadores e Callbacks podem ser usados para integrar com outros sistemas ou ferramentas, fazendo com que o AWX/Tower reaja a gatilhos externos ou execute tarefas em horários predeterminados.
Criação de laboratório AWX para testes
Seguindo a documentação é possível usar docker-compose para executar o AWX:
git clone -b x.y.z https://github.com/ansible/awx.git # Get in x.y.z the latest release version
cd awx
# Build
make docker-compose-build
# Run
make docker-compose
# Or to create a more complex env
MAIN_NODE_TYPE=control EXECUTION_NODE_COUNT=2 COMPOSE_TAG=devel make docker-compose
# Clean and build the UI
docker exec tools_awx_1 make clean-ui ui-devel
# Once migrations are completed and the UI is built, you can begin using AWX. The UI can be reached in your browser at https://localhost:8043/#/home, and the API can be found at https://localhost:8043/api/v2.
# Create an admin user
docker exec -ti tools_awx_1 awx-manage createsuperuser
# Load demo data
docker exec tools_awx_1 awx-manage create_preload_data
RBAC
Funções suportadas
A função mais privilegiada é chamada de Administrador do Sistema. Qualquer pessoa com essa função pode modificar qualquer coisa.
De uma revisão de segurança de caixa branca, você precisaria da função Auditor do Sistema, que permite visualizar todos os dados do sistema, mas não pode fazer nenhuma alteração. Outra opção seria obter a função Auditor da Organização, mas seria melhor obter a outra.
Expanda isso para obter uma descrição detalhada das funções disponíveis
- Administrador do Sistema:
- Esta é a função de superusuário com permissões para acessar e modificar qualquer recurso no sistema.
- Eles podem gerenciar todas as organizações, equipes, projetos, inventários, modelos de trabalho, etc.
- Auditor do Sistema:
- Usuários com essa função podem visualizar todos os dados do sistema, mas não podem fazer alterações.
- Esta função é projetada para conformidade e supervisão.
- Funções da Organização:
- Admin: Controle total sobre os recursos da organização.
- Auditor: Acesso somente para visualização aos recursos da organização.
- Membro: Membro básico em uma organização sem permissões específicas.
- Executar: Pode executar modelos de trabalho dentro da organização.
- Ler: Pode visualizar os recursos da organização.
- Funções do Projeto:
- Admin: Pode gerenciar e modificar o projeto.
- Usar: Pode usar o projeto em um modelo de trabalho.
- Atualizar: Pode atualizar o projeto usando SCM (controle de versão).
- Funções do Inventário:
- Admin: Pode gerenciar e modificar o inventário.
- Ad Hoc: Pode executar comandos ad hoc no inventário.
- Atualizar: Pode atualizar a fonte do inventário.
- Usar: Pode usar o inventário em um modelo de trabalho.
- Ler: Acesso somente para visualização.
- Funções do Modelo de Trabalho:
- Admin: Pode gerenciar e modificar o modelo de trabalho.
- Executar: Pode executar o trabalho.
- Ler: Acesso somente para visualização.
- Funções de Credenciais:
- Admin: Pode gerenciar e modificar as credenciais.
- Usar: Pode usar as credenciais em modelos de trabalho ou outros recursos relevantes.
- Ler: Acesso somente para visualização.
- Funções da Equipe:
- Membro: Parte da equipe, mas sem permissões específicas.
- Admin: Pode gerenciar os membros da equipe e os recursos associados.
- Funções do Fluxo de Trabalho:
- Admin: Pode gerenciar e modificar o fluxo de trabalho.
- Executar: Pode executar o fluxo de trabalho.
- Ler: Acesso somente para visualização.
tip
Aprenda e pratique Hacking AWS:HackTricks Training AWS Red Team Expert (ARTE)
Aprenda e pratique Hacking GCP: HackTricks Training GCP Red Team Expert (GRTE)
Aprenda e pratique Hacking Azure:
HackTricks Training Azure Red Team Expert (AzRTE)
Support HackTricks
- Confira os planos de assinatura!
- Junte-se ao 💬 grupo do Discord ou ao grupo do telegram ou siga-nos no Twitter 🐦 @hacktricks_live.
- Compartilhe truques de hacking enviando PRs para o HackTricks e HackTricks Cloud repositórios do github.