xoauther

[xoauther]

A XOAuth2 authenticator for Microsoft Office 365 (and others).

Installing

Install from the command line:

go install git.sr.ht/~konimarti/xoauther

Usage

Run it with a client ID and client secret:

xoauther -id=<client-id> -secret=<client-secret> [-user=<email> | -account=<aerc-acct>]

This will open up your browser so that you can log in to your (o365) account.

When the authentication in the browser was successful, xoauther will receive the authentication code with which it can get the tokens.

The authentication info (access and refresh token) will be saved in the json format in ./secret_token with permission o600.

Integration with [aerc]

xoauther is developed with aerc in mind:

• use -account=<aerc-acct> that matches an account name in aerc to save the refresh token directly in the correct cache directory for aerc to find.

• use -user=<email> to print the source and outgoing config lines for the xoauth2 scheme that can be copy-pasted to your aerc's accounts.conf file.

Contributing

Send patches to the mailing list.

License

MIT, see LICENSE.

Copyright (C) 2024 Koni Marti