Skip to content

An Ansible playbook for a fully-automated Gophish deployment on Ubuntu 18.04.

License

Notifications You must be signed in to change notification settings

edingc/ansible-gophish-ubuntu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Contributors Forks Stargazers Issues MIT License LinkedIn

ansible-gophish-ubuntu Screen Shot

ansible-gophish-ubuntu

An Ansible playbook to setup Gophish quickly on an Ubuntu 18.04 system. Comes complete with working SSL, DKIM and TLS. Instructions for DNS requirements provided upon completion.
Report Bug · Request Feature

Table of Contents

Built With/On

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

As this is an Ansible playbook, Ansible is required to be installed on a control machine. Ansible is available for almost every platform.

This playbook was developed using a Digital Ocean Ubuntu 18.04 instance, but should work on any Ubuntu 18.04 installation.

Installation

  1. Clone the ansible-gophish-ubuntu
git clone https://github.com/edingc/ansible-gophish-ubuntu.git
  1. Run the Ansible playbook
ansible-playbook site.yml

Usage

After the playbook has been run against the target host, a file containing needed DNS entries will be placed in the home directory of Gophish user. Place these entries into your DNS.

By default, the ports needed to access the Gophish user interface are not opened. I recommend setting up a SOCKS tunnel to access the administration page.

The user guide for Gophish can be found at the Gophish documentation website.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Your Name - @edingc - [email protected]

Project Link: https://github.com/edingc/ansible-gophish-ubuntu

Acknowledgements

  • Digital Ocean Community for the basis of the "common" task
  • Gophish for the bits that download and extract Gophish
  • Othneil Drew for the great README.md template
  • Numerous other websites, Google searches and StackOverflow posts that yielded individual bits and bobs necessary to get OpenDKIM, Postfix, SSL and TLS all playing nicely together

About

An Ansible playbook for a fully-automated Gophish deployment on Ubuntu 18.04.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages