inbuxa/inbuxa-migrate
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Added EWS details

Browse Source
This commit is contained in:
Stalwart Official
2026-09-30 14:16:11 +02:00
parent 42f7c87911
commit 3a04a6e1fd
1 changed files with 18 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+18 -8
View File
@@ -24,14 +24,22 @@
<br> <br>
<img align="right" src="assets/importer-exporter.jpg" alt="He's an importer-exporter." hspace="20" vspace="6"> <table>
<tr>
<td>
- Jerry: Well, what does *he* do? - Jerry: Well, what does **he** do?
- George: He's an importer. - George: He's an importer.
- Jerry: Just imports, no exports? - Jerry: Just imports, no exports?
- George: He's an importer/exporter, okay? - George: He's an **importer/exporter**, okay?
</td>
<td>
<img src="assets/importer-exporter.jpg" alt="He's an importer-exporter.">
</td>
</tr>
</table>
<br clear="all">
&nbsp; &nbsp;
## About ## About
@@ -51,8 +59,8 @@ Because the archive is a self-contained SQLite file that fully describes one acc
- ManageSieve - ManageSieve
- Maildir++ - Maildir++
- Google Takeout - Google Takeout
- Microsoft Exchange via EWS (*experimental*) - Microsoft Exchange Server (on-premises) via EWS
- Microsoft Exchange Online via Graph (*experimental*) - Microsoft Exchange Online via Graph
- **One target protocol:** JMAP, with type-by-type stateless re-matching on every run. - **One target protocol:** JMAP, with type-by-type stateless re-matching on every run.
- **Convergent:** Re-running an interrupted import or export picks up where it left off without bookkeeping flags. - **Convergent:** Re-running an interrupted import or export picks up where it left off without bookkeeping flags.
- **Multi-threaded, no async runtime:** Blocking HTTP with per-server concurrency caps respected automatically. - **Multi-threaded, no async runtime:** Blocking HTTP with per-server concurrency caps respected automatically.
@@ -246,7 +254,9 @@ vandelay import exchange-ews \
<ARCHIVE> <ARCHIVE>
``` ```
Imports a mailbox via EWS, against either on-prem Exchange Server or Exchange Online. Autodiscover is used when `--url` is omitted (a `--mailbox` SMTP address is then required). Supports Basic, pre-acquired bearer, interactive device-code OAuth, and app-only client-credentials OAuth. Imports a mailbox via EWS from an on-premises Exchange Server. Autodiscover is used when `--url` is omitted (a `--mailbox` SMTP address is then required). Supports Basic, pre-acquired bearer, interactive device-code OAuth, and app-only client-credentials OAuth.
For Exchange Online, use `exchange-graph` instead. Microsoft is retiring EWS in Exchange Online: from 1 October 2026 it is blocked unless a tenant administrator sets `EwsEnabled` to `True` and adds the client id to `EwsAllowedAppIDs`, and on 1 April 2027 it is switched off for every tenant. On-premises Exchange Server is not affected.
#### Microsoft Exchange (Graph) #### Microsoft Exchange (Graph)
@@ -261,7 +271,7 @@ vandelay import exchange-graph \
<ARCHIVE> <ARCHIVE>
``` ```
Imports a mailbox from Exchange Online via Microsoft Graph. Without `--access-token`, the interactive device-code flow is used. `public-folders` is rejected here (use `exchange-ews` instead). Imports a mailbox from Exchange Online via Microsoft Graph. Without `--access-token`, the interactive device-code flow is used. `public-folders` is rejected here: Graph does not expose public folders, so they can only be imported with `exchange-ews`, which for Exchange Online is subject to the retirement described above.
### Export ### Export