# AWS v1 (deprecated)

{% hint style="danger" %}
This version of the AWS integration is now deprecated. Please follow the instructions for [AWS v2](/docs/integrations/discovery-integrations/aws.md) when adding a new integration.
{% endhint %}

Import assets directly from Route53, ElasticIP, and Elastic Load Balancer by integrating with AWS.

{% hint style="info" %}
If you're connected with AWS, Halo Security can monitor assets with dynamic IP addresses by setting an AWS Instance ID for targets. For more information, see the [Scan Configuration](/docs/platform/targets/scan-configuration.md) page.
{% endhint %}

## AWS Setup

### Create Policy

1. In your AWS dashboard navigate to **Identity and Access Management (IAM)**
2. Click **Policies** then **Create policy**
3. Click **JSON** tab
4. Paste the [Policy JSON](/docs/integrations/discovery-integrations/aws.md#custom-policy-json) below
5. Click **Next: Tags**
6. Click **Next: Review**
7. Enter a name `Halo Security-integration-policy`
8. Click **Create Policy**

### Create User

1. In your AWS dashboard navigate to 'Identity and Access Management (IAM)'
2. Click **Users** then **Add user**
3. Enter a username `Halo Security-integration`
4. Check access type **Programmatic access**
5. Select **Attach existing policies directly**
6. Search for **Halo Security-integration-policy** and check the row.
7. Click **Next: Tags**
8. Click **Next: Review**
9. Click **Create user**
10. Save your **Access key ID** and **Secret access key**

### Custom Policy JSON

```json
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "HaloSecurity01",
            "Effect": "Allow",
            "Action": [
                "ec2:Describe*",
                "elasticloadbalancing:Describe*",
                "route53:GetHostedZone",
                "route53:ListHostedZones",
                "route53:ListResourceRecordSets",
                "route53:ListHostedZonesByName",
                "s3:ListAllMyBuckets",
                "cloudfront:ListDistributions"
            ],
            "Resource": "*"
        }
    ]
}
```

## Connect AWS to Halo Security

1. In your Halo Security dashboard navigate to the [Asset Import integration](https://app.halosecurity.com/user/settings/integrations/) section.
2. Click **Add**
3. Select "AWS".
4. Enter your **Access key ID** and **Secret access key**
5. Select any other options
6. Click **Save**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.halosecurity.com/docs/integrations/discovery-integrations/aws-v1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.