{"id":20443,"date":"2022-03-25T13:45:52","date_gmt":"2022-03-25T12:45:52","guid":{"rendered":"https:\/\/help.openbee.com\/open-bee-portal\/administrators-guide\/general-setup\/office-365-and-g-suite-smtp-configuration\/"},"modified":"2026-05-13T09:40:19","modified_gmt":"2026-05-13T07:40:19","slug":"office-365-and-g-suite-smtp-configuration","status":"publish","type":"page","link":"https:\/\/help.openbee.com\/en\/open-bee-portal\/administrators-guide\/general-setup\/office-365-and-g-suite-smtp-configuration\/","title":{"rendered":"Office 365 and G Suite SMTP configuration"},"content":{"rendered":"<div id=\"main-content\" class=\"wiki-content group\">\n<p>Starting with version 6.10.3, Open Bee\u2122 Portal allows email to be sent via a Google or Office 365 SMTP relay.<\/p>\n<p>This page describes the settings that must be applied to use one of these SMTP relays.<\/p>\n<h2 id=\"ConfigurationSMTPOffice365etGSuite-GmailouGSuite\">Gmail or G Suite<\/h2>\n<h3 id=\"ConfigurationSMTPOffice365etGSuite-Pr\u00e9requis\"><strong>Prerequisites  <\/strong><\/h3>\n<p>A Gmail or G suite account with two-step authentication enabled. This option is activated from the &#8220;Sign in to your account&#8221; section of your Google Account (<a class=\"external-link\" href=\"https:\/\/myaccount.google.com\/security#signin\" rel=\"nofollow\">https:\/\/myaccount.google.com\/security#signin<\/a> ). For a G Suite account, the administrator must first make this option available (Admin &gt; Security &gt; Basic Settings)  <\/p>\n<h3 id=\"ConfigurationSMTPOffice365etGSuite-Cr\u00e9ationd'unmotdepassed'application\">Creating an app password<\/h3>\n<p>Set an app password that will be used by Open Bee\u2122 Portal, log in to your account, and send emails.<\/p>\n<p>To set a password<\/p>\n<ul>\n<li>Go to your Google account:<a class=\"external-link\" href=\"https:\/\/myaccount.google.com\/u\/0\/apppasswords\" rel=\"nofollow\">https:\/\/myaccount.google.com\/apppasswords<\/a><\/li>\n<li>Add an app. Choose &#8220;Email&#8221;, then &#8220;Other&#8221; and enter Open Bee\u2122 Portal as the name. <\/li>\n<li>Write down the password provided.<\/li>\n<\/ul>\n<p>Google documentation on the subject: <a class=\"external-link\" href=\"https:\/\/support.google.com\/accounts\/answer\/185833?hl=fr\" rel=\"nofollow\">https:\/\/support.google.com\/accounts\/answer\/185833?hl=fr<\/a><\/p>\n<h3 id=\"ConfigurationSMTPOffice365etGSuite-Configurationd'true\">Setting up Open Bee\u2122 Portal<\/h3>\n<p>Then set up Open Bee\u2122 Portal as follows:<\/p>\n<ul style=\"list-style-type: square;\">\n<li>SMTP Server: smtp.gmail.com<\/li>\n<li>Security: TLS<\/li>\n<li>Port: 587<\/li>\n<li>SMTP authentication required: checked<\/li>\n<li>Username: Your Gmail or G Suite email address<\/li>\n<li>Password: The app password provided by Google<\/li>\n<li>Sender: Your Gmail or G Suite email address<\/li>\n<\/ul>\n<h2> <\/h2>\n<h2 id=\"ConfigurationSMTPOffice365etGSuite-Office365\">Microsoft 365<\/h2>\n<\/div>\n<h3>Authenticating using basic authentication<\/h3>\n<div id=\"main-content\" class=\"wiki-content group\">\n<h3 id=\"ConfigurationSMTPOffice365etGSuite-Pr\u00e9requis.1\"><strong>Prerequisites<\/strong><\/h3>\n<p>A Microsoft 365 email account.<\/p>\n<p><span class=\"nolink\">More information about sending emails by SMTP via Office 365: <a class=\"external-link\" href=\"https:\/\/support.office.com\/fr-fr\/article\/comment-configurer-un-appareil-ou-une-application-multifonction-pour-envoyer-du-courrier-%C3%A9lectronique-%C3%A0-l-aide-d-office-365-69f58e99-c550-4274-ad18-c805d654b4c4\" rel=\"nofollow\">https:\/\/support.office.com\/fr-fr\/article\/comment-configurer-un-appareil-ou-une-application-multifonction-pour-envoyer-du-courrier-%C3%A9lectronique-%C3%A0-l-aide-d-office-365-69f58e99-c550-4274-ad18-c805d654b4c4<\/a><\/span><\/p>\n<h2> <\/h2>\n<h3 id=\"ConfigurationSMTPOffice365etGSuite-Configurationd'true.1\">Setting up Open Bee\u2122 Portal<\/h3>\n<p>Then set up Open Bee\u2122 Portal as follows:<\/p>\n<ul>\n<li>SMTP server: smtp.office365.com<\/li>\n<li>Security: TLS<\/li>\n<li>Port: 587<\/li>\n<li>SMTP authentication required: checked<\/li>\n<li>Username: Your Office 365 email address<\/li>\n<li>Password: the password for your Office 365 account<\/li>\n<li>Sender: Your Office 365 email address<\/li>\n<\/ul>\n<\/div>\n<h3>Authenticating using OAuth2 authentication<\/h3>\n<h3 id=\"ConfigurationSMTPOffice365etGSuite-Pr\u00e9requis.1\"><strong>Prerequisites<\/strong><\/h3>\n<ul>\n<li>A valid Microsoft 365 subscription that includes Exchange Online and an active Exchange mailbox.<\/li>\n<\/ul>\n<blockquote>\n<p><strong>Attention: <\/strong>Aliases (proxy addresses) and shared mailboxes can&#8217;t be used to connect through OAuth2. Please use a primary address. <\/p>\n<\/blockquote>\n<ul>\n<li data-start=\"194\" data-end=\"378\">Before connecting an email address through Azure, it is necessary to ensure that the user account has the appropriate permissions to use <strong data-start=\"362\" data-end=\"375\">the SMTP AUTH<\/strong> protocol.<\/li>\n<\/ul>\n<h4 data-start=\"380\" data-end=\"403\">  Step to check:<\/h4>\n<p data-start=\"404\" data-end=\"508\">  The <strong data-start=\"413\" data-end=\"449\">SmtpClientAuthenticationDisabled<\/strong> option must be set to <strong data-start=\"472\" data-end=\"481\">false<\/strong> for the account.<\/p>\n<h4 data-start=\"510\" data-end=\"525\">  Why?<\/h4>\n<p data-start=\"526\" data-end=\"693\">  This configuration allows the account to use SMTP authentication.<\/p>\n<p data-start=\"526\" data-end=\"693\">  Essential for sending emails from external applications or integrated services.<\/p>\n<h3>Registering the app in Azure AD<\/h3>\n\n<ul class=\"wp-block-list\">\n<li>Log in to <a href=\"https:\/\/portal.azure.com\/\">portal.azure.com<\/a><\/li>\n\n\n\n<li>Navigate to<strong> the Microsoft Entra<\/strong><em> <\/em><strong>ID<\/strong> service <em> (formerly Azure Active Directory)<\/em><\/li>\n\n\n\n<li>Then click on the<strong> Application Registrations<\/strong> entry located in the <strong>Manage<\/strong> submenu on the left panel<\/li>\n<\/ul>\n\n<p><\/p>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-2_stmp-translated-1024x471.png\" alt=\"\" class=\"wp-image-24475\"\/><\/figure>\n\n<p><\/p>\n\n<ul class=\"wp-block-list\">\n<li>Click on <strong>&#8220;New registration&#8221;<\/strong><\/li>\n<\/ul>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-3-translated-1024x468.png\" alt=\"\" class=\"wp-image-24478\"\/><\/figure>\n\n<ul class=\"wp-block-list\">\n<li>Fill in:\n<ul class=\"wp-block-list\">\n<li><strong>App Name:<\/strong> The name of your choice<\/li>\n\n\n\n<li><strong>Supported account type: <\/strong>Accounts in an Organization Directory<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-22_stmp-translated-1024x518.png\" alt=\"\" class=\"wp-image-24568\"\/><\/figure>\n\n<ul class=\"wp-block-list\">\n<li>Click on the <strong>&#8220;Register&#8221;<\/strong> button <\/li>\n\n\n\n<li>From the newly created application, click on the <strong>Authentication<\/strong> entry in the <strong>Manage<\/strong> submenu on the left panel<\/li>\n<\/ul>\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-24-1-translated.png\" alt=\"\" class=\"wp-image-24577\"\/><\/figure>\n\n<ul class=\"wp-block-list\">\n<li>Click on <strong>&#8220;Add a platform&#8221;<\/strong> then <strong>Web<\/strong> Application in the menu on the right<\/li>\n<\/ul>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-5_stmp-translated-1024x486.png\" alt=\"\" class=\"wp-image-24484\"\/><\/figure>\n\n<ul class=\"wp-block-list\">\n<li>Enter the <strong>redirect URI <\/strong>and click <strong>Configure<\/strong><\/li>\n<\/ul>\n\n<p>The {portal domain} variable must be replaced by the URL of the Open Bee Portal instance.<\/p>\n\n<p>For example: <em>entreprise.openbeecloud.com<\/em><\/p>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-6_stmp-translated-1024x492.png\" alt=\"\" class=\"wp-image-24487\"\/><\/figure>\n\n<ul class=\"wp-block-list\">\n<li>From the overview, note the following information:\n<ul class=\"wp-block-list\">\n<li><strong>Application ID (Client)<\/strong><\/li>\n\n\n\n<li><strong>Directory ID (Tenant)<\/strong><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-7_stmp-translated-1024x219.png\" alt=\"\" class=\"wp-image-24492\"\/><\/figure>\n\n<ul class=\"wp-block-list\">\n<li>From the menu on the left, navigate to <strong>Certificate &amp; Secrets<\/strong> to generate a <strong>New Client Secret<\/strong><\/li>\n<\/ul>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-8-translated-1024x420.png\" alt=\"\" class=\"wp-image-24495\"\/><\/figure>\n\n<ul class=\"wp-block-list\">\n<li>Inquire Now\n<ul class=\"wp-block-list\">\n<li><strong>Description:<\/strong> Add a description to remind you how and where the secret will be used<\/li>\n\n\n\n<li><strong>Expiry date: <\/strong>Secret Client Duration<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Attention: <\/strong>Once the client secret expires, emails will no longer be able to be sent through the Open Bee Portal application. It will be necessary to generate a new one and then update it from the <strong>General Configuration<\/strong> of Open Bee Portal. Although Microsoft recommends a default term of 6 months, it may be better to set up a term of 2 years.  <\/p>\n<\/blockquote>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-9-translated-1024x489.png\" alt=\"\" class=\"wp-image-24500\"\/><\/figure>\n\n<ul class=\"wp-block-list\">\n<li>Also note the <strong>client secret<\/strong> generated.<\/li>\n<\/ul>\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Attention:<\/strong> The value to copy is the data contained in the <strong>Value <\/strong>column and the name <strong>of the client secret ID<\/strong>. It is only visible at the time of generation. It then becomes hidden.  <\/p>\n<\/blockquote>\n\n<h3 class=\"wp-block-heading\">Setting app permissions <\/h3>\n\n<ul class=\"wp-block-list\">\n<li>Navigate to the <strong>Allowed API <\/strong>entry in the <strong>Manage<\/strong> submenu<\/li>\n\n\n\n<li>Click on <strong>&#8220;Add permission&#8221;<\/strong> and then <strong>&#8220;Microsoft Graph&#8221;<\/strong> in the right panel<\/li>\n<\/ul>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-11_stmp-translated-1024x509.png\" alt=\"\" class=\"wp-image-24513\"\/><\/figure>\n\n<ul class=\"wp-block-list\">\n<li>Select the <strong>&#8220;delegated permissions&#8221;<\/strong> permission type in order to add the <strong>Mail.Send<\/strong> permission<\/li>\n<\/ul>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-13_stmp-1024x515.png\" alt=\"\" class=\"wp-image-24520\"\/><\/figure>\n\n<ul class=\"wp-block-list\">\n<li>Similarly, add the <strong>User.Read.All permission.<\/strong><\/li>\n<\/ul>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-14_stmp-translated-1024x491.png\" alt=\"\" class=\"wp-image-24524\"\/><\/figure>\n\n<ul class=\"wp-block-list\">\n<li>Repeat the same operations to add the following 2 permissions:\n<ul class=\"wp-block-list\">\n<li><strong>SMTP. Send<\/strong><\/li>\n\n\n\n<li><strong>Mail.ReadWrite<\/strong><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n<ul class=\"wp-block-list\">\n<li>Permissions require granting Admin consent. Please click on the <strong>&#8220;Grant admin consent for XXX&#8221;<\/strong> button located above the permissions table <\/li>\n<\/ul>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-15_stm-translated-1024x410.png\" alt=\"\" class=\"wp-image-24527\"\/><\/figure>\n\n<ul class=\"wp-block-list\">\n<li>Verify that all 5 permissions have been added and are granted. All authorisations must be granted in the <strong>&#8220;Status&#8221; <\/strong> column  <\/li>\n<\/ul>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-21_stmp-translated-1024x504.png\" alt=\"\" class=\"wp-image-24553\"\/><\/figure>\n\n<h3 class=\"wp-block-heading\">Configure Microsoft SMTP in Open Bee Portal<\/h3>\n\n<ul class=\"wp-block-list\">\n<li>Navigating the <strong>Administration<\/strong> -&gt; <strong>General Configuration<\/strong><\/li>\n\n\n\n<li>Choose to use <strong>custom SMTP<\/strong> with the <strong>OAuth2 authentication<\/strong> method<\/li>\n\n\n\n<li>Fill in:\n<ul class=\"wp-block-list\">\n<li><strong>Tenant ID<\/strong> : The directory ID (Tenant) of the application<\/li>\n\n\n\n<li><strong>Client ID:<\/strong> Application ID (Client) of the application<\/li>\n\n\n\n<li><strong>Client Secret Identifier: <\/strong>Generated Client Secret <\/li>\n\n\n\n<li><strong>Customer Secret ID expiration date: <\/strong>This date allows the administrator to be notified one <strong>month before the expiration of the<\/strong> client secret, in order to <strong>plan for its regeneration in time<\/strong> and guarantee the continuity of the service.<\/li>\n\n\n\n<li><strong>Sender: <\/strong><font color=\"red\">Be sure to change the sender&#8217;s address<\/font> to match the email address of the user who generated the client secret. The email can be retrieved in the overview from <a href=\"https:\/\/myaccount.microsoft.com\/\">https:\/\/myaccount.microsoft.com\/<\/a> <\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-18_stmp-translated-1024x611.png\" alt=\"\" class=\"wp-image-24538\"\/><\/figure>\n\n<ul class=\"wp-block-list\">\n<li>Save configuration <\/li>\n<\/ul>\n\n<p>At registration, a <em>Refresh Token<\/em> is generated. A pop-up window appears prompting the admin to sign in to their Microsoft 365 account in order to generate the token. <\/p>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-20_stmp-translated-1024x698.png\" alt=\"\" class=\"wp-image-24547\"\/><\/figure>\n\n<p><\/p>\n\n<ul class=\"wp-block-list\">\n<li><strong>Sending emails through Microsoft 365 is now available<\/strong>. To check that it is working properly, you can carry out a test by sharing a document from the Open Bee Portal application.&#8221; <\/li>\n<\/ul>\n\n<p><\/p>\n\n<p><\/p>\n\n<p><\/p>\n\n<p><\/p>\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Attention: <\/strong>If there is an error in generating the refresh token, a crash is thrown in the Open Bee Portal application<\/p>\n<\/blockquote>\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/help.openbee.com\/wp-content\/uploads\/2026\/03\/image-19_stmp-translated-1024x239.png\" alt=\"\" class=\"wp-image-24543\"\/><\/figure>\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Starting with version 6.10.3, Open Bee\u2122 Portal allows email to be sent via a Google or Office 365 SMTP relay. This page describes the settings that must be applied to use one of these SMTP relays. Gmail or G Suite Prerequisites A Gmail or G suite account with two-step authentication enabled. This option is activated [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":20402,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-20443","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages\/20443","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/comments?post=20443"}],"version-history":[{"count":6,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages\/20443\/revisions"}],"predecessor-version":[{"id":38820,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages\/20443\/revisions\/38820"}],"up":[{"embeddable":true,"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/pages\/20402"}],"wp:attachment":[{"href":"https:\/\/help.openbee.com\/en\/wp-json\/wp\/v2\/media?parent=20443"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}