{"id":13292308,"url":"https://github.com/bassammaged/awsEnum","last_synced_at":"2025-03-10T07:33:02.412Z","repository":{"id":40385089,"uuid":"489677052","full_name":"bassammaged/awsEnum","owner":"bassammaged","description":"Enumerate AWS cloud resources based on provided credential","archived":false,"fork":false,"pushed_at":"2022-05-11T15:04:35.000Z","size":142,"stargazers_count":48,"open_issues_count":0,"forks_count":7,"subscribers_count":4,"default_branch":"master","last_synced_at":"2023-03-04T22:58:29.815Z","etag":null,"topics":["aws","bug","bugbounty","enumeration","penetration-testing","security-audit","security-tools"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bassammaged.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-05-07T13:11:31.000Z","updated_at":"2023-02-22T14:44:28.000Z","dependencies_parsed_at":"2022-07-07T03:33:41.930Z","dependency_job_id":null,"html_url":"https://github.com/bassammaged/awsEnum","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bassammaged%2FawsEnum","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bassammaged%2FawsEnum/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bassammaged%2FawsEnum/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bassammaged%2FawsEnum/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bassammaged","download_url":"https://codeload.github.com/bassammaged/awsEnum/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242811955,"owners_count":20189165,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","bug","bugbounty","enumeration","penetration-testing","security-audit","security-tools"],"created_at":"2024-07-29T17:07:40.808Z","updated_at":"2025-03-10T07:33:02.008Z","avatar_url":"https://github.com/bassammaged.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eawsEnum\u003c/h1\u003e\n\u003cp align=\"center\"\u003eEnumrate AWS services! with no nosies \u003c/p\u003e\n\u003cp align=\"center\"\u003eawsEnum is a python script enumrate AWS services through the provided credential.\u003c/p\u003e  \n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003ch2 id=\"table-of-contents\"\u003e :book: Table of Contents\u003c/h2\u003e\n\n\u003cdetails open=\"open\"\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\u003ca href=\"#screen\"\u003eScreenshot\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#Disclaimerl\"\u003eDisclaimer\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#Features\"\u003eFeatures\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#how-to-install\"\u003eHow to Install\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#results-and-discussion\"\u003eResults and FQAs\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#to-do\"\u003eTo-Do\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\n\u003ch2 id=\"screen\"\u003e :clapper: Screenshot\u003c/h2\u003e\n\u003cp align=\"center\"\u003e \n  \u003cimg src=\"assets/img/screenshot.png\"\u003e\n\u003c/p\u003e\n\n```sh\n     ▄▄▄▄▄▄ ▄     ▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄ ▄▄    ▄ ▄▄   ▄▄ ▄▄   ▄▄ \n█      █ █ ▄ █ █       █       █  █  █ █  █ █  █  █▄█  █\n█  ▄   █ ██ ██ █  ▄▄▄▄▄█    ▄▄▄█   █▄█ █  █ █  █       █\n█ █▄█  █       █ █▄▄▄▄▄█   █▄▄▄█       █  █▄█  █       █\n█      █       █▄▄▄▄▄  █    ▄▄▄█  ▄    █       █       █\n█  ▄   █   ▄   █▄▄▄▄▄█ █   █▄▄▄█ █ █   █       █ ██▄██ █\n█▄█ █▄▄█▄▄█ █▄▄█▄▄▄▄▄▄▄█▄▄▄▄▄▄▄█▄█  █▄▄█▄▄▄▄▄▄▄█▄█   █▄█\n--------------------------------------------------------\nIf you are looking to enumerate AWS services. So, welcome\nto awsEnum, awsEnum is a python script trying to facilitate \nthe enumerate phase of AWS cloud with the lowest possible\nheadache and less noise. Therefore we are not supporting \nthe `all` mode. ----------------------------------------\n--------------------------------------------------------\n        developed by bassammaged (@kemet)\n                version: 0.1 Beta\n--------------------------------------------------------\n[!] Make sure you already defined credential profile via AWS CLI.\n\nusage: run.py [-h] [-p profile_name] [-r region_name] [-v | --verbose | --no-verbose] [-t TRIES] aws_service_name\n\npositional arguments:\n  aws_service_name      Specify the aws service for enumration. Supported services are: ['ec2', 'iam', 's3'] (default: all)\n\noptions:\n  -h, --help            show this help message and exit\n  -p profile_name, --profile profile_name\n                        specify aws credential profile that will be used through the enumeration. (default: default)\n  -r region_name, --region region_name\n                        specify aws region. (default: eu-central-1)\n  -v, --verbose, --no-verbose\n                        Allows the script to print out the message level start with debug. (default: False)\n  -t TRIES, --tries TRIES\n                        set maximum tries. (default: 1000)\n\n```\n\n\u003ch2 id=\"Disclaimer\"\u003e :pencil: Disclaimer\u003c/h2\u003e\n\n`awsEnum` is in beta version and is supposed to be free of issues but if any issues encountered, please submit the ticket,`awsEnum` is coded and published to be used in partical circumstances:\n\n1. Engaging in penetration testing activity.\n2. Carry on Bug hunting activity.\n3. AWS cloud security Audit.\n4. Any other legal activity that already approved by the owner of the asset.\n\n`awsEnum` is craeted to work under hoodie, which means there's no intention to support `all` mode.\n \n\u003ch2 id=\"Features\"\u003e :fuelpump: Features\u003c/h2\u003e\n\n- [x] Connect to aws service through `boto3`, on other word! signing request.\n- [x] `awsEnum` allows user to set the number of requests [By default: 1000].\n- [x] `awsEnum` store result into `json` file.\n- [x] Keep AWS credential within `awscli` confugration and just pass profile_name to `awsEnum`.\n- [x] Supported service: `ec2`, `iam`, `s3`.  \n\n\u003ch2 id=\"prerequisites\"\u003e :cd: Prerequisites\u003c/h2\u003e\n\n1. Python3\n2. `pip` package manager\n3. `python3 -m pip install requirements.txt`\n4. Feel Free to use `awsEnum` via `run.py` script\n\n\u003ch2 id=\"results-and-discussion\"\u003e :paperclip: Results and FQAs\u003c/h2\u003e\n\n```json\n[\n    {\n        \"AmiLaunchIndex\": 0,\n        \"ImageId\": \"ami-7c803d1c\",\n        \"InstanceId\": \"i-05bef8a081f307783\",\n        \"InstanceType\": \"t2.micro\",\n        \"KeyName\": \"Default\",\n        \"LaunchTime\": \"2017-02-12 22:29:24+00:00\",\n        \"Monitoring\": {\n            \"State\": \"disabled\"\n        },\n        \"Placement\": {\n            \"AvailabilityZone\": \"us-west-2a\",\n            \"GroupName\": \"\",\n            \"Tenancy\": \"default\"\n        },\n        \"PrivateDnsName\": \"ip-172-31-41-84.us-west-2.compute.internal\",\n        \"PrivateIpAddress\": \"172.31.41.84\",\n        \"ProductCodes\": [],\n        \"PublicDnsName\": \"ec2-35-165-182-7.us-west-2.compute.amazonaws.com\",\n        \"PublicIpAddress\": \"35.165.182.7\",\n        \"State\": {\n            \"Code\": 16,\n            \"Name\": \"running\"\n        },\n        \"StateTransitionReason\": \"\",\n        \"SubnetId\": \"subnet-d962aa90\",\n        \"VpcId\": \"vpc-1052ce77\",\n        \"Architecture\": \"x86_64\",\n        \"BlockDeviceMappings\": [\n            {\n                \"DeviceName\": \"/dev/sda1\",\n                \"Ebs\": {\n                    \"AttachTime\": \"2017-02-12 22:29:25+00:00\",\n                    \"DeleteOnTermination\": true,\n                    \"Status\": \"attached\",\n                    \"VolumeId\": \"vol-04f1c039bc13ea950\"\n                }\n            }\n        ],\n        \"ClientToken\": \"kTOiC1486938563883\",\n        \"EbsOptimized\": false,\n        \"Hypervisor\": \"xen\",\n        \"IamInstanceProfile\": {\n            \"Arn\": \"arn:aws:iam::975426262029:instance-profile/flaws\",\n            \"Id\": \"AIPAIK7LV6U6UXJXQQR3Q\"\n        },\n        \"NetworkInterfaces\": [\n            {\n                \"Association\": {\n                    \"IpOwnerId\": \"amazon\",\n                    \"PublicDnsName\": \"ec2-35-165-182-7.us-west-2.compute.amazonaws.com\",\n                    \"PublicIp\": \"35.165.182.7\"\n                },\n                \"Attachment\": {\n                    \"AttachTime\": \"2017-02-12 22:29:24+00:00\",\n                    \"AttachmentId\": \"eni-attach-a4901fc2\",\n                    \"DeleteOnTermination\": true,\n                    \"DeviceIndex\": 0,\n                    \"Status\": \"attached\",\n                    \"NetworkCardIndex\": 0\n                },\n                \"Description\": \"\",\n                \"Groups\": [\n                    {\n                        \"GroupName\": \"launch-wizard-1\",\n                        \"GroupId\": \"sg-490f6631\"\n                    }\n                ],\n                \"Ipv6Addresses\": [],\n                \"MacAddress\": \"06:b0:7a:92:21:cf\",\n                \"NetworkInterfaceId\": \"eni-c26ed780\",\n                \"OwnerId\": \"975426262029\",\n                \"PrivateDnsName\": \"ip-172-31-41-84.us-west-2.compute.internal\",\n                \"PrivateIpAddress\": \"172.31.41.84\",\n                \"PrivateIpAddresses\": [\n                    {\n                        \"Association\": {\n                            \"IpOwnerId\": \"amazon\",\n                            \"PublicDnsName\": \"ec2-35-165-182-7.us-west-2.compute.amazonaws.com\",\n                            \"PublicIp\": \"35.165.182.7\"\n                        },\n                        \"Primary\": true,\n                        \"PrivateDnsName\": \"ip-172-31-41-84.us-west-2.compute.internal\",\n                        \"PrivateIpAddress\": \"172.31.41.84\"\n                    }\n                ],\n                \"SourceDestCheck\": true,\n                \"Status\": \"in-use\",\n                \"SubnetId\": \"subnet-d962aa90\",\n                \"VpcId\": \"vpc-1052ce77\",\n                \"InterfaceType\": \"interface\"\n            }\n        ],\n        \"RootDeviceName\": \"/dev/sda1\",\n        \"RootDeviceType\": \"ebs\",\n        \"SecurityGroups\": [\n            {\n                \"GroupName\": \"launch-wizard-1\",\n                \"GroupId\": \"sg-490f6631\"\n            }\n        ],\n        \"SourceDestCheck\": true,\n        \"VirtualizationType\": \"hvm\",\n        \"CpuOptions\": {\n            \"CoreCount\": 1,\n            \"ThreadsPerCore\": 1\n        },\n        \"CapacityReservationSpecification\": {\n            \"CapacityReservationPreference\": \"open\"\n        },\n        \"HibernationOptions\": {\n            \"Configured\": false\n        },\n        \"MetadataOptions\": {\n            \"State\": \"applied\",\n            \"HttpTokens\": \"optional\",\n            \"HttpPutResponseHopLimit\": 1,\n            \"HttpEndpoint\": \"enabled\",\n            \"HttpProtocolIpv6\": \"disabled\",\n            \"InstanceMetadataTags\": \"disabled\"\n        },\n        \"EnclaveOptions\": {\n            \"Enabled\": false\n        },\n        \"PlatformDetails\": \"Linux/UNIX\",\n        \"UsageOperation\": \"RunInstances\",\n        \"UsageOperationUpdateTime\": \"2017-02-12 22:29:24+00:00\",\n        \"PrivateDnsNameOptions\": {},\n        \"MaintenanceOptions\": {\n            \"AutoRecovery\": \"default\"\n        }\n    }\n]\n```\n\n\u003ch2 id=\"to-do\"\u003e :paperclip: To-Do\u003c/h2\u003e\n\n- [x] Support `s3` services. \n- [ ] Support `iam` services. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbassammaged%2FawsEnum","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbassammaged%2FawsEnum","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbassammaged%2FawsEnum/lists"}