Skip to content

Latest commit

 

History

History
58 lines (43 loc) · 2.35 KB

README.md

File metadata and controls

58 lines (43 loc) · 2.35 KB

aws-sg-whitelist-my-ip

Role to whitelist the external IP of the machine the code is running on a.k.a. Ansible controller or a custom IP specified as an extra var with support of resetting to the original state or re-compute a changed external IP

Requirements

  • Python 2.7
  • boto
  • AWS access keys with EC2FullAccess privileges

Role Variables

  • AWS_ACCESS_KEY_ID: Access key with EC2FullAccess privileges being set as environment variable as shown in the sample below
  • AWS_SECRET_ACCESS_KEY: Corresponding secret access key to AWS_ACCESS_KEY_ID
  • EC2_REGION: The AWS region of your infrastructure
  • path_to_role: Path to the directory of the role. Default: roles/mikhailadvani.aws-sg-whitelist-my-ip
  • security_groups: The security group rules that should be modified to allow the IP of the controller machine. Supports multiple security groups
    • name: Name of the security group to be updated
    • vpc_id: The id of the VPC of the security group
    • rules: The additional inbound rules to be added from the controller IP. cidr_ip needs to be "{{my_ip}}" which will be resolved dynamically as a pre-task
  • access: set/unset/reset. Whether your external IP needs to be added, removed or updated to the security groups mentioned in vars Mandatory: yes. Default: none
  • my_ip: Optional extra var to whitelist specified IP instead of querying external API myexternalip.com. Default: Auto-computed to the external IP of the controller machine

Example Playbook

ansible-playbook aws-sg-whitelist-my-ip.yml -v -e "access=set"

ansible-playbook aws-sg-whitelist-my-ip.yml -v -e "access=reset"

ansible-playbook aws-sg-whitelist-my-ip.yml -v -e "access=unset"

- hosts: localhost
  connection: local
  pre_tasks:
    - include: "{{path_to_role}}/tasks/get_my_ip.yml"
      when: my_ip is not defined and (access == 'set' or access == 'reset')
  environment:
    AWS_ACCESS_KEY_ID: "{{AWS_ACCESS_KEY_ID}}"
    AWS_SECRET_ACCESS_KEY: "{{AWS_SECRET_ACCESS_KEY}}"
    EC2_REGION: "{{EC2_REGION}}"
  roles:
    - {role: aws-sg-whitelist-my-ip}

License

MIT

Author Information

The role was created in 2016 by Mikhail Advani

Twitter Handle: @mikhail_advani