Verified Commit 6010205d authored by s1udge's avatar s1udge 💬

Merge branch 'dev'

Signed-off-by: s1udge's avatars1udge <s1udge@parrotsec.org>
parents c7d32fa2 b5ff2549
......@@ -10,7 +10,7 @@ visible: true
&nbsp;
ParrotOS is a community-driven open source project,
The Parrot Project is a community-driven opensource project,
and a gateway to spread innovative ideas born inside it's community.
&nbsp;
......@@ -91,7 +91,7 @@ Our community lives in several places, here are some links to stay in touch with
----
<a href="https://community.parrotsec.org/c/community/it" class="btn btn-default btn-primary"><strong>Italian Community</strong></a> <a href="https://t.me/joinchat/AerigkL_Y5Z1ZSpOLNNerQ" class="btn btn-default">Telegram</a>
<a href="https://community.parrotsec.org/c/community/it" class="btn btn-default btn-primary"><strong>Italian Community</strong></a> <a href="https://t.me/joinchat/BykV5UL_Y5Z1KOY81UxicA" class="btn btn-default">Telegram</a>
----
......
......@@ -3,7 +3,7 @@
For the ParrotOS homepage, visit [parrotsec.org](https://parrotsec.org).
An important part of any operating system is documentation, the technical manuals which describe the operation and use of programs. As part of its efforts to create a high-quality free operating system, ParrotOS is making every effort to provide all of its users with proper documentation in an easily accessible form.
An important part of any operating system is documentation, the technical manuals which describe the operation and use of programs. As part of its efforts to create a high-quality free operating system, the Parrot Project is making every effort to provide all of its users with proper documentation in an easily accessible form.
The documentation is still under construction, and all the Parrot users are invited to contribute to the creation and translation process of this portal.
......@@ -70,7 +70,7 @@ and customization of the system.
### Debian Documentation
ParrotOS is based on top of the testing branch of Debian GNUOS, so most of the [Debian Documentation](https://www.debian.org/doc) is valid for Parrot as well.
ParrotOS is based on top of the testing branch of Debian GNU operating system, so most of the [Debian Documentation](https://www.debian.org/doc) is valid for Parrot as well.
* [Debian Handbook](https://www.debian.org/doc/manuals/debian-handbook/), the comprehensive user manual
* [Debian Reference](https://www.debian.org/doc/manuals/debian-reference/), a terse user's guide with the focus on the shell command line
......
......@@ -29,12 +29,13 @@ However, for digital signatures to make any sense, we must ensure that the publi
## Fetch the key - Verify the repositories
Optional: Complete the steps below if unfamiliar with GnuPG or if they haven't already been performed. This will fix eventual GPG: WARNING: unsafe ownership warnings.
1 .First have GnuPG initialize your user data folder.
```bash
[user@parrot ~]$ gpg --fingerprint
```
1. Set warning free permissions.
2. Set warning free permissions.
```bash
[user@parrot ~]$ chmod --recursive og-rwx ~/.gnupg
```
......@@ -83,45 +84,25 @@ If this appears at the end of the output:
```
Analyze the other messages as usual. This extra message does not relate to the ParrotOS signing key itself, but instead usually means the user has not created an OpenPGP key yet, which is of no importance.
## Image verification
Download the cryptographic (OpenPGP) signature corresponding to the image you want to verify and save it in the same folder as the image:
Then, start the cryptographic verification, it can take several minutes.
```bash
cd [the directory in which you downloaded the .ova and the .asc]
gpg --verify-options show-notations --verify *.iso.asc *.asc
```
If the image is correct then GPG will tell you it's good. See the below output.
```bash
```
If the following message appears don't worry.
```bash
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
```
This message does not alter the validity of the signature related to the downloaded key. Rather, this warning refers to the level of trust placed in the ParrotOS signing key and the web of trust. To remove this warning, the ParrotOS signing key must be personally signed with your own key.
### Warning
Checking the GPG signature timestamp makes sense. For example, if you previously saw a signature from 2018 and now see a signature from 2017, then this might be a targeted rollback (downgrade) or indefinite [freeze attack](https://github.com/theupdateframework/tuf/blob/develop/SECURITY.md).
The first line includes the signature creation timestamp. Example.
## ISO verification
### MD5Sum hash verification
#### GNU/Linux
1. After you obtained the ISO of your choice go here https://cdimage.parrotsec.org/parrot/iso/4.5.1/signed-hashes.txt to see the signed hashes.
1. After you obtained the ISO of your choice go here https://cdimage.parrotsec.org/parrot/iso/4.6/signed-hashes.txt to see the signed hashes.
2. On the first section where it says "MD5" find the hash that matches your downloaded IASO.For the purpose of this tutorial we will use "Parrot-home-4.5.1_amd64.iso".
3. Now run the following command.
```bash
md5sum Parrot-home-4.5.1_amd64.iso
md5sum Parrot-home-4.6_amd64.iso
```
4. The above command should generate an outut like this
```bash
b4dbb5702c2666dc24ac4ba05d7b6608 Parrot-home-4.5.1_amd64.iso
e5390f46ce916d7a027e6e4a25035698
```
5. Compare the hash (the alphanumeric string on left) that your machine calculated with the corresponding hash on the page from Step 1.
......@@ -133,11 +114,11 @@ When both hashes match exactly then the downloaded file is almost certainly inta
The method for other hashes such as SHA256 or SHA512 is exactly the same with the above guides only instead of md5 you must use the proper hash you want.For example.
```bash
sha512sum Parrot-home-4.5.1_amd64.iso
sha512sum Parrot-home-4.6_amd64.iso
```
which will generate this
```bash
7e378ff51e4e62601c37f05c7b46a698449fdf7593a597c6e9b260573ab0b589e2cebac706189a2d9a616d50ff10d05c174771ab114fa7bcb20ba05dd2c7b35f
ef4042653ae599001b59ab8efc12648d7c63de64397b2c6848881adc52594b8e92bab0f9b22d81d81650bf1299faabf4d279b14fdfc8bb993335236adf571b27
```
&nbsp;
......
This diff is collapsed.
......@@ -18,7 +18,7 @@ In this page we list contributors and members, past and present, who have contri
| palinuro | Lorenzo Faletra | Team Leader<br>Core Dev<br>Sysadmin<br>Repository Maintainer | palinuro at parrotsec dot org|
| mibofra | Francesco Bonanno | ARM release dev<br>Sysadmin | mibofra at parrotsec dot org |
| nikksno | Nicolas North | Sysadmin<br>legal shit | nz at os dot vu |
| marafed | Federica Marasà | Graphic Designer | marafed at parrotsec dot org |
| marafed | Federica Marasà | Graphic Designer | marafed at parrotsec dot org |
| sheireen | Lisetta Ferrero | Core Dev | sheireen at parrotsec dot org |
| s1udge | | Operations lead <br> Forum Admin <br> Docs writer | s1udge at parrotsec dot org |
......@@ -28,7 +28,7 @@ In this page we list contributors and members, past and present, who have contri
# Dev Team
| nickname | name | role(s) | email |
| ---------------- | --------------------- | --------------------------------------------------------------- | ---------------------------- |
| Andi | | | |
| Andi | | Dev | |
&nbsp;
......@@ -37,7 +37,7 @@ In this page we list contributors and members, past and present, who have contri
| ---------------- | --------------------- | --------------------------------------------------------------- | ---------------------------- |
| meu | M. Emrah Ünsür | Turkish Community Leader <br> Forum Moderator | meu at parrotsec dot org |
| terabreik | Jose Gatica | Spanish Community Leader <br> Forum Moderator | josegatica at parrotsec dot org |
| ByteHackr | Nemo Sandipan Roy | Indian community Leader <br> Forum Moderator | nemo at parrotsec dot org |
| ByteHackr | Sandipan Roy(nemo) | Indian community Leader <br> Forum Moderator | nemo at parrotsec dot org |
| AresX | | Chinese Community Leader <br> Forum Moderator | |
| anubi5 | Abdel Rhman Anter | Arabic Community Leader <br> Forum Moderator | anubi5 at parrotsec dot org |
| disrupt_the_flow | | Greek Community Leader <br> Docs writer <br> Telegram Admin <br> Forum Moderator | disrupt_the_flow at parrotsec dot org|
......@@ -49,7 +49,7 @@ In this page we list contributors and members, past and present, who have contri
| Nico_Paul | Nico Gialluca | English Community Leader <br> Forum Moderator <br>Organizer | nico at parrotsec dot org |
| Kidklown | | English Community <br> Forum Moderator | |
| Jeff | Jeff Szydel | Facebook admin <br> System Tester | jeff at parrotsec dot org |
| Zaphod BB | Patrick Dunn | Telegram Admin <br> Forum Moderator | |
| Zaphod BB | | Telegram Admin <br> Forum Moderator | |
| mastrobirraio | Pino Matranga | Web Team Leader <br> Italian Community Leader <br> Forum Moderator | |
| LulzRose | Kurt Bruggeman | | LulzRose@riseup.net |
| Dm knght | | Forum Moderator <br> Tutorial writer | |
......
......@@ -34,7 +34,6 @@ Firmware
Virtual Machine Emulators and Containers
- VMware (not guaranteed as it depends on what linux kernel they support)
- Docker
- QEMU
- VirtualBox
......@@ -88,6 +87,7 @@ Hardware overall
- gnome software (no future plans to provide support, though community members are more than welcome to provide other desktop environments)
- All other Architectures not listed.
- Secure boot
- VMware
- Intel Optane (Only works with Windows)
### NOTE: Want something that's not listed? Help us make it [happen](https://nest.parrotsec.org/)
......
......@@ -76,48 +76,56 @@ Sadly, pluggable transports are not immune to detection, if a censor is given en
Bridges which support pluggable transports can be used with Tor Browser easily. Tor Browser includes some pre-configured bridges and you can get more from BridgeDB, if those don't work.
#### Usng PTs to bypass censorship
### Usng PTs to bypass censorship
![PT](https://www.torproject.org/images/PT/2016-07-how-to-use-PT.png)
### Using bridges with Tor
#### Using bridges with Tor
#### Adding bridges in Tor Browser when Tor does not work
Sometimes Tor does not work due to a silly mistake rather than your ISP interfering with your Internet connection.
1) To add a bridge, follow the instructions on screen. Click the "Configure" button.
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-startup.png)
1) To add a bridge, follow the instructions on screen. Click the "Configure" button.
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-proxy.png)
2) Proxy and Censorship prevention settings are now on one page. If your Internet Service Provider (ISP) blocks or otherwise censors connections to the Tor Network, tick this checkbox.
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-network-settings.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-network-settings.png)
3) If you must configure a proxy then, activate the second checkbox and enter the details.
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-proxy.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-proxy.png)
4) Now you have three configuration options. You can use bridges which are preconfigured and provided with Tor Browser, you can specify your own bridge(s), or request bridges.
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-bridges.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-bridges.png)
5a) If you want to use one of the provided bridges, then choose one of the offered transport types. obfs4 is currently recommend, but depending on where you are located another one may work better for you. If you have any questions, please contact us.
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-bridges-provided.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-bridges-provided.png)
5b) If none of the provided bridges works for you, try to request one:
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-request-bridges.png)
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-request-bridges-connect.png)
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-request-bridges-captcha.png)
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-request-bridges-success.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-request-bridges.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-request-bridges-connect.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-request-bridges-captcha.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-request-bridges-success.png)
5c) To use a custom bridge select "Provide a bridge I know".
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-provide-bridge.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-provide-bridge.png)
6) After you decide which bridges you want to use, click "Connect". Tor should now be able to load successfully and the browser window should appear.
![bridge](https://www.torproject.org/images/tb-frontpage.png)
![bridge](https://2019.www.torproject.org/images/tb-frontpage.png)
#### Troubleshooting bridges
Sometimes the bootstrapping gets stuck at some point, for example when a bridge went offline, the connection is blocked, or when the Pluggable Transport is hit by a bug.
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-bootstrap.png)
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-bootstrap-failed.png)
Sometimes the bootstrapping gets stuck at some point, for example when a bridge went offline, the connection is blocked, or when the Pluggable Transport is hit by a bug.
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-bootstrap.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-bootstrap-failed.png)
Ideally it works after some tries, using a different bridge, or restarting the browser. If not, remove the Tor Browser folder and extract the archive again. It should work now. If it still fails, we want to hear from you!
#### Adding bridges in Tor Browser when Tor does work
......@@ -125,28 +133,35 @@ Sometimes the bootstrapping gets stuck at some point, for example when a bridge
The following instructions assume Tor Browser successfully loads and you are able to surf the web. If you do not see the web browser when you run Tor Browser (like in step (1) below), you may need to follow the instructions above.
1) Start Tor Browser:
![bridge](https://www.torproject.org/images/tb-frontpage.png)
![bridge](https://2019.www.torproject.org/images/tb-frontpage.png)
2) To begin using bridges, open Tor Browser's Network Settings:
![bridge](https://www.torproject.org/images/tb-tor-button-menu.png)
3) Select "My Internet Service Provider (ISP) blocks connections to the Tor network":
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-bridges.png)
![bridge](https://2019.www.torproject.org/images/tb-tor-button-menu.png)
3) Select "Tor is censored in my country":
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-bridges.png)
4) Now you have three configuration options. You can use bridges which are preconfigured and provided with Tor Browser, you can request new bridges, or specify your own bridge(s).
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-bridges.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-bridges.png)
5a) If you want to use one of the provided bridges, then choose one of the offered transport types. obfs4 is currently recommend, but depending on where you are located another one may work better for you. If you have any questions, please contact us.
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-bridges-provided.png)
5b) If none of the provided bridges works for you, try "Request a bridge from torproject.org"
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-request-bridges.png)
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-request-bridges-connect.png)
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-request-bridges-captcha.png)
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-request-bridges-success.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-bridges-provided.png)
5b) If none of the provided bridges work for you, try "Request a bridge from torproject.org" and click on " Request a Bridge"
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-request-bridges.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-request-bridges-connect.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-request-bridges-captcha.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-request-bridges-success.png)
5c) To use a custom bridge select "Provide a bridge I know".
![bridge](https://www.torproject.org/images/bridges/tb-tor-launcher-provide-bridge.png)
![bridge](https://2019.www.torproject.org/images/bridges/tb-tor-launcher-provide-bridge.png)
Tor will only use one bridge at a time, but it is good to add more than one bridge so you can continue using Tor even if your first bridge becomes unavailable.
......@@ -268,4 +283,6 @@ Sixth, if the above ideas don't point out the bug, consider increasing your log
More info on Tor: https://www.torproject.org/docs/faq.html.en
&nbsp;
[Using Parrot](https://www.parrotsec.org/docs/info/start/) | [Troubleshooting](https://www.parrotsec.org/docs/trbl/start/) | [Linux Beginner Guide](https://www.parrotsec.org/docs/library/lbg-basics/) | [Home](https://www.parrotsec.org/docs/)
[Using Parrot](https://www.parrotsec.org/docs/info/start/) | [Troubleshooting](https://www.parrotsec.org/docs/trbl/start/) | [Linux Beginner Guide](https://www.parrotsec.org/docs/library/lbg-basics/) | [Home](https://www.parrotsec.org/docs/)
\ No newline at end of file
......@@ -32,9 +32,10 @@ nav:
- APT Mirror list: mirror-list.md
- Make your own mirror: mirror-list/#make-your-own-mirror
- Infrastructure Weathermap: weathermap.md
- Community:
- Community:
- News: https://www.parrotsec.org/blog/
- Future Plans: roadmap.md
- Social Media: community.md
- The Team: team.md
- Partners: partners.md
- Donate: donate.md
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment