Outlook client and server API compatibility of the Phishing Report Button
The Outlook add-in makes use of Exchange Web Services (EWS), the Outlook REST API or Graph API in order to retrieve data from the user's Outlook mailbox.
Below you can find the availability of the EWSm REST API and Graph API for all supported Exchange Server / Outlook client combinations and their impact on forwarding.
We recommend the use of Graph API, but it is not supported in every setup. The REST API is no longer being developed by Microsoft and has been discontinued. The use of REST API is not recommended in the online/hybrid environment; in the on-premise environment, REST API has a wider range of functions compared to EWS. The limitations are listed further down in the article.
Exchange On-Premises
For all Exchange On-Premises servers (no hybrid deployment) we can only support EWS.
Exchange Online/Hybrid Server Deployments
For Exchange Online and hybrid deployments of Exchange Servers, the following client/server combinations for EWS, Graph API and REST API are available.
Exchange 2013 is not supported
Windows
Windows | Windows Outlook clients | |||||
MS 3651 | Outlook 2021 | Outlook 2019 | Outlook 2016 | Outlook 2013 | ||
Server | Exchange Online | All | All | All - Graph MSAL PopUp3 | EWS | EWS |
Exchange 20192 | All | All | All- Graph MSAL PopUp3 | EWS | EWS | |
Exchange 20162 | EWS/REST | EWS/REST | EWS/REST | EWS | EWS | |
Exchange On-Premise | EWS | EWS | EWS | EWS | EWS | |
macOS
macOS | macOS Outlook clients | ||
Office on Mac (classic UI) | Office on Mac (new UI) | ||
Server | Exchange Online | All | All |
Exchange 20192 | All | All | |
Exchange 20162 | EWS/REST | EWS/REST | |
Exchange On-Premise | EWS | EWS | |
Other
Other | Outlook clients | |||||
Android App | iOS App | Web Browser (Exchange Online) | Web Browser (On-Premise) | Mobile Browser | ||
Server | Exchange Online | Graph/REST | Graph/REST | All | EWS/REST | not supported |
Exchange 20192 | Graph/REST | Graph/REST | All | EWS/REST | not supported | |
Exchange 20162 | REST | REST | EWS/REST | EWS/REST | not supported | |
Exchange On-Premise | not supported | not supported | n/a | EWS/REST | not supported | |
1 Microsoft Office 365 subscription
2 connected to Exchange Online (hybrid deployment)
3 Graph MSAL PopUp: Every time a user opens the Phishing Report Button, the user will see a flash of a MSAL pop-up.
Outlook client and server API compatibility of Reporting Nudges
Operating system | Office version | Edge WebView2 (Chromium-based) installed? | Reporting Nudges |
|---|---|---|---|
Android | Any | Not applicable | Yes |
Any | Office web | Not applicable | Yes, if not opened on IE11 |
iOS | Any | Not applicable | Yes, if not opened on IE11 |
Mac | Any | Not applicable | Yes |
Windows 7, 8.1, 10, 11 | Non-subscription Office 2013 to Office 2019 | Does not matter | Not supported |
Windows 10, 11 | Non-subscription Office 2021 or later | Yes | Yes |
Windows 7 | Microsoft 365 | Does not matter | Not supported |
Windows 8.1, Windows 10 ver. < 1903 | Microsoft 365 | No | Not supported |
Windows 10 ver. >= 1903, Windows 11 | Microsoft 365 ver. < 16.0.11629 | Does not matter | Not supported |
Windows 10 ver. >= 1903, Windows 11 | Microsoft 365 ver. >= 16.0.11629 and < 16.0.13530.204242 | Does not matter | Yes |
Windows 10 ver. >= 1903, Windows 11 | Microsoft 365 ver. >= 16.0.13530.204242 | No | Yes |
Windows 8.1, 10, 11 | Microsoft 365 ver. >= 16.0.13530.204242 | Yes | Yes |
Note: This table includes information on the compatibility of Reporting Nudges with different operating systems, office version, and whether Edge WebView2 (Chromium-based) is installed. The entries "Not applicable" and "Does not matter" indicate that a particular criterion is not relevant to a specific combination of operating system and office version.
Differences in forwarding via EWS and REST/Graph API
Forwarding can be done in “.eml” or “split” mode. Depending on the available API and the configured forwarding mode, the following files are forwarded to the customer’s email addresses:
| via Rest / Graph | via EWS |
.eml mode |
|
|
Split mode |
|
|
4 If the email contains attachments