Outpost

Gestão de Testes e Relatórios AWS

Outpost é uma ferramenta simples para gerar ficheiros de configuração AWS para AssumeRole, uma capacidade de teste para verificar o funcionamento de contas e um gerador de relatórios para resultados do ScoutSuite.

Executar o ScoutSuite
Analisar os resultados
✨Gerar Descobertas de Relatório✨

Instalação

O Outpost requer Python3 e boto3 para funcionar.

Instale as dependências.

virtualenv -p python3 .
source bin/activate
pip install -r requirements.txt
python outpost.py --help

Utilização

usage: outpost.py [-h] --command COMMAND [--config-creds] [--assume ASSUME] [--accounts ACCOUNTS] [--primary PRIMARY] [--token TOKEN]
                  [--secret-key SECRET_KEY] [--access-key ACCESS_KEY] [--directory DIRECTORY] [--risk RISK] [--project PROJECT]

optional arguments:
  -h, --help            show this help message and exit
  --command COMMAND     Commands: generate, report, testaccounts
  --config-creds        Configure creds while using the generate command
  --assume ASSUME       Optional assume role ARN, use ACCOUNT_ID for placeholder. (i.e. arn:aws:iam::ACCOUNT_ID:role/ROLENAME
  --accounts ACCOUNTS   File containing account numbers (one account per line)
  --primary PRIMARY     Primary account used to assume roles
  --token TOKEN         Primary AWS session token
  --secret-key SECRET_KEY
                        Primary AWS secret access key
  --access-key ACCESS_KEY
                        Primary AWS access key
  --directory DIRECTORY
                        Parent directory of ScoutSuite report(s)
  --risk RISK           Select finding risk to report: danger, warning
  --project PROJECT     Project name for report details

Exemplo de Utilização

O Outpost percorrerá recursivamente todas as pastas de relatórios em busca dos ficheiros scoutsuite_results*.js para análise. Isto significa que, se a pasta raiz dos relatórios contiver relatórios separados do ScoutSuite, deve fornecer a pasta raiz como a flag --directory. Um exemplo de estrutura poderia ser: ~/Engagements/CustomerName/reports/account1/ ~/Engagements/CustomerName/reports/account2/ ~/Engagements/CustomerName/reports/account3/ Forneceria o seguinte comando para analisar todos os 3 relatórios de conta:

python outpost.py --command report --directory ~/Engagements/CustomerName/reports/ --project Customer_2022-123

Resultados

A ferramenta cria uma pasta chamada data_archive dentro da pasta raiz dos resultados do ScoutSuite. Irá gerar um ficheiro chamado <project name>.txt com as descobertas que poderá copiar/colar diretamente no relatório. Adicionalmente, serão criados ficheiros suplementares para cada descoberta dentro da pasta, que descrevem a conta e os recursos específicos que são vulneráveis.

outpost