Skip to content

Commit

Permalink
corrected typos and added doc on profile removal
Browse files Browse the repository at this point in the history
  • Loading branch information
jason-chao committed Jan 31, 2021
1 parent 88bee94 commit cf90ede
Show file tree
Hide file tree
Showing 17 changed files with 54 additions and 5 deletions.
4 changes: 3 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
# AppTraffic

AppTraffic is a scalable research tool for studying the network traffic of mobile applications (apps). AppTraffic integrates Softether and MITMProxy to allow for multiple research sessions. The public IP address of the mobile device may be changed by routing the traffic to different exit nodes.
AppTraffic is a scalable research tool for studying the network traffic of mobile applications (apps). AppTraffic provides an easy-to-use user interface which enables researchers from different backgrounds to capture and make sense of network traffic. AppTraffic integrates Softether and MITMProxy to allow for multiple research sessions. The public IP address of the mobile device may be changed by routing the traffic to different exit nodes.

Try AppTraffic at [https://apptraffic.phil.uni-siegen.de/](https://apptraffic.phil.uni-siegen.de/)
2 changes: 1 addition & 1 deletion apptraffic-control/coordination.py
Original file line number Diff line number Diff line change
Expand Up @@ -714,7 +714,7 @@ def new_redis_connection_thread(config: {}, logger=None):
redis_pubsub.psubscribe(**{channel: redis_subscription_handler})
thread = redis_pubsub.run_in_thread(sleep_time=0.01)
if logger:
logger.info(f"Subscrbied to '{channel}' channel on Redis ...")
logger.info(f"Subscribed to '{channel}' channel on Redis ...")
return thread

def listen_to_pubsub(config: {}):
Expand Down
2 changes: 1 addition & 1 deletion apptraffic-control/coordination_webapi.py
Original file line number Diff line number Diff line change
Expand Up @@ -296,7 +296,7 @@ def check_recording_status(username, session_id):
status_result["exitNodeCreated"] = session["resources"]["exit_node"]["created"].astimezone().isoformat()
if "mitm_web_port" in session:
status_result["mitm_web_port"] = session["mitm_web_port"]
status_result["exit_node_public_hostname"] = socket.gethostbyname(session["resources"]["exit_node"]["public_hostname"])
status_result["exit_node_public_hostname"] = socket.gethostbyname(session["resources"]["exit_node"]["public_hostname"]) # MITMweb does not allow binding to domain names; the use of IP address is necessnary
if "ended" in session:
status_result["ended"] = session["ended"].astimezone().isoformat()
result["returned"] = status_result
Expand Down
2 changes: 1 addition & 1 deletion apptraffic-control/machine.py
Original file line number Diff line number Diff line change
Expand Up @@ -464,7 +464,7 @@ def new_redis_connection_thread(machine_config: {}, channel=None, logger=None):
redis_pubsub.psubscribe(**{channel: redis_subscription_handler})
thread = redis_pubsub.run_in_thread(sleep_time=0.01)
if logger:
logger.info(f"Subscrbied to '{channel}' channel on Redis ...")
logger.info(f"Subscribed to '{channel}' channel on Redis ...")
return thread


Expand Down
47 changes: 47 additions & 0 deletions doc/remove_ios_profiles.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
# Removal of configuration profiles installed on iOS devices

After using AppTraffic, if you wish to remove the configuration profiles installed on your iOS device, please follow the instructions as follows.

1. Open `Settings` on your iOS device. Scroll down to `General`. Tap `General`.

![screenshot](res/remove_ios_profiles/01_settings_general.png)

2. Scroll down to `Profiles`. Tap `Profiles`.

![screenshot](res/remove_ios_profiles/02_scroll_down_profiles.png)

3. You should see the two configuration profiles related to AppTraffic. Tap one of these profiles to open the profile.

![screenshot](res/remove_ios_profiles/03_profile_list_twoprofiles.png)

4. Tap `Remove profile`

![screenshot](res/remove_ios_profiles/04_remove_profile.png)

5. Enter the passcode to your device

![screenshot](res/remove_ios_profiles/05_enter_passcode.png)

6. Tap `Remove`

![screenshot](res/remove_ios_profiles/06_remove.png)

7. One profile related to AppTraffic remains on the list. Tap the remaining profile.

![screenshot](res/remove_ios_profiles/07_profile_list_oneprofile.png)

8. Tap `Remove profile`

![screenshot](res/remove_ios_profiles/08_remove_profile.png)

9. Enter the passcode to your device

![screenshot](res/remove_ios_profiles/09_enter_passcode.png)

10. Tap `Remove`

![screenshot](res/remove_ios_profiles/10_remove.png)

11. All AppTraffic-related profiles are removed.

![screenshot](res/remove_ios_profiles/11_profile_list_empty.png)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/res/remove_ios_profiles/04_remove_profile.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/res/remove_ios_profiles/05_enter_passcode.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/res/remove_ios_profiles/06_remove.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/res/remove_ios_profiles/08_remove_profile.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/res/remove_ios_profiles/09_enter_passcode.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/res/remove_ios_profiles/10_remove.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docker-images/softether-vpnserver/softether-download.sh
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@ wget https://github.com/SoftEtherVPN/SoftEtherVPN_Stable/releases/download/v4.32
gzip -d softether-vpnserver-v4.32-9731-beta-2020.01.01-linux-x64-64bit.tar.gz
tar -xvf softether-vpnserver-v4.32-9731-beta-2020.01.01-linux-x64-64bit.tar

exit 0
exit 0

0 comments on commit cf90ede

Please sign in to comment.