README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76


Emailproxy-UI
Welcome to Emailproxy-UI! The extra helping hand of scuffed code that hopefully makes your EmailProxy experience less of a dumpster fire.
For now only able to do Office 365 Accounts and that uhm just barely but feel free to have a go at making it do other 2FA terribleness E-Mail services work too.
Project "Structure"
(I've included this section because that's what "professionals" do, but we both know this is barely structured chaos)
The Core Confusion

emailproxy-ui.py: A Python script that pretends to know what it's doing with authentication processes
emailproxy-ui.php: The PHP frontend because I love making myself suffer with PHP 
config/: Where configuration files go to hide from responsibility
logs/: Divided into three categories of depression:
python/: Where Python screams into the void
php/: PHP's personal diary of failures
nginx/: Nginx complaining about both of the above

Helpers

helpers/: Contains useful scripts that will probably break something
update-paths.sh: Updates paths so they all point to the wrong places, but consistently

Getting Started
Cool, I don't care. What can it do and how do I use it?
This abomination helps you authenticate with Microsoft for EmailProxy without manually going through the hell that is copying/pasting authentication URLs to a terminal or running an emailproxy instance for every machine that needs to access them E-Mails. It gives you a web UI that works most of the time.
TL;DR
You can use any old crappy email client again with your companies terrible E-Mail provider (Office 365 / Outlook)
What do you need to get started?

Install Python and PHP on whatever potato you have lying around
Install EmailProxy (how? uhm will make a guide someday TM)
Basic understanding of how EmailProxy works (if you want to use something else than MS email stuff)

Run test instance of it in 69 easy steps (actually just 5)

Update your paths with cd helpers && ./update-paths.sh and edit and server IP's etc. nano config/config.env
Install emailproxy with pipx pipx install emailproxy
Deploy the nginx config somehow and run the backend ./emailproxy-ui.py
Access the web interface at: http://your-server:8080/

And voilà! You now have a test instance to poke arround with.
Features

Web UI: ... Do i need to say more ?
MS Pissing off: Gain ability to use unencrypted mail protocols for the true ms pissing off experience
Log "Management": Totally dont rely on them for the code to work
Path Configuration: Automatically fixes (or breaks) all your paths in one go!

How it Works (If it does)

User enters their email and password in the web UI
The Python script launches a temporary EmailProxy instance
The PHP code pretends to know what it's doing
Magic happens (or errors occur)
Authentication URL is magically extracted and displayed to the user to authenticate
User gets authenticated after pasting his not spoofed and repurposed Thunderbird return URL and gets displayed the correct configs for mail server

Contributing
You can contribute if you want... but I doubt anyone would willingly touch this.
bahahashbdasjhdashjdhj
License
This project is licensed under the "I Can't Believe It Actually Runs" License.
Basically:
- No warranty.
- No responsibility.
- I barely know what I'm doing.
- If this breaks your email, that's on you (in honesty it shouldn't though, most likely will just piss of your E-Mail adminier).
Made with tolerance for Python, love for PHP, and pure disgust for OAuth by T.B ❤️ 🚀
PS: There's minimal commit history because of using questianble language in it which ive ommited. You're welcome.