Возможности • Установка • Использование • Конфигурация • Запуск cloudlist • Поддерживаемые провайдеры • Библиотека • Присоединиться к Discord

Cloudlist — это мультиоблачный инструмент для получения ресурсов (Assets) от облачных провайдеров. Он предназначен для использования blue team с целью усиления управления поверхностью атаки (Attack Surface Management) путём ведения централизованного списка ресурсов в нескольких облаках при минимальных усилиях по настройке.

Возможности

• Перечисление облачных ресурсов с множеством конфигураций
• Поддержка множества облачных провайдеров
• Поддержка аутентификации без ключей (AWS IRSA / instance profiles, GCP workload identity)
• Поддержка множества форматов вывода
• Поддержка множества фильтров
• Высокая расширяемость, благодаря которой добавление новых провайдеров становится простым
• Поддержка stdout для работы с другими инструментами в конвейерах

Использование

cloudlist -h

Это отобразит справку по инструменту. Ниже перечислены все поддерживаемые флаги.

Cloudlist is a tool for listing Assets from multiple cloud providers.

Usage:
  ./cloudlist [flags]

Flags:
CONFIGURATION:
   -config string                cloudlist flag config file (default "$HOME/.config/cloudlist/config.yaml")
   -pc, -provider-config string  provider config file (default "$HOME/.config/cloudlist/provider-config.yaml")
   -ad, -auto-discovery          discover providers from environment credentials (aws, gcp, azure, kubernetes) instead of the provider config

FILTERS:
   -p, -provider value          display results for given providers (comma-separated) (default linode,fastly,heroku,terraform,digitalocean,consul,cloudflare,hetzner,nomad,do,scw,openstack,alibaba,aws,gcp,namecheap,kubernetes,azure, custom)
   -id string[]                 display results for given ids (comma-separated)
   -host                        display only hostnames in results
   -ip                          display only ips in results
   -s, -service value           query and display results from given service (comma-separated) (default cloudfront,gke,domain,compute,ec2,instance,cloud-function,app,eks,custom,consul,droplet,vm,ecs,fastly,alb,s3,lambda,elb,cloud-run,route53,publicip,dns,service,nomad,lightsail,ingress,apigateway)
   -es, -exclude-service value  services to skip for a provider (comma-separated)
   -ep, -exclude-private        exclude private ips in cli output

UPDATE:
   -up, -update                 update cloudlist to latest version
   -duc, -disable-update-check  disable automatic cloudlist update check

OUTPUT:
   -o, -output string  output file to write results
   -json               write output in json format
   -version            display version of cloudlist
   -v                  display verbose output
   -silent             display only results in output

Документация

Поддержка GCP Asset API

Cloudlist поддерживает два подхода к обнаружению ресурсов GCP:

• Asset API на уровне организации — комплексное обнаружение в масштабе всей организации с использованием Cloud Asset Inventory API
• API отдельных сервисов — быстрое обнаружение в рамках конкретного проекта с использованием API отдельных сервисов GCP

Подробные инструкции по настройке, необходимые разрешения, конфигурацию сервисного аккаунта и примеры использования см. в:

📚 docs/GCP_ASSET_API.md

Вклад в проект

Пожалуйста, ознакомьтесь с PROVIDERS.md и DESIGN.md, чтобы добавить поддержку новых облачных провайдеров в Cloudlist.

• Форкните этот проект
• Создайте ветку для своей функции (git checkout -b new-provider)
• Зафиксируйте свои изменения (git commit -am 'Added new cloud provider')
• Отправьте изменения в ветку (git push origin new-provider)
• Создайте новый Pull Request

Благодарности

Спасибо за вдохновение

• Smogcloud
• Cloudmapper

Лицензия

cloudlist создан с 🖤 командой projectdiscovery и лицензирован под MIT