Docs update
20
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
|
Initially designed to run on a Raspberry PI, probably it can run on many other
|
||||||
Linux distributions.
|
Linux distributions.
|
||||||
|
|
||||||
- [Installation instructions](doc/INSTALL.md)
|
- [Installation instructions](docs/INSTALL.md)
|
||||||
|
|
||||||
|
|
||||||
## Device Management
|
## Device Management
|
||||||
<!--- --------------------------------------------------------------------- --->
|
<!--- --------------------------------------------------------------------- --->
|
||||||
|
|
||||||
- [Device Management instructions](doc/DEVICE_MANAGEMENT.md)
|
- [Device Management instructions](docs/DEVICE_MANAGEMENT.md)
|
||||||
|
|
||||||
|
|
||||||
## Other useful info
|
## Other useful info
|
||||||
@@ -97,7 +97,7 @@ Linux distributions.
|
|||||||
|
|
||||||
### License
|
### License
|
||||||
GPL 3.0
|
GPL 3.0
|
||||||
[Read more here](doc/LICENSE.txt)
|
[Read more here](docs/LICENSE.txt)
|
||||||
|
|
||||||
### Contact
|
### Contact
|
||||||
pi.alert.application@gmail.com
|
pi.alert.application@gmail.com
|
||||||
@@ -106,11 +106,11 @@ Linux distributions.
|
|||||||
|
|
||||||
|
|
||||||
<!--- --------------------------------------------------------------------- --->
|
<!--- --------------------------------------------------------------------- --->
|
||||||
[main]: ./doc/img/1_devices.jpg "Main screen"
|
[main]: ./docs/img/1_devices.jpg "Main screen"
|
||||||
[screen1]: ./doc/img/2_1_device_details.jpg "Screen 1"
|
[screen1]: ./docs/img/2_1_device_details.jpg "Screen 1"
|
||||||
[screen2]: ./doc/img/2_2_device_sessions.jpg "Screen 2"
|
[screen2]: ./docs/img/2_2_device_sessions.jpg "Screen 2"
|
||||||
[screen3]: ./doc/img/2_3_device_presence.jpg "Screen 3"
|
[screen3]: ./docs/img/2_3_device_presence.jpg "Screen 3"
|
||||||
[screen4]: ./doc/img/3_presence.jpg "Screen 4"
|
[screen4]: ./docs/img/3_presence.jpg "Screen 4"
|
||||||
[report1]: ./doc/img/4_report_1.jpg "Report sample 1"
|
[report1]: ./docs/img/4_report_1.jpg "Report sample 1"
|
||||||
[report2]: ./doc/img/4_report_2.jpg "Report sample 2"
|
[report2]: ./docs/img/4_report_2.jpg "Report sample 2"
|
||||||
|
|
||||||
|
|||||||
|
Before Width: | Height: | Size: 805 KiB |
@@ -48,6 +48,35 @@ To edit device information:
|
|||||||
- *(Useful to avoid notification saturation on devices that frequently
|
- *(Useful to avoid notification saturation on devices that frequently
|
||||||
connects and disconnects)*
|
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
|
### License
|
||||||
GPL 3.0
|
GPL 3.0
|
||||||
[Read more here](LICENSE.txt)
|
[Read more here](LICENSE.txt)
|
||||||
@@ -61,4 +90,6 @@ To edit device information:
|
|||||||
<!--- --------------------------------------------------------------------- --->
|
<!--- --------------------------------------------------------------------- --->
|
||||||
[main]: ./img/1_devices.jpg "Main screen"
|
[main]: ./img/1_devices.jpg "Main screen"
|
||||||
[screen1]: ./img/2_1_device_details.jpg "Screen 1"
|
[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"
|
||||||
|
|
||||||
@@ -184,6 +184,13 @@ Stimated time: 20'
|
|||||||
9 - Use admin panel to configure the devices
|
9 - Use admin panel to configure the devices
|
||||||
- http://pi.alert/
|
- http://pi.alert/
|
||||||
|
|
||||||
|
|
||||||
|
## Device Management
|
||||||
|
<!--- --------------------------------------------------------------------- --->
|
||||||
|
|
||||||
|
- [Device Management instructions](docs/DEVICE_MANAGEMENT.md)
|
||||||
|
|
||||||
|
|
||||||
### License
|
### License
|
||||||
GPL 3.0
|
GPL 3.0
|
||||||
[Read more here](LICENSE.txt)
|
[Read more here](LICENSE.txt)
|
||||||
@@ -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"
|
[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"
|
||||||
|
|
||||||
|
Before Width: | Height: | Size: 168 KiB After Width: | Height: | Size: 168 KiB |
|
Before Width: | Height: | Size: 129 KiB After Width: | Height: | Size: 129 KiB |
|
Before Width: | Height: | Size: 106 KiB After Width: | Height: | Size: 106 KiB |
|
Before Width: | Height: | Size: 135 KiB After Width: | Height: | Size: 135 KiB |
|
Before Width: | Height: | Size: 136 KiB After Width: | Height: | Size: 136 KiB |
|
Before Width: | Height: | Size: 43 KiB After Width: | Height: | Size: 43 KiB |
|
Before Width: | Height: | Size: 78 KiB After Width: | Height: | Size: 78 KiB |
BIN
docs/img/android_random_mac.jpg
Normal file
|
After Width: | Height: | Size: 551 KiB |