Docs update

This commit is contained in:
pucherot
2021-01-10 10:41:21 +01:00
parent a946cdfb45
commit 11e64ec3cc
16 changed files with 49 additions and 11 deletions

View File

@@ -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"

Binary file not shown.

Before

Width:  |  Height:  |  Size: 805 KiB

View File

@@ -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"

View File

@@ -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)

View File

@@ -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"

View File

Before

Width:  |  Height:  |  Size: 168 KiB

After

Width:  |  Height:  |  Size: 168 KiB

View File

Before

Width:  |  Height:  |  Size: 129 KiB

After

Width:  |  Height:  |  Size: 129 KiB

View File

Before

Width:  |  Height:  |  Size: 106 KiB

After

Width:  |  Height:  |  Size: 106 KiB

View File

Before

Width:  |  Height:  |  Size: 135 KiB

After

Width:  |  Height:  |  Size: 135 KiB

View File

Before

Width:  |  Height:  |  Size: 136 KiB

After

Width:  |  Height:  |  Size: 136 KiB

View File

Before

Width:  |  Height:  |  Size: 43 KiB

After

Width:  |  Height:  |  Size: 43 KiB

View File

Before

Width:  |  Height:  |  Size: 78 KiB

After

Width:  |  Height:  |  Size: 78 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 551 KiB