> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macstadium.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 2. AWS VPN Tunnel Configuration File

> Download the AWS VPN config file and fill in Orka network values for your Cisco ASAv: outside interface, Private-1 subnet, NAT rules, and VPC details.

Download the VPN configuration file from Amazon and fill it in with your Orka network configuration.

<Note>
  **You need:**

  * The name `Outside` from your [IP Plan](/macstadium/macstadium-overview/ip-plan).
  * The IP address for the `Private-1` network from your [IP Plan](/macstadium/macstadium-overview/ip-plan).
  * The subnet mask for the `Private-1` network from your [IP Plan](/macstadium/macstadium-overview/ip-plan).
  * The IPv4 address of your Amazon VPC.
  * The subnet mask for your Amazon VPC converted from its CIDR notation (i.e. `255.255.0.0` instead of `/16`).
</Note>

After you [have created your VPN tunnel in Amazon](/orka/networking-with-orka-at-macstadium/1-aws-side-of-the-vpn-tunnel), you need to configure your Cisco firewall to recognize the connection and let traffic into your Orka cluster.

Amazon provides a semi-prefilled configuration file with very detailed instructions. First, you need to download the configuration file and provide the missing information indicated by placeholders. Next, you'll need to [feed the configuration](/orka/networking-with-orka-at-macstadium/3-aws-orka-side-of-the-vpn-tunnel) into your Cisco ASAv to complete the setup.

## Step 1: Download the file from Amazon

1. Verify that you are logged in to your AWS Management Console and you're working in the correct region.
2. [Verify that you have created a tunnel in Amazon.](/orka/networking-with-orka-at-macstadium/1-aws-side-of-the-vpn-tunnel)
3. Navigate to your VPC service. In the VPC service sidebar, locate the **Virtual Private Network** menu and select **Site-to-Site VPN Connections**.

<img src="https://mintcdn.com/macstadiuminc/9YdlTfp9PivQkqG1/images/attachments/28401474329883.png?fit=max&auto=format&n=9YdlTfp9PivQkqG1&q=85&s=54304f32a7e5a39cfb12d90e4ecd856f" alt="AWS VPC sidebar with Site-to-Site VPN Connections selected" width="2640" height="2168" data-path="images/attachments/28401474329883.png" />

4. In the list, select your newly created VPN connection and click **Download Configuration**.

<img src="https://mintcdn.com/macstadiuminc/9YdlTfp9PivQkqG1/images/attachments/28401443700635.png?fit=max&auto=format&n=9YdlTfp9PivQkqG1&q=85&s=aa5bda7dd0dbb0ee8856b691db18bd37" alt="AWS VPN connection selected with Download Configuration button visible" width="2192" height="642" data-path="images/attachments/28401443700635.png" />

5. Fill in the form and click **Download**.
   1. For **Vendor** , select **Cisco Systems, Inc.**.
   2. For **Platform** , select **ASA 5500 Series**.
   3. For **Software** , select **ASA 9.x** for a policy-based VPN OR **ASA 9.7 + VTI** for a route-based VPN.

<img src="https://mintcdn.com/macstadiuminc/9YdlTfp9PivQkqG1/images/attachments/28401443701915.png?fit=max&auto=format&n=9YdlTfp9PivQkqG1&q=85&s=72fa31a66218551bd67f364071f75fe8" alt="Download Configuration dialog with Cisco ASA 5500 vendor and platform selected" width="1240" height="694" data-path="images/attachments/28401443701915.png" />

## Step 2: Fill in the configuration file

<Warning>
  Unless you have extensive experience with AWS and ASAv configurations, follow the instructions in the configuration file to the letter. Otherwise, your site-to-site VPN might not work as expected.
</Warning>

1. Open the configuration file in a text editor.
2. Replace all placeholders with their respective values.

| Placeholder             | Value                        | Description                                                                                                                         | More information                                                                                                                                                                                                                                                                                                                                             |
| ----------------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `<outside_interface>`   | `Outside`                    | The **name** of the outside interface of your Cisco ASAv device (the `Outside` network).                                            | [The IP Plan](/macstadium/macstadium-overview/ip-plan)                                                                                                                                                                                                                                                                                                       |
| `<outside_access_in>`   | (Sample) `outside_access_in` | Any unique name. This will be the name for the access control list that permits the creation of the tunnel and the traffic over it. | [Cisco Documentation: Cisco Access Control Lists](https://www.cisco.com/c/en/us/support/docs/security/ios-firewall/23602-confaccesslists.html)                                                                                                                                                                                                               |
| `<vpc_subnet>`          | (Sample) `192.168.0.0`       | The IPv4 address of your Amazon VPC (without the subnet mask bit notation).                                                         | You can get this value by selecting your VPC in AWS > VPC dashboard and checking the **Details** at the bottom of the screen.                                                                                                                                                                                                                                |
| `<vpc_subnet_mask>`     | (Sample) `255.255.0.0`       | The subnet mask for your Amazon VPC, converted from its CIDR notation.                                                              | You can get this value by selecting your VPC in AWS > VPC dashboard and checking the **Description** at the bottom of the screen. You need to convert the [subnet mask bit notation](http://www.steves-internet-guide.com/subnetting-subnet-masks-explained/) to the correct subnet mask (e.g., the `/16` notation converts to a `255.255.0.0` subnet mask). |
| `<amzn_vpn_map>`        | (Sample) `amzn_vpn_map`      | Any unique name for the crypto map. It must not be already in use by any other crypto maps you might have configured.               | [Cisco Documentation: Configuring Crypto Maps](https://www.cisco.com/c/en/us/td/docs/security/vpn_modules/6342/vpn_cg/6342site3.html#wp1036915)                                                                                                                                                                                                              |
| `<sla_monitor_address>` | (Sample) `192.168.0.1`       | An IP address in your Amazon VPC that can serve as an SLA monitor keeping the site-to-site tunnel alive.                            | You can set this to the `<vpc_subnet>` address plus one.                                                                                                                                                                                                                                                                                                     |
| `<local_subnet>`        | `10.221.188.0`               | The IP address for the `Private-1` network.                                                                                         | [The IP Plan](/macstadium/macstadium-overview/ip-plan)                                                                                                                                                                                                                                                                                                       |
| `<local_subnet_mask>`   | `255.255.255.0`              | The subnet mask for the `Private-1` network.                                                                                        | [The IP Plan](/macstadium/macstadium-overview/ip-plan)                                                                                                                                                                                                                                                                                                       |

3. Uncomment the following lines. To uncomment, remove `! `at the start of the line.
   * `access-list amzn-filter extended permit ip ...`
   * `object`- and `nat`-related configuration at the end of the config file.
4. Keep the following line. This ensures the SLA monitor works as expected.

```
object network obj-SrcNet subnet 0.0.0.0 0.0.0.0
```

Note that based on your network configuration and requirements, you can modify this line to map to the subnet and the subnet mask for the `Private-1` network from your [IP Plan](/macstadium/macstadium-overview/ip-plan). If you choose to modify this line, **do not** configure the `<sla_monitor_address>` value.

5. Change `nat (inside,outside)` to `nat (Private-1,Outside)`.
6. (Optional) Delete the remaining commented lines to clean up the file. Commented lines are indicated by `! `at the beginning of the line.
7. Save your changes.
