الميزات • التثبيت • الاستخدام • الإعدادات • تشغيل cloudlist • مزودو الخدمة المدعومون • المكتبة • انضم إلى Discord

Cloudlist هي أداة متعددة السحابات للحصول على الأصول (Assets) من مزودي الخدمات السحابية. وهي مخصصة للاستخدام من قبل الفريق الأزرق (blue team) لتعزيز جهود إدارة سطح الهجوم (Attack Surface Management) من خلال الحفاظ على قائمة مركزية للأصول عبر سحابات متعددة بأقل جهد ممكن في الإعدادات.

الميزات

• سرد الأصول السحابية بإعدادات متعددة
• دعم مزودي خدمات سحابية متعددين
• دعم المصادقة بدون مفاتيح (AWS IRSA / instance profiles، GCP workload identity)
• دعم صيغ إخراج متعددة
• دعم مرشحات متعددة
• قابلية عالية للتوسيع مما يجعل إضافة مزودين جدد أمراً سهلاً
• دعم stdout للعمل مع أدوات أخرى في خطوط الأنابيب (pipelines)

الاستخدام

cloudlist -h

سيعرض هذا الأمر المساعدة الخاصة بالأداة. فيما يلي جميع الخيارات (switches) التي تدعمها.

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:

• Organization-Level Asset API - اكتشاف شامل على مستوى المؤسسة باستخدام Cloud Asset Inventory API
• Individual Service APIs - اكتشاف سريع خاص بالمشروع باستخدام واجهات برمجة تطبيقات خدمات GCP الفردية

للحصول على تعليمات الإعداد التفصيلية، والأذونات المطلوبة، وإعداد حساب الخدمة (service account)، وأمثلة الاستخدام، راجع:

📚 docs/GCP_ASSET_API.md

المساهمة

يرجى مراجعة PROVIDERS.md و DESIGN.md لتضمين دعم مزودي خدمات سحابية جدد في Cloudlist.

• قم بعمل Fork لهذا المشروع
• أنشئ فرع الميزة الخاصة بك (git checkout -b new-provider)
• قم بعمل Commit لتغييراتك (git commit -am 'Added new cloud provider')
• ادفع التغييرات إلى الفرع (git push origin new-provider)
• أنشئ Pull Request جديد

شكر وتقدير

شكراً على الإلهام

• Smogcloud
• Cloudmapper

الترخيص

cloudlist صُنع بـ 🖤 بواسطة فريق projectdiscovery ومرخّص بموجب MIT