summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBence Ferdinandy <bence@ferdinandy.com>2024-01-16 22:25:37 +0100
committerRobin Jarry <robin@jarry.cc>2024-01-19 23:34:10 +0100
commitd78c24053adc9a09950b278ed38bf626fe16119e (patch)
tree0f0e4c3bdcd1166443dca170175f677ef397b699
parent5676ad356fc68e100644f0b8fd2b4bd3f5d4fb5f (diff)
downloadaerc-d78c24053adc9a09950b278ed38bf626fe16119e.tar.gz
aerc-d78c24053adc9a09950b278ed38bf626fe16119e.zip
microsoft: add more info to davmail authorization
Add some info about how to do auhtorization when you are for example on a remote computer. Also remove unnecessary password lines from config. Davmail will not need the password. Signed-off-by: Bence Ferdinandy <bence@ferdinandy.com> Acked-by: Robin Jarry <robin@jarry.cc>
-rw-r--r--providers/microsoft.md21
1 files changed, 15 insertions, 6 deletions
diff --git a/providers/microsoft.md b/providers/microsoft.md
index 71e4cfaf..bf11954b 100644
--- a/providers/microsoft.md
+++ b/providers/microsoft.md
@@ -127,9 +127,7 @@ server as your mail server inside aerc, and you're set. Of course, the server
being in the same machine as the client, you don't need any security:
```ini
source = imap+insecure://you@email.com@localhost:1143
-source-cred-cmd = pass you@email.com
outgoing = smtp+insecure://you@email.com@localhost:1025
-outgoing-cred-cmd = pass you@email.com
smtp-starttls = no
```
@@ -142,16 +140,26 @@ IMAPAccount o365-davmail
Host localhost
Port 1143
User you@email.com
- PassCmd "pass email.com/you@email.com"
+ Pass ""
SSLType None
AuthMech LOGIN
```
Finally, if your sysadmins are even stricter, they might even straightaway
-forbid the use of different applications to access mail. If you find yourself in
-that situation, you need to instruct Davmail to mask itself as the very fine
+forbid the use of different applications to access mail. If you find yourself
+in that situation, you need to instruct Davmail to mask itself as the very fine
Outlook client, as explained [elsewhere][13]. In that case, some reports
-indicate that you need to use Davmail's `O365Manual` login type.
+indicate that you need to use Davmail's `O365Manual` login type. When using
+`O365Manual` davmail will provide you with a link where you can authorize your
+account using the usual procedure you would use to log in. The authorization
+will end by opening a link with your access token in it (if the page doesn't
+open, look under developer tools -> console in your browser). Since the link
+and the access token are not tied to the computer where you are running
+`davmail` if you are unable to authorize on your current computer (e.g. you are
+running davmail in a headless environment), you can either copy the link to
+a different machine and copy the token back. Alternatively, [carbonyl][14] runs
+chromium in a terminal, complete with the necessary javascript capabilities to
+access the authorization page on a headless machine.
[1]: https://support.microsoft.com/en-us/office/pop-imap-and-smtp-settings-8361e398-8af4-4e97-b147-6c6c4ac95353
@@ -167,3 +175,4 @@ indicate that you need to use Davmail's `O365Manual` login type.
[11]: https://github.com/gaoDean/oauthRefreshToken
[12]: https://davmail.sourceforge.net/
[13]: https://github.com/mguessan/davmail/issues/321#issuecomment-1867072418
+[14]: https://github.com/fathyb/carbonyl