land rapid7#8320, docs for ftp_login

Author: h00die

documentation/modules/auxiliary/scanner/ftp/ftp_login.md

@@ -0,0 +1,62 @@
+## Description
+
+This module will test FTP logins on a range of machines and report successful logins. If you have loaded a database plugin and connected to a database this module will record successful logins and hosts so you can track your access.
+
+## Vulnerable Application
+
+### Install ftp server on Kali Linux:
+
+1.  ```apt-get install vsftpd```
+2. Allow local users to log in and to allow ftp uploads by editing file `/etc/vsftpd.conf` uncommenting the following:
+
+    ```
+    local_enable=YES
+    write_enable=YES
+    chroot_list_enable=YES
+    chroot_list_file=/etc/vsftpd.chroot_list
+    ```
+
+3. Create the file `/etc/vsftpd.chroot_list` and add the local users you want allow to connect to FTP server. Start service and test connections:
+4. ```service vsftpd start``` 
+
+### Installing FTP for IIS 7.5 in Windows:
+
+#### IIS 7.5 for Windows Server 2008 R2:
+
+1. On the taskbar, click Start, point to Administrative Tools, and then click Server Manager.
+2. In the Server Manager hierarchy pane, expand Roles, and then click Web Server (IIS).
+3. In the Web Server (IIS) pane, scroll to the Role Services section, and then click Add Role Services.
+4. On the Select Role Services page of the Add Role Services Wizard, expand FTP Server.
+5. Select FTP Service. (Note: To support ASP.NET Membership or IIS Manager authentication for the FTP service, you will also need to select FTP Extensibility.)
+6. Click Next.
+7. On the Confirm Installation Selections page, click Install.
+8. On the Results page, click Close. 
+
+#### IIS 7.5 for Windows 7:
+
+1. On the taskbar, click Start, and then click Control Panel.
+2. In Control Panel, click Programs and Features, and then click Turn Windows Features on or off.
+3. Expand Internet Information Services, then FTP Server.
+4. Select FTP Service. (Note: To support ASP.NET Membership or IIS Manager authentication for the FTP service, you will also need to select FTP Extensibility.)
+5. Click OK. 
+
+## Verification Steps
+
+1. Do: ```use auxiliary/scanner/ftp/ftp_login```
+2. Do: ```set RHOSTS [IP]```
+3. Do: ```set RPORT [IP]```
+4. Do: ```run```
+
+## Sample Output
+```
+msf> use auxiliary/scanner/ftp/ftp_login
+msf auxiliary(ftp_login) > set RHOSTS ftp.openbsd.org
+msf auxiliary(ftp_login) > set USERNAME ftp
+msf auxiliary(ftp_login) > set PASSWORD [email protected]
+msf auxiliary(ftp_login) > run
+[*] 129.128.5.191:21 - Starting FTP login sweep
+[+] 129.128.5.191:21 - LOGIN SUCCESSFUL: ftp:hello@metasploit.com
+[*] Scanned 1 of 1 hosts (100% complete)
+[*] Auxiliary module execution completed
+msf auxiliary(ftp_login) >
+```