{"id":22390,"date":"2024-02-15T14:48:40","date_gmt":"2024-02-15T22:48:40","guid":{"rendered":"https:\/\/docs.extraview.com\/v22\/book\/oauth2-email-access-tokens\/"},"modified":"2024-02-15T16:32:15","modified_gmt":"2024-02-16T00:32:15","slug":"oauth2-email-access-tokens","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v22\/oauth2-email-access-tokens\/","title":{"rendered":"OAuth2 Email Access Tokens"},"content":{"rendered":"<p>Third-party email services from Google (Google Email) and Microsoft (Microsoft Azure) require that access to their mail servers is granted by a protocol named OAuth2.&nbsp; This is a token-based mechanism, and ExtraView supports this with automated as opposed to manual access.&nbsp; Given both incoming and outgoing email notifications with ExtraView are automated tasks, the complete process of authentication is handled by the ExtraView administration utility named <b>Access Tokens for 3rd Party Email Services<\/b>.&nbsp; This utility allows the administrator to reach out to the email servers and receive a token that provides access.&nbsp; When the token expires, ExtraView refreshes the token automatically, to ensure continuation of access without manual sign ons to the email servers.&nbsp;<\/p>\n<p>Before configuring the feature, please make sure your Apache Tomcat application server configuration file has the appropriate mount points for the OAuth2 connection.&nbsp; These will be similar to these entries with your instance&#8217;s <code>&lt;instance name&gt;<\/code> and <code>&lt;tomcat service name&gt;<\/code>:<\/p>\n<p><code>JkMount \/&lt;instance name&gt;\/OAuth2 &lt;tomcat service name&gt;<\/code><\/p>\n<p><code>JkMount \/&lt;instance name&gt;\/OAuth2\/* &lt;tomcat service name&gt;<\/code><\/p>\n<p>Familiarity with the Micosoft Azure and Google Email applications is assumed.&nbsp; The following pages document the key steps for both <a href=\"\/microsoft-azure-email-configuration\/\">Microsoft Azure<\/a> and <a href=\"\/google-email-configuration\/\">Google Email<\/a> configurations. Following these is the instruction <a href=\"\/extraview-email-configuration\/\">page to configure the token access within Extraview<\/a>.<\/p>\n<p>This is a summary of the steps:<\/p>\n<ul>\n<li>\n\t\tEnsure that there is a working and correctly configured email service outside of ExtraView<\/li>\n<li>\n\t\tWithin the configuration screen of the remote email service, register ExtraView as an application<\/li>\n<li>\n\t\tWithin the ExtraView <strong>Access Tokens for 3rd Party Email Services<\/strong> screen, find and copy the redirect URI<\/li>\n<li>\n\t\tConfigure the remote email service with the redirect URI and copy the values of the fields that ExtraView requires:<\/p>\n<ul>\n<li>\n\t\t\t\tMicrosoft Azure &#8211; Copy the <strong>Tenant ID<\/strong>, the <strong>Client ID<\/strong> and the <strong>Client Secret<\/strong><\/li>\n<li>\n\t\t\t\tGoogle Email &#8211; Copy the <strong>Client ID<\/strong> and the <strong>Client Secret<\/strong><\/li>\n<\/ul>\n<\/li>\n<li>\n\t\tConfigure the ExtraView administration utility with the authentication information from the remote email service<\/li>\n<li>\n\t\tIf you are using the ExtraView incoming EVMail service, then configure that with the information to connect<\/li>\n<li>\n\t\tConfigure the ExtraView BatchMail service to connect ro the external email service<\/li>\n<li>\n\t\tTest incoming emails from EVMail<\/li>\n<li>\n\t\tTest outgoing notifications, which use the ExtraView BatchMail service.<\/li>\n<\/ul>\n<p>When configuring Batchmail and EVMail, there is an appendix to this guide at <a href=\"\/oauth2-email-mailbox-settings\/\">OAuth2 Email Mailbox Settings<\/a> to assist.<\/p>\n<p style=\"background-color:#eee;padding:10px 0 10px 0\"><strong>Hint<\/strong>: You need to interchange information between ExtraView and the Email service you are configuring.&nbsp; Open two browser windows, one with ExtraView and one with the Email portal so you can easily copy &amp; paste information between them.&nbsp; This simplifies copying the ExtraView URI address to the email service, and the service information such as the<strong> <\/strong>client secret and token ID into ExtraView.<\/p>\n<h3>\n\tUsing Multiple Email Addresses within ExtraView<\/h3>\n<p>ExtraView supports the use of multiple email addresses for different purposes.&nbsp; The key email addresses are each set as behavior settings that may have the same or different values:<\/p>\n<ul>\n<li>\n\t\tAD_HOC_EMAIL_FROM_ADDRESS<\/li>\n<li>\n\t\tEMAIL_ADMINISTRATOR_USER_ID<\/li>\n<li>\n\t\tEMAIL_FROM_USER_ID<\/li>\n<\/ul>\n<p>In addition, individual user&#8217;s email addresses may be used (explicitly or as the <strong>* Current User *<\/strong>) as outgoing email addresses.&nbsp; These each require authentication when used with Microsoft Azure or Google Email.&nbsp; Additional configuration of the external email services can be made to support multiple addresses.<\/p>\n<p>For example, within Microsoft Azure you may permit the user configured within Batchmail to be a <strong>delegated sender<\/strong> for all the other email addresses that you want to use as email <strong>FROM <\/strong>addresses.&nbsp;&nbsp; Alternatively, change the ExtraView configuration to set the <strong>REPLY_TO<\/strong> email header to the individual users, rather than the <strong>FROM <\/strong>header.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Third-party email services from Google (Google Email) and Microsoft (Microsoft Azure) require that access to their mail servers is granted by a protocol named OAuth2.&nbsp; This is a token-based mechanism, and ExtraView supports this with automated as opposed to manual access.&nbsp; Given both incoming and outgoing email notifications with ExtraView are automated tasks, the complete&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_lmt_disableupdate":"","_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-22390","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>OAuth2 Email Access Tokens - 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\/v22\/oauth2-email-access-tokens\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"OAuth2 Email Access Tokens - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"Third-party email services from Google (Google Email) and Microsoft (Microsoft Azure) require that access to their mail servers is granted by a protocol named OAuth2.&nbsp; This is a token-based mechanism, and ExtraView supports this with automated as opposed to manual access.&nbsp; Given both incoming and outgoing email notifications with ExtraView are automated tasks, the complete...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v22\/oauth2-email-access-tokens\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2024-02-16T00:32:15+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\/v22\/oauth2-email-access-tokens\/\",\"url\":\"https:\/\/docs.extraview.com\/v22\/oauth2-email-access-tokens\/\",\"name\":\"OAuth2 Email Access Tokens - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v22\/#website\"},\"datePublished\":\"2024-02-15T22:48:40+00:00\",\"dateModified\":\"2024-02-16T00:32:15+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v22\/oauth2-email-access-tokens\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v22\/oauth2-email-access-tokens\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v22\/oauth2-email-access-tokens\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/docs.extraview.com\/v22\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"OAuth2 Email Access Tokens\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/docs.extraview.com\/v22\/#website\",\"url\":\"https:\/\/docs.extraview.com\/v22\/\",\"name\":\"ExtraView Product Documentation\",\"description\":\"ExtraView Documentation\",\"publisher\":{\"@id\":\"https:\/\/docs.extraview.com\/v22\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/docs.extraview.com\/v22\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/docs.extraview.com\/v22\/#organization\",\"name\":\"ExtraView Corporation\",\"url\":\"https:\/\/docs.extraview.com\/v22\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/docs.extraview.com\/v22\/#\/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\/v22\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"OAuth2 Email Access Tokens - 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\/v22\/oauth2-email-access-tokens\/","og_locale":"en_US","og_type":"article","og_title":"OAuth2 Email Access Tokens - Product Documentation","og_description":"Third-party email services from Google (Google Email) and Microsoft (Microsoft Azure) require that access to their mail servers is granted by a protocol named OAuth2.&nbsp; This is a token-based mechanism, and ExtraView supports this with automated as opposed to manual access.&nbsp; Given both incoming and outgoing email notifications with ExtraView are automated tasks, the complete...","og_url":"https:\/\/docs.extraview.com\/v22\/oauth2-email-access-tokens\/","og_site_name":"Product Documentation","article_modified_time":"2024-02-16T00:32:15+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\/v22\/oauth2-email-access-tokens\/","url":"https:\/\/docs.extraview.com\/v22\/oauth2-email-access-tokens\/","name":"OAuth2 Email Access Tokens - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v22\/#website"},"datePublished":"2024-02-15T22:48:40+00:00","dateModified":"2024-02-16T00:32:15+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v22\/oauth2-email-access-tokens\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v22\/oauth2-email-access-tokens\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v22\/oauth2-email-access-tokens\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.extraview.com\/v22\/"},{"@type":"ListItem","position":2,"name":"OAuth2 Email Access Tokens"}]},{"@type":"WebSite","@id":"https:\/\/docs.extraview.com\/v22\/#website","url":"https:\/\/docs.extraview.com\/v22\/","name":"ExtraView Product Documentation","description":"ExtraView Documentation","publisher":{"@id":"https:\/\/docs.extraview.com\/v22\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.extraview.com\/v22\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/docs.extraview.com\/v22\/#organization","name":"ExtraView Corporation","url":"https:\/\/docs.extraview.com\/v22\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.extraview.com\/v22\/#\/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\/v22\/#\/schema\/logo\/image\/"}}]}},"taxonomy_info":[],"featured_image_src_large":false,"author_info":{"display_name":"carl.koppel","author_link":"https:\/\/docs.extraview.com\/v22\/author\/carl-koppel\/"},"comment_info":0,"_links":{"self":[{"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/pages\/22390","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/comments?post=22390"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/pages\/22390\/revisions"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v22\/wp-json\/wp\/v2\/media?parent=22390"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}