https://github.com/jfmaes/Red-Route53-Interactive

https://github.com/jfmaes/Red-Route53-Interactive

Last synced: 22 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/jfmaes/Red-Route53-Interactive
• Owner: jfmaes
• License: gpl-3.0
• Created: 2020-08-26T18:36:03.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-08-26T18:53:34.000Z (over 4 years ago)
• Last Synced: 2024-10-15T21:38:16.595Z (about 2 months ago)
• Size: 21.5 KB
• Stars: 17
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-hacking-lists - jfmaes/Red-Route53-Interactive - (Others)

README

        
# Red-Route53-Interactive

Manage RedTeam DNS over Ansible

## Requirements

To use this ansible role you'll need to have ansible installed (kinda obvious there)

Furthermore you'll need to have python3 and boto installed

```

pip3 install boto boto3

```

You will also need to have an AWS IAM user that has the capabilities of full control over Route53.

for more info on how to do that, please read the documentation over at AWS: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html#id_users_create_console

This role does **NOT** automatically generate DNS zones for you. 

Please register the domains (and create their respective zones) you'd like to use in Route53 manually.

## Usage

This role is intented to be used in combination with my Red-EC2 role (https://github.com/jfmaes/Red-EC2). 


However, it can be used separately as well (as all good Ansible roles should be). In which case this role will need an inventory file, or be preceeded by another role that creates a dynamic inventory. In this case you'll need to override the default xx_host_identifier variables in this role. 

## Caveat

This role is **interactive**, it will require your input in order to create the A records.

## Role variables

### AWS specific variables

| variable  	| default value  	|  description 	|   	

|:-:	|:-:	|:-:	|	

|   aws_access_key	| N/A   	|  needed to auth to AWS  	|   	   	

| aws_secret_key  	| N/A  	| needed to auth to AWS  	|   

### Route 53 specific variables

| variable  	| default value  	|  description 	|   	

|:-:	|:-:	|:-:	|	

|   C2_host_identifier	| C2  	|  the group variable used for C2 instances in Ansible's (dynamic) inventory 	|   	   	

| redir_host_identifier  	| Redirector 	| the group variable used for Redirector instances in Ansible's (dynamic) inventory  	|   

| redelk_host_identifier  	| RedELK  	| the group variable used for RedELK instances in Ansible's (dynamic) inventory  	| 

|overwrite| no | if DNS should be overriden in case the record already exists.  |