{"id":24208,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/microsoft-azure-email-configuration-1\/"},"modified":"2025-02-14T10:57:03","modified_gmt":"2025-02-14T18:57:03","slug":"microsoft-azure-email-configuration-1","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/","title":{"rendered":"Microsoft Azure Email Configuration"},"content":{"rendered":"<p>OAuth2 authorization with access tokens is supported for Microsoft Exchange (EWS), POP3, IMAP and SMTP connections.<\/p>\n<h4>\n\t<em>Step 1 &#8211; Access the Azure Portal<\/em><\/h4>\n<p>Sign on to your established Microsoft Azure account at <a href=\"\/\/portal.azure.com\/#home\" target=\"_blank\" rel=\"noopener\">https:\/\/portal.azure.com\/#home<\/a>.&nbsp; Your screen will look like this:<\/p>\n<p><img decoding=\"async\" alt=\"\" src=\"\/v25\/extraview-media\/images\/ag\/email\/azure-access.png\" style=\"width: 80%;\" \/><\/p>\n<h4>\n\t<em>Step 2 &#8211; Create the Tenant ID<\/em><\/h4>\n<p>Click the <strong>Manage Azure Active Directory View<\/strong> button.&nbsp; If you have already established your Microsoft email account, you will already have a <strong>Tenant ID<\/strong>, and you should use this.&nbsp; It can be viewed on the <strong>App registration<\/strong> screen.&nbsp; If you need to create a <strong>Tenant ID<\/strong>, click on <strong>Manage Tenants<\/strong> and then <strong>Create<\/strong>.&nbsp; Provide the information required by Microsoft, such as your band <strong>Initial Domain Name<\/strong>.&nbsp; Once configured, you will have a <strong>Tenant ID<\/strong>, as shown in the following screen.&nbsp; If you have not already done so, copy down the value of the <strong>Tenant ID<\/strong> as this is needed when configuring ExtraView.<\/p>\n<p><img decoding=\"async\" alt=\"\" src=\"\/v25\/extraview-media\/images\/ag\/email\/azure-config.png\" style=\"width: 80%;\" \/><\/p>\n<h4>\n\t<em>Step 3 &#8211; Register the Application<\/em><\/h4>\n<p>Now, use the <strong>Add, App registration <\/strong>option to register ExtraView as the application which will be granted access.<\/p>\n<p><img decoding=\"async\" alt=\"\" src=\"\/v25\/extraview-media\/images\/ag\/email\/azure-register.png\" style=\"width: 80%;\" \/><\/p>\n<p>The platform must be <strong>Web <\/strong>and the <strong>Redirect URI <\/strong>must be:<\/p>\n<p><code>https:\/\/yourextraviewurl.com\/evj\/OAuth2?p_action=getTokenReturn&amp;p_option=admin.EmailTokenUtility<\/code><\/p>\n<p>where <code>https:\/\/yourextraviewurl.com\/evj<\/code> is the path to your ExtraView instance.<\/p>\n<h4>\n\t<em>Step 4 &#8211; Copy the Values Needed for ExtraView<\/em><\/h4>\n<p>On the <strong>Overview <\/strong>screen, note down the Application (Client) ID and the Directory (tenant) ID if you have not already done so.&nbsp; These will be required when you configure the ExtraView Token interface.&nbsp;<\/p>\n<h4>\n\t<em>Step 5 &#8211; Configure the Application<\/em><\/h4>\n<p>The next step is to configure the application, and to add a client secret.<\/p>\n<ul>\n<li>\n\t\tOn the Azure navigation menu, choose <strong>App registrations<\/strong><\/li>\n<li>\n\t\tRegister a new application or edit the app you registered in the previous step<\/li>\n<li>\n\t\tAdd a <strong>Client Secret<\/strong><\/li>\n<li>\n\t\tThis will generate the <strong>Client Secret <\/strong>and show its value<\/li>\n<li>\n\t\tImmediately copy the value of the <strong>Cient Secret<\/strong> the clipboard, as you will need this when configuring the ExtraView Token interface.&nbsp; Note that Azure only displays the value of the <strong>Client Secret<\/strong> when first creating it.&nbsp; You will not be able to retrieve this value later.&nbsp; <span style=\"color:#a52a2a;\">Note that it is the value of the <strong>Client Secret<\/strong> and <u>not <\/u>the<strong> Client Secret ID<\/strong> that you need.<\/span><\/li>\n<\/ul>\n<h4>\n\t<em>Step 6 &#8211; Set the Permissions<\/em><\/h4>\n<p>The next step in configuring the API and Office 365 Exchange permissions of the Microsoft Azure application.&nbsp; The specific permissions may depend on your requirements of the email server, but the following provides the permissions you are likely to need.<\/p>\n<p>From the <strong>App registrations <\/strong>screen:<\/p>\n<ul>\n<li>\n\t\tChoose your application<\/li>\n<li>\n\t\tClick on the <strong>API permissions <\/strong>entry in the navigation bar<\/li>\n<li>\n\t\tClick<strong> <\/strong>on <strong>Microsoft Graph<\/strong><\/li>\n<li>\n\t\tSelect <strong>Delegated permissions<\/strong><\/li>\n<li>\n\t\tSearch for and select the following permissions as needed with their checkboxes:<\/p>\n<ul>\n<li>\n\t\t\t\t<strong>OpenId permissions<\/strong>: offline_access<\/li>\n<li>\n\t\t\t\t<strong>IMAP<\/strong>: IMAP.AccessAsUser.All<\/li>\n<li>\n\t\t\t\t<strong>POP<\/strong>: POP.AccessUser.All<\/li>\n<li>\n\t\t\t\t<strong>EWS<\/strong>: EWS.AccessAsUser.All<\/li>\n<li>\n\t\t\t\t<strong>SMTP<\/strong>: SMTP.Send<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>Save the settings. with the <strong>Add<\/strong> button and then click on <strong>Grant admin consent<\/strong> to complete setting the permissions.<\/p>\n<p><img decoding=\"async\" alt=\"\" src=\"\/v25\/extraview-media\/images\/ag\/email\/azure-api.png\" style=\"width: 90%;\" \/><\/p>\n<h4>\n\t<em>Step 7 &#8211; Set the User<\/em><\/h4>\n<p>You will then select a user to use with this application.&nbsp; It is likely the user already exists, but if not, you will create a new user to access the application.&nbsp; From the Azure navigation bar enter the <strong>Users<\/strong> screen and choose an existing user, or create a new one.<\/p>\n<p>The user name used must be the email address(es) configured within ExtraView.&nbsp; For EVMail, this is the address used to sign on and retrieve emails from the Azure server.&nbsp; For BatchMail, this is the email address used to authenticate for outgoing email.<\/p>\n<p>This user must be assigned to the application.&nbsp; From the list of<strong> Enterprise Applications<\/strong>, choose the application you created, <strong>Assign users and groups<\/strong> and then add the user to the application.<\/p>\n<p><img decoding=\"async\" alt=\"\" src=\"\/v25\/extraview-media\/images\/ag\/email\/azure-apps.png\" style=\"width: 90%;\" \/><\/p>\n<h3>\n<p>\t&nbsp;<\/h3>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>OAuth2 authorization with access tokens is supported for Microsoft Exchange (EWS), POP3, IMAP and SMTP connections. Step 1 &#8211; Access the Azure Portal Sign on to your established Microsoft Azure account at https:\/\/portal.azure.com\/#home.&nbsp; Your screen will look like this: Step 2 &#8211; Create the Tenant ID Click the Manage Azure Active Directory View button.&nbsp; If&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24206,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_lmt_disableupdate":"no","_lmt_disable":"","_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"class_list":["post-24208","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v25.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Microsoft Azure Email Configuration - Product Documentation<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Microsoft Azure Email Configuration - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"OAuth2 authorization with access tokens is supported for Microsoft Exchange (EWS), POP3, IMAP and SMTP connections. Step 1 &#8211; Access the Azure Portal Sign on to your established Microsoft Azure account at https:\/\/portal.azure.com\/#home.&nbsp; Your screen will look like this: Step 2 &#8211; Create the Tenant ID Click the Manage Azure Active Directory View button.&nbsp; If...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-14T18:57:03+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/\",\"name\":\"Microsoft Azure Email Configuration - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"dateModified\":\"2025-02-14T18:57:03+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"ExtraView 25\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Administration Guide\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Advanced Menu\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"OAuth2 Email Access Tokens\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/\"},{\"@type\":\"ListItem\",\"position\":6,\"name\":\"Microsoft Azure Email Configuration\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"name\":\"ExtraView Product Documentation\",\"description\":\"ExtraView Documentation\",\"publisher\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\",\"name\":\"ExtraView Corporation\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"contentUrl\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"width\":512,\"height\":512,\"caption\":\"ExtraView Corporation\"},\"image\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Microsoft Azure Email Configuration - Product Documentation","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/","og_locale":"en_US","og_type":"article","og_title":"Microsoft Azure Email Configuration - Product Documentation","og_description":"OAuth2 authorization with access tokens is supported for Microsoft Exchange (EWS), POP3, IMAP and SMTP connections. Step 1 &#8211; Access the Azure Portal Sign on to your established Microsoft Azure account at https:\/\/portal.azure.com\/#home.&nbsp; Your screen will look like this: Step 2 &#8211; Create the Tenant ID Click the Manage Azure Active Directory View button.&nbsp; If...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/","og_site_name":"Product Documentation","article_modified_time":"2025-02-14T18:57:03+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/","name":"Microsoft Azure Email Configuration - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","dateModified":"2025-02-14T18:57:03+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/microsoft-azure-email-configuration-1\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":2,"name":"ExtraView 25","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":3,"name":"Administration Guide","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/"},{"@type":"ListItem","position":4,"name":"Advanced Menu","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/"},{"@type":"ListItem","position":5,"name":"OAuth2 Email Access Tokens","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/"},{"@type":"ListItem","position":6,"name":"Microsoft Azure Email Configuration"}]},{"@type":"WebSite","@id":"https:\/\/docs.extraview.com\/v25\/#website","url":"https:\/\/docs.extraview.com\/v25\/","name":"ExtraView Product Documentation","description":"ExtraView Documentation","publisher":{"@id":"https:\/\/docs.extraview.com\/v25\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/docs.extraview.com\/v25\/#organization","name":"ExtraView Corporation","url":"https:\/\/docs.extraview.com\/v25\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/","url":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","contentUrl":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","width":512,"height":512,"caption":"ExtraView Corporation"},"image":{"@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/"}}]}},"taxonomy_info":[],"featured_image_src_large":false,"author_info":{"display_name":"carl.koppel","author_link":"https:\/\/docs.extraview.com\/v25\/author\/carl-koppel\/"},"comment_info":0,"_links":{"self":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24208","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/comments?post=24208"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24208\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24206"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=24208"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}