From fbe93f6e7b55583d8701c6d00fd5cb02c979c1b7 Mon Sep 17 00:00:00 2001
From: Omar Santos <santosomar@gmail.com>
Date: Sun, 20 Aug 2023 22:44:31 -0400
Subject: [PATCH] Create enumerating_aws_boto3.md

---
 cloud_resources/enumerating_aws_boto3.md | 47 ++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 cloud_resources/enumerating_aws_boto3.md

diff --git a/cloud_resources/enumerating_aws_boto3.md b/cloud_resources/enumerating_aws_boto3.md
new file mode 100644
index 0000000..97b0635
--- /dev/null
+++ b/cloud_resources/enumerating_aws_boto3.md
@@ -0,0 +1,47 @@
+# Using Boto3, the AWS SDK for Python, to enumerate EC2 instances
+The following is a simple script using Boto3, the AWS SDK for Python, to enumerate EC2 instances, S3 buckets, and IAM roles. This script assumes that you have the necessary permissions and that your AWS credentials are properly configured.
+
+```python
+import boto3
+
+# Create a session using your AWS credentials
+session = boto3.Session()
+
+# Enumerate EC2 Instances
+print("EC2 Instances:")
+ec2_client = session.client('ec2')
+instances = ec2_client.describe_instances()
+for reservation in instances['Reservations']:
+    for instance in reservation['Instances']:
+        print(f"ID: {instance['InstanceId']}, State: {instance['State']['Name']}, Type: {instance['InstanceType']}")
+
+# Enumerate S3 Buckets
+print("\nS3 Buckets:")
+s3_client = session.client('s3')
+buckets = s3_client.list_buckets()
+for bucket in buckets['Buckets']:
+    print(f"Name: {bucket['Name']}")
+
+# Enumerate IAM Roles
+print("\nIAM Roles:")
+iam_client = session.client('iam')
+roles = iam_client.list_roles()
+for role in roles['Roles']:
+    print(f"Name: {role['RoleName']}, ARN: {role['Arn']}")
+
+```
+
+This script will print the details of EC2 instances, S3 buckets, and IAM roles in your AWS account.
+
+### Important Considerations:
+- **Permissions:** Make sure the AWS credentials you're using have the necessary permissions to list EC2 instances, S3 buckets, and IAM roles.
+- **Region:** By default, the script will use the region specified in your AWS configuration. If you want to specify a different region, you can do so when creating the session (e.g., `session = boto3.Session(region_name='us-west-2')`).
+- **Ethical Considerations:** Ensure that you have proper authorization to run this script on the target AWS account, as unauthorized scanning or enumeration can lead to legal issues.
+
+Before running the script, you'll need to have Boto3 installed in your environment, which you can do with the following command:
+
+```bash
+pip3 install boto3
+```
+
+Once you have Boto3 installed and your AWS credentials configured, you can run the script to enumerate the specified resources.