Skip to content

Commit

Permalink
Commit latest build
Browse files Browse the repository at this point in the history
  • Loading branch information
DNN committed Feb 20, 2025
1 parent 0ab9f76 commit 2677523
Show file tree
Hide file tree
Showing 6 changed files with 3,588 additions and 3,458 deletions.
6 changes: 3 additions & 3 deletions docs/api/DotNetNuke.Services.Installer.Installers.ConfigInstaller.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -340,7 +340,7 @@ <h5 class="overrides">Overrides</h5>
</span>
<a id="DotNetNuke_Services_Installer_Installers_ConfigInstaller_ReadManifest_" data-uid="DotNetNuke.Services.Installer.Installers.ConfigInstaller.ReadManifest*"></a>
<h4 id="DotNetNuke_Services_Installer_Installers_ConfigInstaller_ReadManifest_XPathNavigator_" data-uid="DotNetNuke.Services.Installer.Installers.ConfigInstaller.ReadManifest(XPathNavigator)">ReadManifest(XPathNavigator)</h4>
<div class="markdown level1 summary"><p>The ReadManifest method reads the manifest file for the config compoent.</p>
<div class="markdown level1 summary"><p>The ReadManifest method reads the manifest file for the config component.</p>
</div>
<div class="markdown level1 conceptual"></div>
<h5 class="declaration">Declaration</h5>
Expand Down Expand Up @@ -371,7 +371,7 @@ <h5 class="overrides">Overrides</h5>
<a href="https://github.com/DNNCommunity/DNNDocs/new/main/apiSpec/new?filename=DotNetNuke_Services_Installer_Installers_ConfigInstaller_Rollback.md&amp;value=---%0Auid%3A%20DotNetNuke.Services.Installer.Installers.ConfigInstaller.Rollback%0Asummary%3A%20&#39;*You%20can%20override%20summary%20for%20the%20API%20here%20using%20*MARKDOWN*%20syntax&#39;%0A---%0A%0A*Please%20type%20below%20more%20information%20about%20this%20API%3A*%0A%0A">Improve this Doc</a>
</span>
<span class="small pull-right mobile-hide">
<a href="https://github.com/dnnsoftware/Dnn.Platform/blob/develop/DNN Platform/Library/Services/Installer/Installers/ConfigInstaller.cs/#L170">View Source</a>
<a href="https://github.com/dnnsoftware/Dnn.Platform/blob/develop/DNN Platform/Library/Services/Installer/Installers/ConfigInstaller.cs/#L193">View Source</a>
</span>
<a id="DotNetNuke_Services_Installer_Installers_ConfigInstaller_Rollback_" data-uid="DotNetNuke.Services.Installer.Installers.ConfigInstaller.Rollback*"></a>
<h4 id="DotNetNuke_Services_Installer_Installers_ConfigInstaller_Rollback" data-uid="DotNetNuke.Services.Installer.Installers.ConfigInstaller.Rollback">Rollback()</h4>
Expand All @@ -390,7 +390,7 @@ <h5 class="overrides">Overrides</h5>
<a href="https://github.com/DNNCommunity/DNNDocs/new/main/apiSpec/new?filename=DotNetNuke_Services_Installer_Installers_ConfigInstaller_UnInstall.md&amp;value=---%0Auid%3A%20DotNetNuke.Services.Installer.Installers.ConfigInstaller.UnInstall%0Asummary%3A%20&#39;*You%20can%20override%20summary%20for%20the%20API%20here%20using%20*MARKDOWN*%20syntax&#39;%0A---%0A%0A*Please%20type%20below%20more%20information%20about%20this%20API%3A*%0A%0A">Improve this Doc</a>
</span>
<span class="small pull-right mobile-hide">
<a href="https://github.com/dnnsoftware/Dnn.Platform/blob/develop/DNN Platform/Library/Services/Installer/Installers/ConfigInstaller.cs/#L177">View Source</a>
<a href="https://github.com/dnnsoftware/Dnn.Platform/blob/develop/DNN Platform/Library/Services/Installer/Installers/ConfigInstaller.cs/#L200">View Source</a>
</span>
<a id="DotNetNuke_Services_Installer_Installers_ConfigInstaller_UnInstall_" data-uid="DotNetNuke.Services.Installer.Installers.ConfigInstaller.UnInstall*"></a>
<h4 id="DotNetNuke_Services_Installer_Installers_ConfigInstaller_UnInstall" data-uid="DotNetNuke.Services.Installer.Installers.ConfigInstaller.UnInstall">UnInstall()</h4>
Expand Down
122 changes: 117 additions & 5 deletions docs/content/tutorials/server/smtp-servers/set-up-oauth-microsoft-365/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -103,20 +103,132 @@
<div class="article row grid-right">
<div class="col-md-10">
<article class="content wrap" id="_content" data-uid="set-up-oauth-microsoft-365">
<h1 id="ehow-to-implement-oauth-using-dnn-and-microsoft-365">EHow to implement OAUTH using DNN and Microsoft 365</h1>
<h1 id="how-to-implement-oauth-using-dnn-and-microsoft-365">How to implement OAUTH using DNN and Microsoft 365</h1>
<div class="page-version">
DNN Version: <span class="dnn-version">09.02.00</span>

</div>
<div class="page-stats row visible-xs">
<div class="pull-left"> &bull; Less than 1 minute to read</div>
<div class="pull-left"> &bull; 4 minutes to read</div>
</div>
<div class="page-stats row visible-sm visible-md visible-lg visible-xl">
<span class="pull-left">&nbsp;&bull; Less than 1 minute to read</span>
<span class="pull-left">&nbsp;&bull; 4 minutes to read</span>
</div>

<h2 id="placeholder">Placeholder</h2>
<p>This is a new page. Tutorial wil follow soon</p>
<h2 id="introduction">Introduction</h2>
<p>This page describes the necessary steps to make SMTP work using OAUTH with Microsoft 365.</p>
<h2 id="setup-steps">Setup steps</h2>
<ol>
<li>Check some settings in DNN</li>
<li>Create a mailbox in M365 Exchange</li>
<li>Create an APP registration in the M365 Azure</li>
<li>Grant access to the app to use the mailbox</li>
<li>Setup the mailbox in DNN</li>
</ol>
<h2 id="1-check-some-settings-in-dnn">1. Check some settings in DNN</h2>
<div class="WARNING">
<h5>Warning</h5>
<p>To avoid errors with the authentication in step 5, make sure that the SSL settings are correct. It must be set on <strong>ON</strong>.</p>
</div>
<ul>
<li>Personabar - Security - More - SSL Settings: Make sure that SSL Settings = <strong>ON</strong> (/images/scr-m365-oauth-sslsetting.png)</li>
<li>Personabar - Security - Login settings: Check the site administrator account. You need to use this e-mail address in M365, because the site administrator is the sender.</li>
</ul>
<h2 id="2-create-a-mailbox-in-m365-exchange">2. Create a mailbox in M365 Exchange</h2>
<ul>
<li>Create a mailbox with a licence. Use the address of the site administrator.</li>
<li>As Admin =&gt; Userdetails - E-mail - E-mail apps: In the account settings ensure that the option <em>Verified SMTP</em> is enabled.</li>
</ul>
<div class="WARNING">
<h5>Warning</h5>
<p>In the tenant settings Verified SMTP is not always enabled. You can enable this option for a user with the Powershell command: <code>Set-CASMailbox -Identity [login-address] -SmtpClientAuthenticationDisabled $false</code></p>
</div>
<blockquote>
<p>In Powershell ISE:</p>
<ul>
<li>Install-Module -Name ExchangeOnlineManagement</li>
<li>Connect-ExchangeOnline -Organization [TENANTID]</li>
<li>Set-CASMailbox -Identity [login-address] -SmtpClientAuthenticationDisabled $false</li>
</ul>
</blockquote>
<h2 id="3-create-an-app-registration-in-the-m365-azure">3. Create an APP registration in the M365 Azure</h2>
<p>Create an <strong>App registration</strong> (portal.azure.com -&gt; App registrations)</p>
<ul>
<li><p>Give it a name and choose the <strong>single tenant</strong> option</p>
</li>
<li><p>In the left menu -&gt; Manage - Authentication and choose <strong>Add a platfom</strong> =&gt; <strong>web</strong>:</p>
<ul>
<li>enter your domainname</li>
</ul>
</li>
<li><p>In the left menu -&gt; Manage - Authentication and choose <strong>Add redirect URIs</strong>:</p>
<ul>
<li>https://[SITEURL]/Providers/SmtpOAuthProviders/ExchangeOnline/Authorize.aspx</li>
<li>https://[SITEURL]</li>
</ul>
</li>
<li><p>In the left menu -&gt; Manage - Certificates and Secrets</p>
<ul>
<li>Choose <strong>New client secret</strong>:</li>
<li>Create a secret and save your key for later use.</li>
</ul>
</li>
<li><p>In the left menu -&gt; Manage - API permissions and choose <strong>Add a permission</strong>:</p>
<ul>
<li>Select <strong>Microsoft Graph</strong> -&gt; Delegated -&gt; SMTP.Send (Send emails from mailboxes using SMTP AUTH) -&gt; Add permission</li>
<li>Select <strong>APIs my organisation uses</strong> -&gt; Office 365 online -&gt; Application permissions -&gt;</li>
</ul>
</li>
<li><p>In the left menu &gt; Overview</p>
<ul>
<li>Copy the <strong>Directory (tenant) ID</strong> for later use</li>
<li>Copy the <strong>Application (client) ID</strong> for later use</li>
</ul>
</li>
</ul>
<h2 id="4-grant-access-to-the-app-to-use-the-mailbox">4. Grant access to the app to use the mailbox</h2>
<p><strong>In Azure:</strong></p>
<ul>
<li>Search for <strong>Enterprise applications</strong></li>
<li>Search for application</li>
<li>Copy the <strong>Application ID</strong></li>
<li>Copy the <strong>Object ID</strong></li>
</ul>
<p><strong>In Powershell ISE:</strong></p>
<ul>
<li>Install-Module -Name ExchangeOnlineManagement</li>
<li>Connect-ExchangeOnline -Organization <strong>[TENANTID]</strong></li>
<li>New-ServicePrincipal -AppId <strong>[Application ID]</strong> -ObjectId <strong>[Oject ID]</strong></li>
<li>Get-ServicePrincipal | fl
<ul>
<li>Copy the value of <strong>SID</strong></li>
</ul>
</li>
<li>Add-MailboxPermission -Identity &quot;[mailaddress]&quot; -User [SID] -AccessRights FullAccess</li>
</ul>
<h2 id="4-setup-the-mailbox-in-dnn">4. Setup the mailbox in DNN</h2>
<ul>
<li><p>Personabar - Servers - Server settings</p>
</li>
<li><p>SMTP authentication:</p>
<ul>
<li>SMTP Authentiaction: <strong>OAUTH</strong></li>
<li>Auth Provider: <strong>Exchange Online</strong></li>
<li>Tenant id: <strong>[Your Tenant ID]</strong></li>
<li>Client id: <strong>[Your Client ID]</strong></li>
<li>Client Secret: <strong>[Your Secret]</strong></li>
</ul>
</li>
<li><p>Click <strong>Authorize</strong></p>
</li>
<li><p>Enter your mailbox user credentials</p>
</li>
<li><p>Click <strong>Test SMTP Settings</strong> to check if the setup is successful.</p>
</li>
</ul>
<blockquote>
<p><strong>Your OAuth provider's configuration has been completed.</strong></p>
</blockquote>
</article>
</div>

Expand Down
7 changes: 7 additions & 0 deletions docs/content/tutorials/toc.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,14 @@
</ul>
</li>
<li>
<span class="expand-stub"></span>
<a href="server/smtp-servers/index.html" name="" title="SMTP Servers">SMTP Servers</a>

<ul class="nav level3">
<li>
<a href="server/smtp-servers/set-up-oauth-microsoft-365/index.html" name="" title="SMTP OAUTH Microsoft 365">SMTP OAUTH Microsoft 365</a>
</li>
</ul>
</li>
</ul>
</li>
Expand Down
Binary file added docs/images/scr-m365-oauth-sslsetting.png
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
17 changes: 14 additions & 3 deletions docs/manifest.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -14460,7 +14460,7 @@
"output": {
".html": {
"relative_path": "api/DotNetNuke.Services.Installer.Installers.ConfigInstaller.html",
"hash": "xyFAIWm//KrHG4fN5WYNc0qEUkMQQ1EDIIWyuN9IsN4="
"hash": "ZwGNP4FTs7AyZ+4+n5qQMSZMuCFZb/9HOQcx/n7rCaE="
}
},
"is_incremental": false,
Expand Down Expand Up @@ -39612,7 +39612,7 @@
"output": {
".html": {
"relative_path": "content/tutorials/server/smtp-servers/set-up-oauth-microsoft-365/index.html",
"hash": "RBmrwYrHVaag9S8OLbOAdye/beuJaqHM6LpmsoQsbvE="
"hash": "6OC2cnG61KIKSugeS50AHBSaGFvMTUGV/NL+6AUz2+E="
}
},
"is_incremental": false,
Expand Down Expand Up @@ -41205,7 +41205,7 @@
"output": {
".html": {
"relative_path": "content/tutorials/toc.html",
"hash": "sZryWOhGyYxuP5HRYtNxb9lNyRWElmHaCTUSeAOgT2Y="
"hash": "rbebKwj6OgNG4iguBLxDLSyx37kHtPYNBMZ2UcbK9/c="
}
},
"is_incremental": false,
Expand Down Expand Up @@ -44551,6 +44551,17 @@
"is_incremental": false,
"version": ""
},
{
"type": "Resource",
"source_relative_path": "images/scr-m365-oauth-sslsetting.png",
"output": {
"resource": {
"relative_path": "images/scr-m365-oauth-sslsetting.png"
}
},
"is_incremental": false,
"version": ""
},
{
"type": "Resource",
"source_relative_path": "images/scr-menuAdminAdvanced.png",
Expand Down
Loading

0 comments on commit 2677523

Please sign in to comment.