diff --git a/README.md b/README.md index 09dbfd36..c6cf48d3 100644 --- a/README.md +++ b/README.md @@ -68,13 +68,13 @@ The system consists of two parts: Initially designed to run on a Raspberry PI, probably it can run on many other Linux distributions. - - [Installation instructions](doc/INSTALL.md) + - [Installation instructions](docs/INSTALL.md) ## Device Management - - [Device Management instructions](doc/DEVICE_MANAGEMENT.md) + - [Device Management instructions](docs/DEVICE_MANAGEMENT.md) ## Other useful info @@ -97,7 +97,7 @@ Linux distributions. ### License GPL 3.0 - [Read more here](doc/LICENSE.txt) + [Read more here](docs/LICENSE.txt) ### Contact pi.alert.application@gmail.com @@ -106,11 +106,11 @@ Linux distributions. -[main]: ./doc/img/1_devices.jpg "Main screen" -[screen1]: ./doc/img/2_1_device_details.jpg "Screen 1" -[screen2]: ./doc/img/2_2_device_sessions.jpg "Screen 2" -[screen3]: ./doc/img/2_3_device_presence.jpg "Screen 3" -[screen4]: ./doc/img/3_presence.jpg "Screen 4" -[report1]: ./doc/img/4_report_1.jpg "Report sample 1" -[report2]: ./doc/img/4_report_2.jpg "Report sample 2" +[main]: ./docs/img/1_devices.jpg "Main screen" +[screen1]: ./docs/img/2_1_device_details.jpg "Screen 1" +[screen2]: ./docs/img/2_2_device_sessions.jpg "Screen 2" +[screen3]: ./docs/img/2_3_device_presence.jpg "Screen 3" +[screen4]: ./docs/img/3_presence.jpg "Screen 4" +[report1]: ./docs/img/4_report_1.jpg "Report sample 1" +[report2]: ./docs/img/4_report_2.jpg "Report sample 2" diff --git a/doc/img/android_random_mac.png b/doc/img/android_random_mac.png deleted file mode 100644 index be4e6a52..00000000 Binary files a/doc/img/android_random_mac.png and /dev/null differ diff --git a/doc/DEVICE_MANAGEMENT.md b/docs/DEVICE_MANAGEMENT.md similarity index 62% rename from doc/DEVICE_MANAGEMENT.md rename to docs/DEVICE_MANAGEMENT.md index a2f2dae5..7c5111ce 100644 --- a/doc/DEVICE_MANAGEMENT.md +++ b/docs/DEVICE_MANAGEMENT.md @@ -48,6 +48,35 @@ To edit device information: - *(Useful to avoid notification saturation on devices that frequently connects and disconnects)* +# Privacy & Random MAC's + + +The latest versions of some operating systems (IOS and Android) incorporate a +new & interesting functionality to improve privacy: **Random MACs**. + +This functionality allows you to **hide the true MAC** of the device and +**assign a random MAC** when we connect to WIFI networks. + +This behavior is especially useful when connecting to WIFI's that we do not +know, but it **is totally useless when connecting to our own WIFI's** or known +networks. + +**I recommend disabling this operation when connecting our devices to our own +WIFI's**, in this way, Pi.Alert will be able to identify the device, and it +will not identify it as a new device every so often (every time IOS or Android +decides to change the MAC). + +### IOS +![ios][ios] + + - [Use private Wi-Fi addresses in iOS 14](https://support.apple.com/en-us/HT211227) + +### Android +![Android][Android] + + - [How to Disable MAC Randomization in Android 10](https://support.boingo.com/s/article/How-to-Disable-MAC-Randomization-in-Android-10-Android-Q) + - [How do I disable random Wi-Fi MAC address on Android 10](https://support.plume.com/hc/en-gb/articles/360052070714-How-do-I-disable-random-Wi-Fi-MAC-address-on-Android-10-) + ### License GPL 3.0 [Read more here](LICENSE.txt) @@ -61,4 +90,6 @@ To edit device information: [main]: ./img/1_devices.jpg "Main screen" [screen1]: ./img/2_1_device_details.jpg "Screen 1" +[ios]: https://9to5mac.com/wp-content/uploads/sites/6/2020/08/how-to-use-private-wifi-mac-address-iphone-ipad.png?resize=2048,1009 "ios" +[Android]: ./img/android_random_mac.jpg "Android" diff --git a/doc/INSTALL.md b/docs/INSTALL.md similarity index 96% rename from doc/INSTALL.md rename to docs/INSTALL.md index f812c608..d3f7b754 100644 --- a/doc/INSTALL.md +++ b/docs/INSTALL.md @@ -184,6 +184,13 @@ Stimated time: 20' 9 - Use admin panel to configure the devices - http://pi.alert/ + +## Device Management + + + - [Device Management instructions](docs/DEVICE_MANAGEMENT.md) + + ### License GPL 3.0 [Read more here](LICENSE.txt) diff --git a/doc/LICENSE.txt b/docs/LICENSE.txt similarity index 100% rename from doc/LICENSE.txt rename to docs/LICENSE.txt diff --git a/doc/RAMDOM_MAC.md b/docs/RAMDOM_MAC.md similarity index 96% rename from doc/RAMDOM_MAC.md rename to docs/RAMDOM_MAC.md index 118f842e..d9bb08ff 100644 --- a/doc/RAMDOM_MAC.md +++ b/docs/RAMDOM_MAC.md @@ -29,5 +29,5 @@ decides to change the MAC). [ios]: https://9to5mac.com/wp-content/uploads/sites/6/2020/08/how-to-use-private-wifi-mac-address-iphone-ipad.png?resize=2048,1009 "ios" -[Android]: img/android_random_mac.png "Android" +[Android]: ./img/android_random_mac.jpg "Android" diff --git a/doc/img/1_devices.jpg b/docs/img/1_devices.jpg similarity index 100% rename from doc/img/1_devices.jpg rename to docs/img/1_devices.jpg diff --git a/doc/img/2_1_device_details.jpg b/docs/img/2_1_device_details.jpg similarity index 100% rename from doc/img/2_1_device_details.jpg rename to docs/img/2_1_device_details.jpg diff --git a/doc/img/2_2_device_sessions.jpg b/docs/img/2_2_device_sessions.jpg similarity index 100% rename from doc/img/2_2_device_sessions.jpg rename to docs/img/2_2_device_sessions.jpg diff --git a/doc/img/2_3_device_presence.jpg b/docs/img/2_3_device_presence.jpg similarity index 100% rename from doc/img/2_3_device_presence.jpg rename to docs/img/2_3_device_presence.jpg diff --git a/doc/img/3_presence.jpg b/docs/img/3_presence.jpg similarity index 100% rename from doc/img/3_presence.jpg rename to docs/img/3_presence.jpg diff --git a/doc/img/4_report_1.jpg b/docs/img/4_report_1.jpg similarity index 100% rename from doc/img/4_report_1.jpg rename to docs/img/4_report_1.jpg diff --git a/doc/img/4_report_2.jpg b/docs/img/4_report_2.jpg similarity index 100% rename from doc/img/4_report_2.jpg rename to docs/img/4_report_2.jpg diff --git a/docs/img/android_random_mac.jpg b/docs/img/android_random_mac.jpg new file mode 100644 index 00000000..67929a17 Binary files /dev/null and b/docs/img/android_random_mac.jpg differ diff --git a/doc/report_sample_1.html b/docs/report_sample_1.html similarity index 100% rename from doc/report_sample_1.html rename to docs/report_sample_1.html diff --git a/doc/report_sample_2.html b/docs/report_sample_2.html similarity index 100% rename from doc/report_sample_2.html rename to docs/report_sample_2.html