Skip to content
This repository has been archived by the owner on Sep 29, 2024. It is now read-only.

Add Complete XOR Patch Functionality #255

Merged
merged 15 commits into from
Nov 6, 2022
Merged

Add Complete XOR Patch Functionality #255

Changes from 1 commit
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
9d64d97
Add support for multi-byte values to be used in the xormask position
tmthecoder May 25, 2022
61cc579
Add the different xor methods and change the ragex to parse them.
tmthecoder May 25, 2022
4601991
Add remaining xor patch options and their implementations
tmthecoder May 25, 2022
39ea282
fix the reverse error
tmthecoder May 25, 2022
f57cc6c
Add Reverse fix for TCP and xorptrpos overflow fix for UDP
tmthecoder May 25, 2022
45ee144
Add guide for complete XOR patch & credit
tmthecoder Aug 5, 2022
2444149
Merge branch 'master' into add-full-xor-patch
keeshux Nov 3, 2022
9aef680
Refactor all the XOR things
keeshux Nov 4, 2022
da28e1c
Test XOR algorithms reversibility
keeshux Nov 4, 2022
8e4143f
Test XOR on PacketStream
keeshux Nov 4, 2022
01dd04d
Remove test example
keeshux Nov 4, 2022
6b77ab8
Test no XOR also
keeshux Nov 4, 2022
b9cfd13
Run tests on PRs
keeshux Nov 4, 2022
c08441b
Fix test target
keeshux Nov 4, 2022
cea90f9
Cancel pending jobs
keeshux Nov 4, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Add guide for complete XOR patch & credit
  • Loading branch information
@tmthecoder
tmthecoder committed Aug 5, 2022
commit 45ee1449ac1cc2403c86c44a3600cf9625b2d30b
21 changes: 17 additions & 4 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,10 +46,20 @@ TunnelKit can parse .ovpn configuration files. Below are a few details worth men

#### Non-standard

- Single-byte XOR masking
- Via `--scramble xormask <character>`
- XOR all incoming and outgoing bytes by the ASCII value of the character argument
- See [Tunnelblick website][about-tunnelblick-xor] for more details
- XOR-patch functionality:
- Multi-byte XOR Masking
- Via `--scramble xormask <passphrase>`
- XOR all incoming and outgoing bytes by the passphrase given
- XOR Position Masking
- Via `--scramble xorptrpos`
- XOR all bytes by their position in the array
- Packet Reverse Scramble
- Via `--scramble reverse`
- Keeps the first byte and reverses the rest of the array
- XOR Scramble Obfuscate
- Via `--scramble obfuscate <passphrase>`
- Performs a combination of the three above (specifically `xormask <passphrase>` -> `xorptrpos` -> `reverse` -> `xorptrpos` for reading, and the opposite for writing)
- See [Tunnelblick website][about-tunnelblick-xor] for more details (Patch was written in accordance with Tunnelblick's patch for compatibility)

#### Unsupported

Expand Down Expand Up @@ -217,6 +227,7 @@ For more details please see [CONTRIBUTING][contrib-readme].
- [SURFnet][ppl-surfnet]
- [SwiftyBeaver][dep-swiftybeaver-repo] - Copyright (c) 2015 Sebastian Kreutzberger
- [XMB5][ppl-xmb5] for the [XOR patch][ppl-xmb5-xor] - Copyright (c) 2020 Sam Foxman
- [tmthecoder][ppl-tmthecoder] for the complete [XOR patch][ppl-tmthecoder-xor] - Copyright (c) 2022 Tejas Mehta
- [eduVPN][ppl-eduvpn] for the convenient WireGuardKitGo script

### OpenVPN
Expand Down Expand Up @@ -259,6 +270,8 @@ Website: [passepartoutvpn.app][about-website]
[ppl-surfnet]: https://www.surf.nl/en/about-surf/subsidiaries/surfnet
[ppl-xmb5]: https://github.com/XMB5
[ppl-xmb5-xor]: https://github.com/passepartoutvpn/tunnelkit/pull/170
[ppl-tmthecoder]: https://github.com/tmthecoder
[ppl-tmthecoder-xor]: https://github.com/passepartoutvpn/tunnelkit/pull/255
[ppl-eduvpn]: https://github.com/eduvpn/apple
[about-tunnelblick-xor]: https://tunnelblick.net/cOpenvpn_xorpatch.html
[about-pr-bitcode]: https://github.com/passepartoutvpn/tunnelkit/issues/51
Expand Down