Português - Ht Cloud
HackTricks TrainingTwitterLinkedinSponsor

Ansible Tower / AWX / Automation controller Security

Support HackTricks

Basic Information

Ansible Tower ou sua versão de código aberto AWX também é conhecido como interface de usuário, painel e API REST do Ansible. 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.

Automation Controller é uma versão mais nova do Ansible Tower com mais capacidades.

Differences

De acordo com isso, 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.

Tech Stack

  • Web Interface: 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.

  • REST API: Tudo o que você pode fazer na interface da 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.

  • Database: 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.

Logical Components

  • Inventories: 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.

  • Projects: 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.

  • Templates: Modelos de tarefas definem como um determinado playbook será executado, especificando o inventário, credenciais e outros parâmetros para a tarefa.

  • Credentials: 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.

  • Task Engine: É aqui que a mágica acontece. O mecanismo de tarefas é construído sobre o Ansible e é responsável por executar os playbooks. As tarefas são despachadas para o mecanismo de tarefas, que então executa os playbooks do Ansible contra o inventário designado usando as credenciais especificadas.

  • Schedulers and 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.

  • Notifications: 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.

  • Ansible Playbooks: 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.

Job Execution Flow

  1. User Interaction: Um usuário pode interagir com AWX/Tower através da Web Interface ou da REST API. Essas fornecem acesso frontal a todas as funcionalidades oferecidas pelo AWX/Tower.

  2. Job Initiation:

  • O usuário, através da Web Interface 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.

  1. Job Queuing:

  • 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 mecanismo de tarefas usando RabbitMQ.

  • Redis atua como o backend para a fila de tarefas, gerenciando tarefas enfileiradas aguardando execução.

  1. Job Execution:

  • O Task Engine 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 Task Engine 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.

  1. Job Results:

  • 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 Web Interface ou consultá-los via API REST.

  • Com base nos resultados das tarefas, Notificações podem ser enviadas para informar os usuários ou sistemas externos sobre o status da tarefa. As notificações podem ser e-mails, mensagens do Slack, webhooks, etc.

  1. External Systems Integration:

  • Inventories podem ser dinamicamente obtidos de sistemas externos, permitindo que o AWX/Tower puxe hosts de fontes como AWS, Azure, VMware e mais.

  • Projects (playbooks) podem ser buscados de sistemas de controle de versão, garantindo o uso de playbooks atualizados durante a execução da tarefa.

  • Schedulers and 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.

AWX lab creation for testing

Seguindo a documentação é possível usar docker-compose para executar 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 de Auditor do Sistema, que permite visualizar todos os dados do sistema, mas não pode fazer alterações. Outra opção seria obter a função de Auditor da Organização, mas seria melhor obter a outra.

Expanda isso para obter uma descrição detalhada das funções disponíveis

  1. 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.

  1. 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.

  1. 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.

  1. 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).

  1. 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.

  1. 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.

  1. 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.

  1. 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.

  1. 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.

Support HackTricks
PreviousSupabase SecurityNextTODO

Last updated