PortScanner

PortScanner is our midterm project for our Distributed Systems course at Universidad Autónoma de Querétaro. This project is an iOS app which main goal is to scan a given range of ports from a given host and retrieve those who are available. Then, the user can open a terminal for 3 ports: 22, 80 and 3306.

Getting Started

Built With

• Swift 4
• Xcode 9
• CocoaPods

Libraries (Pods)

• SwiftSocket – Socket management and HTTP connection (port 80)
• SwiftSH – SSH connection (Port 22)
• OHMyUSQL – Database connection (Port 3306)

User Manual

Scanning ports

1. Enter a host and a range of ports to scan.
2. Tap blue button.
3. All available ports will be displayed in the TableView.
4. Only 3 ports are available to interact with (22, 80 and 3306). When tapped over them, a new View will show.

SSH (Port 22)

1. To create a connection, the user and password are needed.
2. We tested this port with macOS, using the command 'say' before a statement (e.g. say Hello there)
3. To close the connection just swipe back to the TableView.

Note: there's no feedback from the host yet, so one-way commands are the only accepted commands.

HTTP (80)

1. Once the view is displayed, you can type 'GET / HTTP/1.0' + two line breaks and press 'Enviar' to retrieve the html file.
2. The connection is closed once you swipe right to go back to the TableView.

Database (3306)

1. A user, password and database is needed to start a connection.
2. Queries can be ran by typing the sentence and pressing 'Enviar'.
3. Results are displayed as a JSON.
4. Session is closed once the user goes back the the TableView.

Note: Setting up access permission from the database is needed to use this service.

Authors

• Fernando Ortiz Rico Celio
• Marco Antonio Galicia Toriz

Acknowledgements

• swiftsocket (SwiftSockets author)
• Tommaso Madonia (SwiftSH author)
• Oleg (OHMySQL author)