{"id":24209,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/extraview-email-configuration-1\/"},"modified":"2025-02-14T10:57:46","modified_gmt":"2025-02-14T18:57:46","slug":"extraview-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\/extraview-email-configuration-1\/","title":{"rendered":"ExtraView Email Configuration"},"content":{"rendered":"

Enter the administration utility named Access Tokens for 3rd Party Email Services<\/b> on the Advanced<\/strong> administration menu.<\/p>\n

This screen will be similar to:<\/p>\n

\"\"<\/p>\n

Note that this screen displays the redirect URI that is required by the email service you are configuring.  This redirect is used to direct the email service back to ExtraView automatically once it has successfully authenticated the access.  You can copy this URI to your clipboard so that you can paste it into the email service configuration screen.<\/p>\n

Click on the button Add a new email token<\/strong>.<\/p>\n

\"\"<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n
\n\t\t\t\tField<\/b><\/td>\n\n\t\t\t\tRequired<\/strong><\/td>\n\n\t\t\t\tValue<\/b><\/td>\n<\/tr>\n
\n\t\t\t\tEmail Token Name<\/td>\n\n\t\t\t\tYes<\/td>\n\n\t\t\t\tThis is an arbitrary name for the token you are creating,  A recommended name is the email address which you use for the EVMail service<\/td>\n<\/tr>\n
\n\t\t\t\tEmail Token Type<\/td>\n\n\t\t\t\tYes<\/td>\n\n\t\t\t\tSelect from Microsot Azure and Google Gmail<\/td>\n<\/tr>\n
\n\t\t\t\tEmail Address<\/td>\n\n\t\t\t\tNo<\/td>\n\n\t\t\t\tThis field is for reference only.  When you have multiple mailboxes configured, it is useful on this screen to view which mailbox this connection is used with<\/td>\n<\/tr>\n
\n\t\t\t\tTenant ID<\/td>\n\n\t\t\t\tYes for Microsoft Azure<\/td>\n\n\t\t\t\tPaste or copy the Tenant ID<\/strong> that you received from the external email service,  This is only required for Microsoft Azure<\/td>\n<\/tr>\n
\n\t\t\t\tClient ID<\/td>\n\n\t\t\t\tYes<\/td>\n\n\t\t\t\tPaste or copy the Client ID<\/strong> that you received from the external email service<\/td>\n<\/tr>\n
\n\t\t\t\tClient Secret<\/td>\n\n\t\t\t\tYes<\/td>\n\n\t\t\t\tPaste or copy the Client Secret<\/strong> that you received from the external email service<\/td>\n<\/tr>\n
\n\t\t\t\tScope<\/td>\n\n\t\t\t\tYes<\/td>\n\n\t\t\t\tThe scope defines the range of permissions that ExtraView is requesting.  Note that permissions for offline working are added automatically.  More than one scope can be requested.  Simply concatenate the requests with a space between each.<\/p>\n

\t\t\t\tThe entire scope (that you can copy and paste into ExtraView) is:<\/p>\n

\t\t\t\thttps:\/\/outlook.office.com\/SMTP.Send https:\/\/outlook.office.com\/EWS.AccessAsUser.All https:\/\/outlook.office.com\/IMAP.AccessAsUser.All https:\/\/outlook.office.com\/POP.AccessAsUser.All<\/code><\/p>\n

\t\t\t\tYou may remove unneeded permissions from the Scope.  The following is a guide as to how each scope is utilized:<\/p>\n

\t\t\t\tMicrosoft Exchange<\/strong><\/em>
\n\t\t\t\t  https:\/\/outlook.office.com\/EWS.AccessAsUser.All
\n\t\t\t\t  https:\/\/outlook.office.com\/Mail.ReadWrite
\n\t\t\t\t  https:\/\/outlook.office.com\/Mail.Send
\n\t\t\t\t  https:\/\/outlook.office.com\/EWS.AccessAsUser.All
\n\t\t\t\t  https:\/\/outlook.office.com\/SMTP.Send<\/p>\n

\t\t\t\tMicrosoft IMAP<\/strong><\/em>
\n\t\t\t\t  https:\/\/outlook.office.com\/IMAP.AccessAsUser.All<\/p>\n

\t\t\t\tMicrosoft POP3<\/strong><\/em>
\n\t\t\t\t  https:\/\/outlook.office.com\/POP.AccessAsUser.All<\/p>\n

\t\t\t\tMicrosoft SMTP<\/strong><\/em>
\n\t\t\t\t  https:\/\/outlook.office.com\/POP.AccessAsUser.All<\/td>\n<\/tr>\n

\n\t\t\t\tAuthorization URL<\/nobr><\/td>\n\n\t\t\t\tYes<\/td>\n\n\t\t\t\tThis is the URL of the authorization server.<\/p>\n
    \n
  • \n\t\t\t\t\t\tFor Microsoft Azure connections this value is https:\/\/login.microsoftonline.com\/<\/li>\n
  • \n\t\t\t\t\t\tFor Google Email connections this value is https:\/\/accounts.google.com\/<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
\n\t\t\t\tAccess Token URL<\/td>\n\n\t\t\t\tYes for Google Email<\/td>\n\n\t\t\t\tFor Google Email this is the URL of the authorization server.  This value is https:\/\/oauth2.googleapis.com\/. Microsoft uses the same URL as the authorization URL<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Once you have added the token using the Add New Token<\/strong> button, click the Get Email Token<\/strong> button. <\/p>\n

    \n
  • \n\t\tWith Google GMail, on the first occasion that you get a token, you will be prompted to authorize the app permissions<\/li>\n
  • \n\t\tWith Microsoft Azure, if the admin Grants admin consent<\/strong> to any permissions associated with the app, the user is not prompted to authorize the app.  If the mail admininistrator does not grant admin consent to the permissions, the app cannot access the mailboxes using the token.<\/li>\n<\/ul>\n

    ExtraView redirects the administrator to the sign on screen for the remote email service.  After verifying your identity, return to ExtraView and refresh the Access Tokens for 3rd Party Email Services<\/b> screen.<\/p>\n

    You will see the newly configured token.  The screen will show the token details, together with the expiry time of the token, and when it was last updated.<\/p>\n

    \"\"<\/p>\n

    \n\t <\/h3>\n

    \n\tConfiguring EVMail<\/h3>\n

    Within the EVMail task properties, there is a section which refers to the OAuth2 token to be used.  This looks like:<\/p>\n

    # The MAILBOX_AUTH_TYPE default is PASSWORD.  Alter the value of the property to OAUTH2 for OAuth2 authentication
    \n\t# MAILBOX_AUTH_TYPE = PASSWORD | OAUTH2
    \n\t# MAILBOX_EMAIL_TOKEN_NAME is the name of the OAUTH2 token that should be used when MAILBOX_AUTH_TYPE = OAUTH2.  
    \n\t# The token is added under Admin \/ Advanced \/ Access Tokens for 3rd Party Email Services
    \n\t# MAILBOX_EMAIL_TOKEN_NAME = <name of the token in the admin utility that creates and maintains the email tokens><\/code><\/p>\n

    \tUncomment and alter the MAILBOX_AUTH_TYPE<\/code> to OAUTH2<\/code>.  Now set the value of the MAILBOX_EMAIL_TOKEN_NAME<\/code> property to the name of the token you created in the field Email Token Type<\/strong>.<\/p>\n

    If EVMail was previously running, stop and restart the task to load the new settings.<\/p>\n

    \n\t <\/h3>\n

    \n\tConfiguring BatchMail<\/h3>\n

    .Similar alterations to the BatchMail task properties need to be made as to the changes to the EVMail task, although the propertty names are a little different.<\/p>\n

    # The MAIL_AUTH_TYPE default is PASSWORD.  Alter the value of the property to OAUTH2 for OAuth2 authentication
    \n\t# MAIL_AUTH_TYPE = PASSWORD | OAUTH2
    \n\t# MAIL_TOKEN_NAME is the name of the OAUTH2 token that should be used when MAILBOX_AUTH_TYPE = OAUTH2.  
    \n\t# The token is added under Admin \/ Advanced \/ Access Tokens for 3rd Party Email Services
    \n\t# MAIL_TOKEN_NAME = <name of the token in the admin utility that creates and maintains the email tokens><\/code><\/p>\n

    \tUncomment and alter the MAIL_AUTH_TYPE<\/code> to OAUTH2<\/code>.  Now set the value of the MAIL_TOKEN_NAME<\/code> property to the name of the token you created in the field Email Token Type<\/strong>.<\/p>\n

     <\/p>\n","protected":false},"excerpt":{"rendered":"

    Enter the administration utility named Access Tokens for 3rd Party Email Services on the Advanced administration menu. This screen will be similar to: Note that this screen displays the redirect URI that is required by the email service you are configuring.  This redirect is used to direct the email service back to ExtraView automatically once…<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24206,"menu_order":2,"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-24209","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"\nExtraView 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\/extraview-email-configuration-1\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"ExtraView Email Configuration - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"Enter the administration utility named Access Tokens for 3rd Party Email Services on the Advanced administration menu. This screen will be similar to: Note that this screen displays the redirect URI that is required by the email service you are configuring.  This redirect is used to direct the email service back to ExtraView automatically once...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/extraview-email-configuration-1\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-14T18:57:46+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=\"5 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\/extraview-email-configuration-1\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/extraview-email-configuration-1\/\",\"name\":\"ExtraView 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:46+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/extraview-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\/extraview-email-configuration-1\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/extraview-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\":\"ExtraView 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":"ExtraView 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\/extraview-email-configuration-1\/","og_locale":"en_US","og_type":"article","og_title":"ExtraView Email Configuration - Product Documentation","og_description":"Enter the administration utility named Access Tokens for 3rd Party Email Services on the Advanced administration menu. This screen will be similar to: Note that this screen displays the redirect URI that is required by the email service you are configuring.  This redirect is used to direct the email service back to ExtraView automatically once...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/extraview-email-configuration-1\/","og_site_name":"Product Documentation","article_modified_time":"2025-02-14T18:57:46+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"5 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\/extraview-email-configuration-1\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/extraview-email-configuration-1\/","name":"ExtraView 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:46+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/extraview-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\/extraview-email-configuration-1\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/administration-guide-1\/advanced-menu-1\/oauth2-email-access-tokens-1\/extraview-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":"ExtraView 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\/24209","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=24209"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24209\/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=24209"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}