Jak nastavit Mutt jako e-mailového klienta služby Microsoft 365

Podporovaným e-mailovým klientem služby Microsoft 365 (M365) je Outlook v těžké nebo webové variantě. Pokud však patříte mezi milovníky programu Mutt a jste ochotni převzít zodpovědnost za použití nepodporovaného řešení, můžete shledat následující rady jako užitečné. Tyto rady vznikly na základě stránky https://www.vanormondt.net/~peter/blog/2021-03-16-mutt-office365-mfa.html, tam uvedené informace jsou zde upřesněny a upraveny pro konkrétní podmínky na MFF.

Základní prerekvizity

1. Nainstalovaný Mutt. V závislosti na typu své linuxové distribuce můžete z příkazového řádku Mutt nainstalovat buď jako sudo yum install mutt (RedHat, Oracle, ...) nebo sudo apt-get install mutt (Debian, Ubuntu, ...). Musíte mít nainstalovanou verzi minimálně 2.0.0. Jakou verzi máte nainstalovanou zjistíte pomocí mutt --version.
2. Nainstalovaný Python, verze minimálně 3.7. V závislosti na vámi používané distribuci lze Python nainstalovat pravděpodobně jako sudo apt-get install python3 nebo sudo yum install python. Verzi nainstalovaného Pythonu prověříte pomocí python --version, případně python3 --version.
3. Nainstalované gpg. Zda máte gpg nainstalované můžete prověřit např. pomocí gpg --version (použitelná je libovolná verze), v případě potřeby doinstalujte pomocí sudo yum install gpg nebo sudo apt-get install gpg.
4. Existující pár (soukromý/veřejný) vlastních klíčů v gpg. Zda takový pár již máte zjistíte pomocí gpg --list-keys. Pokud takový pár zatím nemáte, vytvořte si jej pomocí gpg --full-gen-key (vyžaduje zodpovězení několika otázek). Každopádně je třeba si všimnout resp. zapamatovat, jakou jste ve svém USER-ID (uid) uvedli e-mailovou adresu, tu budete potřebovat v jednom z následujících kroků.

Zprovoznění ověřování OAuth2

Přístup do systému Microsoft 365 vyžaduje ověření metodou OAuth2. To zprovozníte následovně:

1. Otevřete si na svém počítači s Linuxem terminálové okno, ve kterém běží shell.
2. Proveďte náledující příkazy:
   
   mkdir ~/.mutt-oauth2
wget -O ~/.mutt-oauth2/mutt_oauth2.py https://www.mff.cuni.cz/data/nodes/54589/mutt_oauth2.py
cd ~/.mutt-oauth2
chmod +x mutt_oauth2.py
   
   Upravte v textovém editoru soubor ~/.mutt-oauth2/mutt_oauth2.py tak, že řetězec YOUR_GPG_IDENTITY (vyskytující se na řádku 48) nahradíte e-mailovou adresou, která je součástí vašeho USER-ID v gpg (viz sekce Prerekvizity výše).
3. Spusťte příkaz ./mutt_oauth2.py encrypted_token --verbose --authorize. Budete vyzváni k zodpovězení několika otázek. Na otázku OAuth2 registration  odpověze microsoft, na otázku Preferred OAuth2 flow odpovězte localhostauthcode. Jako Account e-mail address vyplňte svoji e-mailovou adresu v systému Microsoft 365 a jako Account identity vyplňte svoje UKČO (číslo na průkazu zaměstnance pod fotkou) následované @cuni.cz. Dialog může vypadat např. následovně:
   
   Available app and endpoint registrations: google microsoft
OAuth2 registration: microsoft
Preferred OAuth2 flow ("authcode" or "localhostauthcode" or "devicecode"): localhostauthcode
Account e-mail address: pavel.zakouril@matfyz.cuni.cz
Account identity (eg. 12345678@cuni.cz): 68082596@cuni.cz
   
   Následně se zobrazí odkaz, který je třeba otevřít ve webovém prohlížeči. V něm se zobrazí přihlašovací stránka CAS, do které je třeba se úspěšně přihlásit. Pokud se vše podaří, bude výsledkem použitelný soubor ~/.mutt-oauth2/encrypted_token.
4. Výsledek můžete prověřit pomocí ./mutt_oauth2.py --verbose --test encrypted_token. Pokud se zobrazí řádky
   IMAP authentication succeeded
POP authentication succeeded
SMTP authentication succeeded
   vše je v pořádku a můžete postupit k samotné konfiguraci programu Mutt.

Konfigurace Mutt

Konfiguraci samotného programu Mutt je třeba nastavit v textovém souboru muttrc, který se standardně nachází přímo v domácím adresáři uživatele (~/.muttrc) nebo ve zvláštním adresáři s konfigurací programu Mutt (~/.mutt/muttrc). Ukázková konfigurace pro konkrétní uživatelský účet je na následující obrázku, který současně funguje jako odkaz na soubor, který si můžete stáhnout a využít jako základ svého vlastního muttrc.

Poté, co nastavíte soubor muttrc, již můžete spustit Mutt a připojit se do své mailové schránky v systému Microsoft 365.

Závěrem ještě jednou upozorňujeme, že e-mailovým klientem podporovaným ze strany fakultní správy sítě je Microsoft Outlook, nikoli Mutt. Pokud Mutt používáte, činíte tak na vlastní nebezpečí. Správa sítě nemůže ručit za ztrátu dat a podobné problémy, které by případně byly dávány do souvislosti s radami uvedenými na této stránce, jakkoli jsou tyto rady sepsány v dobré víře.