<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Alessandro Mainardi</title>
    <description>The latest articles on DEV Community by Alessandro Mainardi (@alexmaina).</description>
    <link>https://dev.to/alexmaina</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F3741769%2F83e0f172-e01a-4634-94ae-53b4e192b011.jpeg</url>
      <title>DEV Community: Alessandro Mainardi</title>
      <link>https://dev.to/alexmaina</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/alexmaina"/>
    <language>en</language>
    <item>
      <title>Zero-Risk Microsoft Entra ID (Azure AD) Sandbox Setup for Developers</title>
      <dc:creator>Alessandro Mainardi</dc:creator>
      <pubDate>Thu, 29 Oct 2026 14:03:45 +0000</pubDate>
      <link>https://dev.to/alexmaina/zero-risk-microsoft-entra-id-azure-ad-sandbox-setup-for-developers-4ej</link>
      <guid>https://dev.to/alexmaina/zero-risk-microsoft-entra-id-azure-ad-sandbox-setup-for-developers-4ej</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;📖 &lt;strong&gt;Original Reference:&lt;/strong&gt; Originally published with operational checklists and tenant isolation guides at &lt;a href="https://alexmaina.dev/configurazione-developer-zerorisk/" rel="noopener noreferrer"&gt;alexmaina.dev/configurazione-developer-zerorisk&lt;/a&gt;.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Testing Microsoft Graph applications, OAuth 2.0 consent prompts, or Conditional Access policies on a corporate or shared staging tenant is an accident waiting to happen. A single errant API script with &lt;code&gt;Directory.ReadWrite.All&lt;/code&gt; can alter real user mailboxes, delete guest accounts, or disrupt production SSO.&lt;/p&gt;

&lt;p&gt;The only safe way to develop identity-aware software in the Microsoft ecosystem is with a &lt;strong&gt;dedicated, sandbox-isolated Microsoft 365 Developer Tenant&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;Here is how to set up a reproducible, zero-risk Entra ID development sandbox with sample enterprise data and automated isolation guards.&lt;/p&gt;




&lt;h2&gt;
  
  
  1. Provisioning a Sandbox via the M365 Developer Program
&lt;/h2&gt;

&lt;p&gt;Microsoft provides a free, renewable &lt;strong&gt;E5 Developer Tenant&lt;/strong&gt; containing:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;25 Microsoft 365 E5 developer licenses.&lt;/li&gt;
&lt;li&gt;Full Microsoft Entra ID P2 (Conditional Access, Privileged Identity Management, Risk-based protection).&lt;/li&gt;
&lt;li&gt;Complete Microsoft Graph API permissions.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Steps to Provision:
&lt;/h3&gt;

&lt;ol&gt;
&lt;li&gt;Navigate to the &lt;a href="https://developer.microsoft.com/en-us/microsoft-365/dev-program" rel="noopener noreferrer"&gt;Microsoft 365 Developer Program Portal&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;Sign in with a personal Microsoft Account (MSA) — &lt;strong&gt;never use your corporate work account&lt;/strong&gt; to prevent identity cross-linking.&lt;/li&gt;
&lt;li&gt;Choose &lt;strong&gt;Configurable Sandbox&lt;/strong&gt;: This allows you to pick your own custom tenant domain (&lt;code&gt;yourcompany-dev.onmicrosoft.com&lt;/code&gt;), password policies, and admin credentials.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  2. Auto-Populating with Sample Data Packs
&lt;/h2&gt;

&lt;p&gt;An empty tenant with 1 admin user is useless for testing real-world multi-user interactions, manager-subordinate hierarchies, or shared SharePoint sites.&lt;/p&gt;

&lt;p&gt;In the developer dashboard, enable the pre-configured &lt;strong&gt;Sample Data Packs&lt;/strong&gt;:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Users Pack&lt;/strong&gt;: Automatically scaffolds 16 fictitious users with profile pictures, titles, departments, and pre-configured organizational reporting lines.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Mail &amp;amp; Events Pack&lt;/strong&gt;: Injects realistic Outlook email threads, calendar appointments, and Teams channels to test mail and scheduling APIs immediately.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  3. Registering Apps with Principle of Least Privilege
&lt;/h2&gt;

&lt;p&gt;When creating an Application Registration in the Azure / Entra Portal (&lt;code&gt;entra.microsoft.com&lt;/code&gt;):&lt;/p&gt;

&lt;h3&gt;
  
  
  Never start with Application Permissions:
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Delegated Permissions (&lt;code&gt;User.Read&lt;/code&gt;, &lt;code&gt;Mail.Read&lt;/code&gt;)&lt;/strong&gt;: Runs in the context of the signed-in user. Use this for testing interactive user experiences and frontends.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Application Permissions (&lt;code&gt;User.ReadWrite.All&lt;/code&gt;, &lt;code&gt;Mail.Read.All&lt;/code&gt;)&lt;/strong&gt;: Operates as a daemon service without a user present. Requires Admin Consent.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Enforce Redirect URI Precision:
&lt;/h3&gt;

&lt;p&gt;Avoid wildcard patterns (&lt;code&gt;https://localhost/*&lt;/code&gt;). Entra ID blocks wildcard URIs on modern security baselines:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Correct local development URI: &lt;code&gt;http://localhost:3000/api/auth/callback&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;Correct mobile/desktop URI: &lt;code&gt;msauth://&amp;lt;bundle-id&amp;gt;/&amp;lt;encoded-signature&amp;gt;&lt;/code&gt;
&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  4. Securing Secrets and Certificate Authentication
&lt;/h2&gt;

&lt;p&gt;Never hardcode client secrets in your source code or commit them to git repositories.&lt;/p&gt;

&lt;h3&gt;
  
  
  Best Practice for Backend daemons: Certificate Authentication
&lt;/h3&gt;

&lt;p&gt;Instead of a text client secret string (which expires and leaks easily), create a self-signed development certificate:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Generate a development certificate valid for 1 year&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="nv"&gt;$cert&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;New-SelfSignedCertificate&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-Subject&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"CN=EntraIDDevApp"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="se"&gt;`
&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="nt"&gt;-CertStoreLocation&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Cert:\CurrentUser\My"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="se"&gt;`
&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="nt"&gt;-KeyExportPolicy&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;Exportable&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="se"&gt;`
&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="nt"&gt;-KeySpec&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;Signature&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="se"&gt;`
&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="nt"&gt;-KeyLength&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;2048&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="se"&gt;`
&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="nt"&gt;-KeyAlgorithm&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;RSA&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="se"&gt;`
&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="nt"&gt;-HashAlgorithm&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;SHA256&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="c"&gt;# Export public certificate (.cer) to upload to Entra App Registration&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;Export-Certificate&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-Cert&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nv"&gt;$cert&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-FilePath&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;".\EntraIDDevApp.cer"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;In the Entra ID Portal under &lt;strong&gt;Certificates &amp;amp; secrets&lt;/strong&gt; → &lt;strong&gt;Certificates&lt;/strong&gt;, upload &lt;code&gt;EntraIDDevApp.cer&lt;/code&gt;. Your backend can now authenticate cryptographically using the private key without storing plaintext credentials.&lt;/p&gt;




&lt;h2&gt;
  
  
  5. Setting up Hard Tenant Boundaries (Zero-Risk Rule)
&lt;/h2&gt;

&lt;p&gt;To prevent accidental command execution against the wrong tenant in your CLI:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Use Isolated PowerShell Profiles&lt;/strong&gt;:
Create a dedicated script that explicitly connects only to your sandbox Tenant ID:
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="c"&gt;# connect-sandbox.ps1&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="nv"&gt;$SandboxTenantId&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;Connect-MgGraph&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-TenantId&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nv"&gt;$SandboxTenantId&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-Scopes&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"User.Read.All"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Group.Read.All"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;Write-Host&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Connected safely to SANDBOX: &lt;/span&gt;&lt;span class="si"&gt;$(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;Get-MgOrganization&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="s2"&gt;.DisplayName)"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-ForegroundColor&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;Green&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Verify Tenant Name Before Script Execution&lt;/strong&gt;:
Add a safety check at the top of any automation script:
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="nv"&gt;$currentTenant&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;Get-MgOrganization&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;Id&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="nx"&gt;if&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$currentTenant&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;-ne&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="kr"&gt;throw&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"ABORT: Current session is NOT connected to the Developer Sandbox!"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  Summary
&lt;/h2&gt;

&lt;p&gt;By provisioning an isolated E5 Developer Tenant, populating it with realistic sample datasets, and enforcing certificate-based authentication with strict tenant-boundary checks in your scripts, you can test enterprise identity architectures rapidly without risking corporate production assets.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Author: &lt;a href="https://alexmaina.dev/about/" rel="noopener noreferrer"&gt;Alessandro Mainardi&lt;/a&gt; — Software Developer &amp;amp; Microsoft 365 / Cloud Identity Specialist. Discover more enterprise identity tutorials at &lt;a href="https://alexmaina.dev/" rel="noopener noreferrer"&gt;alexmaina.dev&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>azure</category>
      <category>security</category>
      <category>devops</category>
      <category>microsoft</category>
    </item>
    <item>
      <title>Migrating from Deprecated AzureAD &amp; MSOnline to Microsoft Graph PowerShell SDK</title>
      <dc:creator>Alessandro Mainardi</dc:creator>
      <pubDate>Thu, 29 Oct 2026 14:03:12 +0000</pubDate>
      <link>https://dev.to/alexmaina/migrating-from-deprecated-azuread-msonline-to-microsoft-graph-powershell-sdk-2mm4</link>
      <guid>https://dev.to/alexmaina/migrating-from-deprecated-azuread-msonline-to-microsoft-graph-powershell-sdk-2mm4</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;📖 &lt;strong&gt;Original Reference:&lt;/strong&gt; Originally published with full script translation matrices and Graph SDK pipelines at &lt;a href="https://alexmaina.dev/ms365/" rel="noopener noreferrer"&gt;alexmaina.dev/ms365&lt;/a&gt;.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Microsoft has officially retired the legacy &lt;code&gt;AzureAD&lt;/code&gt; and &lt;code&gt;MSOnline&lt;/code&gt; (MSOL) PowerShell modules. Any legacy scripts still executing &lt;code&gt;Get-AzureADUser&lt;/code&gt;, &lt;code&gt;Set-MsolUserLicense&lt;/code&gt;, or &lt;code&gt;Connect-MsolService&lt;/code&gt; face broken endpoints, authentication failures, and deprecation notices.&lt;/p&gt;

&lt;p&gt;The replacement is the &lt;strong&gt;Microsoft Graph PowerShell SDK (&lt;code&gt;Microsoft.Graph&lt;/code&gt;)&lt;/strong&gt;. However, migrating isn't just a simple 1:1 cmdlet rename: the Graph SDK has fundamentally different scoping, JSON-based payload structures, and paging mechanisms.&lt;/p&gt;

&lt;p&gt;Here is the practical, crash-course guide to modernizing your scripts for Microsoft Graph PowerShell v2, including unattended certificate authentication for CI/CD runners.&lt;/p&gt;




&lt;h2&gt;
  
  
  1. Quick Cmdlet Translation Matrix
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Old AzureAD / MSOnline&lt;/th&gt;
&lt;th&gt;Modern Microsoft Graph SDK&lt;/th&gt;
&lt;th&gt;Key Difference&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;Get-AzureADUser -ObjectId $id&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;Get-MgUser -UserId $id&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Properties are lazy-loaded; use &lt;code&gt;-Property&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;Get-AzureADGroup&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;Get-MgGroup -All&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Must explicitly specify &lt;code&gt;-All&lt;/code&gt; to paginate&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;Add-AzureADGroupMember&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;New-MgGroupMemberByRef&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Requires &lt;code&gt;@{"@odata.id" = "..."}&lt;/code&gt; format&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;Set-MsolUserLicense&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;Set-MgUserLicense&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Uses modern GUID SKU IDs&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;Get-AzureADDevice&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;Get-MgDevice -All&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Device attributes match Entra ID schema&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;




&lt;h2&gt;
  
  
  2. The Pagination Trap: Why &lt;code&gt;Get-MgUser&lt;/code&gt; Returns Only 100 Items
&lt;/h2&gt;

&lt;p&gt;One of the most frequent surprises for administrators migrating from &lt;code&gt;Get-AzureADUser&lt;/code&gt; is that &lt;code&gt;Get-MgUser&lt;/code&gt; defaults to returning only the first &lt;strong&gt;100 records&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;If you have 1,500 users, running &lt;code&gt;Get-MgUser&lt;/code&gt; without flags leaves 1,400 users unprocessed:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="c"&gt;# ❌ INCORRECT: Truncates at 100 users&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="nv"&gt;$users&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Get-MgUser&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="c"&gt;# ✅ CORRECT: Automatically follows nextLink pagination tokens&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="nv"&gt;$allUsers&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Get-MgUser&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-All&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="c"&gt;# 🚀 PERFORMANCE TIP: Only request the properties you actually need&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="nv"&gt;$optimizedUsers&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Get-MgUser&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-All&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-Property&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"displayName"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"userPrincipalName"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"mail"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  3. Adding Group Members the Modern Way (&lt;code&gt;New-MgGroupMemberByRef&lt;/code&gt;)
&lt;/h2&gt;

&lt;p&gt;In legacy modules, you passed simple IDs. In the Microsoft Graph SDK, relations are established via OData references:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Legacy AzureAD (BROKEN):&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c"&gt;# Add-AzureADGroupMember -ObjectId $groupId -RefObjectId $userId&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="c"&gt;# Modern Microsoft Graph:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="nv"&gt;$params&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;@{&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s2"&gt;"@odata.id"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"https://graph.microsoft.com/v1.0/directoryObjects/&lt;/span&gt;&lt;span class="nv"&gt;$userId&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;New-MgGroupMemberByRef&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-GroupId&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nv"&gt;$groupId&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-BodyParameter&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nv"&gt;$params&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  4. Unattended CI/CD Automation (No Passwords or MFA Prompts)
&lt;/h2&gt;

&lt;p&gt;Automated backup scripts and DevOps deployment pipelines cannot use interactive &lt;code&gt;Connect-MgGraph&lt;/code&gt; browser logins. You must authenticate using an App Registration with an X.509 Certificate.&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 1: Connect via Certificate Thumbprint
&lt;/h3&gt;

&lt;p&gt;On your management server or GitHub Actions runner:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="nv"&gt;$tenantId&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="nv"&gt;$appId&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="nv"&gt;$thumbprint&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"1234567890ABCDEF1234567890ABCDEF12345678"&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="c"&gt;# Authenticate unattended&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;Connect-MgGraph&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-TenantId&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nv"&gt;$tenantId&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-ClientId&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nv"&gt;$appId&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-CertificateThumbprint&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nv"&gt;$thumbprint&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-NoWelcome&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Step 2: Running Least-Privilege Queries
&lt;/h3&gt;

&lt;p&gt;Always scope your App Registration to the minimum required permissions (e.g. &lt;code&gt;User.Read.All&lt;/code&gt; instead of &lt;code&gt;Directory.ReadWrite.All&lt;/code&gt;):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Export all active users to CSV safely&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;Get-MgUser&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-All&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-Filter&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"accountEnabled eq true"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-Property&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"displayName"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"mail"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"department"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="w"&gt; 
    &lt;/span&gt;&lt;span class="n"&gt;Select-Object&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;DisplayName&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;Mail&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;Department&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="w"&gt; 
    &lt;/span&gt;&lt;span class="n"&gt;Export-Csv&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-Path&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"ActiveEmployees.csv"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-NoTypeInformation&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="c"&gt;# Disconnect session cleanly&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;Disconnect-MgGraph&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  5. Installing Only What You Need (Save Disk Space &amp;amp; Startup Time)
&lt;/h2&gt;

&lt;p&gt;The monolithic &lt;code&gt;Microsoft.Graph&lt;/code&gt; module downloads dozens of sub-modules and consumes over 1GB of disk space. For lightweight scripts or container runners, install only the specific sub-modules:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Instead of installing all 38 Graph modules:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c"&gt;# Install-Module Microsoft.Graph&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="c"&gt;# Install ONLY the modules required by your script:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;Install-Module&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;Microsoft.Graph.Authentication&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-Scope&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;CurrentUser&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;Install-Module&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;Microsoft.Graph.Users&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-Scope&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;CurrentUser&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;Install-Module&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;Microsoft.Graph.Groups&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-Scope&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;CurrentUser&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Execution times drop from 15 seconds to under 2 seconds.&lt;/p&gt;




&lt;h2&gt;
  
  
  Conclusion
&lt;/h2&gt;

&lt;p&gt;Migrating to the Microsoft Graph PowerShell SDK future-proofs your enterprise automation, aligns your scripts with standard REST APIs, and allows rock-solid unattended execution with certificate-based authentication.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Author: &lt;a href="https://alexmaina.dev/about/" rel="noopener noreferrer"&gt;Alessandro Mainardi&lt;/a&gt; — Software Developer &amp;amp; Microsoft 365 Cloud Architect. Explore enterprise automation playbooks at &lt;a href="https://alexmaina.dev/ms365/" rel="noopener noreferrer"&gt;alexmaina.dev/ms365&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>powershell</category>
      <category>azure</category>
      <category>devops</category>
      <category>microsoft</category>
    </item>
    <item>
      <title>Killing Passwords for Good: Implementing FIDO2 Hardware Keys and Passkeys on Linux &amp; Cloud</title>
      <dc:creator>Alessandro Mainardi</dc:creator>
      <pubDate>Thu, 29 Oct 2026 14:02:47 +0000</pubDate>
      <link>https://dev.to/alexmaina/killing-passwords-for-good-implementing-fido2-hardware-keys-and-passkeys-on-linux-cloud-49mj</link>
      <guid>https://dev.to/alexmaina/killing-passwords-for-good-implementing-fido2-hardware-keys-and-passkeys-on-linux-cloud-49mj</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;📖 &lt;strong&gt;Original Reference:&lt;/strong&gt; Originally published with operating system hardening rules and cryptographic standards at &lt;a href="https://alexmaina.dev/sicurezza/" rel="noopener noreferrer"&gt;alexmaina.dev/sicurezza&lt;/a&gt;.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;SMS verification codes, email magic links, and standard Time-based One-Time Passwords (TOTP via authenticator apps) are no longer sufficient to stop modern adversary-in-the-middle (AiTM) reverse proxy phishing kits like Evilginx. These attacks intercept your session cookie right as you type your 6-digit code.&lt;/p&gt;

&lt;p&gt;The only cryptographic authentication standard completely immune to phishing is &lt;strong&gt;FIDO2 / WebAuthn (Passkeys)&lt;/strong&gt;, backed by asymmetric public-key cryptography bound directly to the browser's origin.&lt;/p&gt;

&lt;p&gt;Here is a practical guide to implementing FIDO2 hardware security keys (YubiKey, Nitrokey, or platform passkeys) across your development machines, Linux servers, and cloud consoles.&lt;/p&gt;




&lt;h2&gt;
  
  
  1. Why FIDO2 Beats Traditional 2FA
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Mechanism&lt;/th&gt;
&lt;th&gt;Phishing Resistant?&lt;/th&gt;
&lt;th&gt;Channel Bound?&lt;/th&gt;
&lt;th&gt;Backup Vulnerability&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;SMS OTP&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;❌ No&lt;/td&gt;
&lt;td&gt;❌ No&lt;/td&gt;
&lt;td&gt;SIM Swapping&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;TOTP Authenticator&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;❌ No (AiTM Proxy captures code)&lt;/td&gt;
&lt;td&gt;❌ No&lt;/td&gt;
&lt;td&gt;Secret key screenshot / leak&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Push Prompts (Duo/Okta)&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;❌ No (MFA fatigue spam)&lt;/td&gt;
&lt;td&gt;❌ No&lt;/td&gt;
&lt;td&gt;Accidental approval&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;FIDO2 / Passkeys&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;✅ &lt;strong&gt;100% Yes&lt;/strong&gt;
&lt;/td&gt;
&lt;td&gt;✅ &lt;strong&gt;Yes (URL verified by silicon)&lt;/strong&gt;
&lt;/td&gt;
&lt;td&gt;Non-exportable hardware key&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Under WebAuthn, your browser cryptographically signs the challenge with the private key stored inside the hardware token, verifying that the domain matches the origin. If you enter your credentials on &lt;code&gt;g1thub.fake.com&lt;/code&gt;, the FIDO2 key simply refuses to sign the payload.&lt;/p&gt;




&lt;h2&gt;
  
  
  2. Hardening Linux Server SSH with FIDO2 Hardware Keys
&lt;/h2&gt;

&lt;p&gt;Forget traditional vulnerable RSA/ED25519 SSH keypairs that sit unencrypted on your disk. OpenSSH has native support for FIDO2 hardware keys (&lt;code&gt;ed25519-sk&lt;/code&gt; and &lt;code&gt;ecdsa-sk&lt;/code&gt;).&lt;/p&gt;

&lt;h3&gt;
  
  
  Step 1: Generate a Resident FIDO2 SSH Keypair
&lt;/h3&gt;

&lt;p&gt;Plug your hardware key into your local machine and run:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Generate a hardware-backed resident key requiring user presence (touch)&lt;/span&gt;
ssh-keygen &lt;span class="nt"&gt;-t&lt;/span&gt; ed25519-sk &lt;span class="nt"&gt;-O&lt;/span&gt; resident &lt;span class="nt"&gt;-O&lt;/span&gt; verify-required &lt;span class="nt"&gt;-f&lt;/span&gt; ~/.ssh/id_ed25519_sk
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;-O resident&lt;/code&gt;: Stores the key metadata directly in the hardware token. You can plug the key into any computer and pull your key with &lt;code&gt;ssh-add -K&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;-O verify-required&lt;/code&gt;: Requires PIN entry on the physical key before it authorizes the connection.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Step 2: Configure Remote Server (&lt;code&gt;/etc/ssh/sshd_config&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;On your remote Ubuntu/Debian server, enforce hardware-only authentication:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;# Disable password authentication and insecure key algorithms
PasswordAuthentication no
PubkeyAuthentication yes
PubkeyAcceptedKeyTypes *sk-ssh-ed25519@openssh.com*
ChallengeResponseAuthentication no
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Restart SSH: &lt;code&gt;sudo systemctl restart ssh&lt;/code&gt;. Now, even if an attacker steals your local &lt;code&gt;id_ed25519_sk&lt;/code&gt; file, they cannot connect without physically possessing and tapping your hardware key!&lt;/p&gt;




&lt;h2&gt;
  
  
  3. Securing Local Sudo on Linux with &lt;code&gt;pam_u2f&lt;/code&gt;
&lt;/h2&gt;

&lt;p&gt;Instead of typing your user password every time you run &lt;code&gt;sudo&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# 1. Install the U2F PAM module&lt;/span&gt;
&lt;span class="nb"&gt;sudo &lt;/span&gt;apt &lt;span class="nb"&gt;install &lt;/span&gt;libpam-u2f pamu2fcfg &lt;span class="nt"&gt;-y&lt;/span&gt;

&lt;span class="c"&gt;# 2. Register your physical key&lt;/span&gt;
&lt;span class="nb"&gt;mkdir&lt;/span&gt; &lt;span class="nt"&gt;-p&lt;/span&gt; ~/.config/Yubico
pamu2fcfg &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; ~/.config/Yubico/u2f_keys

&lt;span class="c"&gt;# 3. Register your backup key (ALWAYS have a second key!)&lt;/span&gt;
pamu2fcfg &lt;span class="nt"&gt;-n&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&amp;gt;&lt;/span&gt; ~/.config/Yubico/u2f_keys
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Edit &lt;code&gt;/etc/pam.d/sudo&lt;/code&gt; and add this line near the top:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;auth required pam_u2f.so
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Open a new terminal window to test: when you type &lt;code&gt;sudo ls&lt;/code&gt;, your key will blink. Tap it, and sudo permissions are granted cryptographically without revealing a password.&lt;/p&gt;




&lt;h2&gt;
  
  
  4. The Golden Rule: The 2-Key Strategy (Primary + Backup)
&lt;/h2&gt;

&lt;p&gt;Never configure a single hardware key. If you lose it while traveling, you risk locking yourself out of root consoles.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Primary Key&lt;/strong&gt;: On your keychain (e.g. YubiKey 5C NFC).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Backup Key&lt;/strong&gt;: Kept offline in a secure, fireproof safe at home or office.&lt;/li&gt;
&lt;li&gt;Every time you register a passkey on GitHub, AWS, Google Cloud, or your password manager, &lt;strong&gt;enroll both keys simultaneously&lt;/strong&gt;.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  Conclusion
&lt;/h2&gt;

&lt;p&gt;Migrating to FIDO2 hardware tokens and Passkeys transforms authentication from a memory test into cryptographic proof of physical possession. Phishing kits become obsolete, and credential theft is eliminated at the protocol layer.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Author: &lt;a href="https://alexmaina.dev/about/" rel="noopener noreferrer"&gt;Alessandro Mainardi&lt;/a&gt; — Software Developer &amp;amp; Security Enthusiast. Read the complete systems hardening and privacy guide at &lt;a href="https://alexmaina.dev/sicurezza/" rel="noopener noreferrer"&gt;alexmaina.dev/sicurezza&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>security</category>
      <category>linux</category>
      <category>devops</category>
      <category>webdev</category>
    </item>
    <item>
      <title>Building a 100/100 Lighthouse Static Website with GitHub Pages, Cloudflare &amp; Vanilla Tech</title>
      <dc:creator>Alessandro Mainardi</dc:creator>
      <pubDate>Thu, 29 Oct 2026 14:02:03 +0000</pubDate>
      <link>https://dev.to/alexmaina/building-a-100100-lighthouse-static-website-with-github-pages-cloudflare-vanilla-tech-1c9c</link>
      <guid>https://dev.to/alexmaina/building-a-100100-lighthouse-static-website-with-github-pages-cloudflare-vanilla-tech-1c9c</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;📖 &lt;strong&gt;Original Reference:&lt;/strong&gt; Originally published with full semantic markup templates and Cloudflare DNS setup at &lt;a href="https://alexmaina.dev/guida_sito/" rel="noopener noreferrer"&gt;alexmaina.dev/guida_sito&lt;/a&gt;.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;In an era where personal portfolio sites and simple blogs pull in 250MB of &lt;code&gt;node_modules&lt;/code&gt;, hydrate megabytes of JavaScript, and suffer from layout shifts, going back to &lt;strong&gt;pure semantic HTML5, modern CSS, and vanilla JS&lt;/strong&gt; feels like a superpower.&lt;/p&gt;

&lt;p&gt;By hosting static files on &lt;strong&gt;GitHub Pages&lt;/strong&gt; paired with &lt;strong&gt;Cloudflare's Global Edge Network&lt;/strong&gt;, you get:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Perfect &lt;strong&gt;100/100 Lighthouse performance&lt;/strong&gt; on mobile and desktop.&lt;/li&gt;
&lt;li&gt;Sub-50ms Time to First Byte (TTFB) worldwide.&lt;/li&gt;
&lt;li&gt;Enterprise DDoS mitigation, automatic HTTP/3, and free SSL certificates.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;\$0/month forever hosting costs&lt;/strong&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Here is how to set up the entire stack from scratch.&lt;/p&gt;




&lt;h2&gt;
  
  
  1. The Modern Zero-Framework Project Structure
&lt;/h2&gt;

&lt;p&gt;You do not need a bloated build tool to get responsive layouts, dark mode, and offline caching:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;my-website/
├── index.html              # Clean semantic HTML5
├── style.css               # Modern CSS with Custom Properties (variables)
├── script.js               # Vanilla JS for interactive widgets &amp;amp; theme toggle
├── sw.js                   # Lightweight Service Worker for offline support
├── robots.txt              # Search engine crawler rules
├── sitemap.xml             # XML sitemap for SEO indexing
└── .github/
    └── workflows/
        └── deploy.yml      # Automated linting and deployment
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  2. Flash-Free Dark Mode in Modern CSS
&lt;/h2&gt;

&lt;p&gt;The most common bug in static websites is the &lt;strong&gt;dark mode flash&lt;/strong&gt;: the page renders bright white for 100ms before JavaScript executes and toggles the dark theme.&lt;/p&gt;

&lt;p&gt;To prevent the flash completely, place an inline, blocking script in the &lt;code&gt;&amp;lt;head&amp;gt;&lt;/code&gt; before any CSS renders:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;head&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;meta&lt;/span&gt; &lt;span class="na"&gt;charset=&lt;/span&gt;&lt;span class="s"&gt;"UTF-8"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;title&amp;gt;&lt;/span&gt;Developer Portfolio&lt;span class="nt"&gt;&amp;lt;/title&amp;gt;&lt;/span&gt;

  &lt;span class="c"&gt;&amp;lt;!-- ⚡ Prevents theme flicker before CSS paints --&amp;gt;&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;script&amp;gt;&lt;/span&gt;
    &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;function&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;savedTheme&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;localStorage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;getItem&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;theme&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; 
        &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;window&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;matchMedia&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;(prefers-color-scheme: dark)&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nx"&gt;matches&lt;/span&gt; &lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;dark&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;light&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
      &lt;span class="nb"&gt;document&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;documentElement&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;setAttribute&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;data-theme&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;savedTheme&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="p"&gt;})();&lt;/span&gt;
  &lt;span class="nt"&gt;&amp;lt;/script&amp;gt;&lt;/span&gt;

  &lt;span class="nt"&gt;&amp;lt;link&lt;/span&gt; &lt;span class="na"&gt;rel=&lt;/span&gt;&lt;span class="s"&gt;"stylesheet"&lt;/span&gt; &lt;span class="na"&gt;href=&lt;/span&gt;&lt;span class="s"&gt;"style.css"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;/head&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;In &lt;code&gt;style.css&lt;/code&gt;, leverage CSS custom properties:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight css"&gt;&lt;code&gt;&lt;span class="nd"&gt;:root&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="py"&gt;--bg-color&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;#ffffff&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="py"&gt;--text-color&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;#1e293b&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="py"&gt;--accent-color&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;#0284c7&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="o"&gt;[&lt;/span&gt;&lt;span class="nt"&gt;data-theme&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s1"&gt;"dark"&lt;/span&gt;&lt;span class="o"&gt;]&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="py"&gt;--bg-color&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;#0b0f19&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="py"&gt;--text-color&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;#f1f5f9&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="py"&gt;--accent-color&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;#38bdf8&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="nt"&gt;body&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;background-color&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nf"&gt;var&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="l"&gt;--bg-color&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nl"&gt;color&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nf"&gt;var&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="l"&gt;--text-color&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nl"&gt;font-family&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;system-ui&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;apple-system&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;sans-serif&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nl"&gt;transition&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;background-color&lt;/span&gt; &lt;span class="m"&gt;0.2s&lt;/span&gt; &lt;span class="nb"&gt;ease&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;color&lt;/span&gt; &lt;span class="m"&gt;0.2s&lt;/span&gt; &lt;span class="nb"&gt;ease&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  3. Offline Caching with a Vanilla Service Worker (&lt;code&gt;sw.js&lt;/code&gt;)
&lt;/h2&gt;

&lt;p&gt;Add native offline capability and instant page transitions using the Cache API:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// sw.js&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;CACHE_NAME&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;site-cache-v1&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;ASSETS_TO_CACHE&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
  &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/index.html&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/style.css&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/script.js&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/offline.html&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;
&lt;span class="p"&gt;];&lt;/span&gt;

&lt;span class="nb"&gt;self&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;addEventListener&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;install&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;event&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;event&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;waitUntil&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="nx"&gt;caches&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;open&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;CACHE_NAME&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;then&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;cache&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;cache&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;addAll&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;ASSETS_TO_CACHE&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
  &lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nb"&gt;self&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;skipWaiting&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;

&lt;span class="nb"&gt;self&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;addEventListener&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;fetch&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;event&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;event&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;respondWith&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="nx"&gt;caches&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;match&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;event&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;request&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;then&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;response&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="c1"&gt;// Return cached asset or fetch from network&lt;/span&gt;
      &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;response&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="nf"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;event&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;request&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="k"&gt;catch&lt;/span&gt;&lt;span class="p"&gt;(()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;caches&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;match&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/offline.html&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
    &lt;span class="p"&gt;})&lt;/span&gt;
  &lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Register it in &lt;code&gt;script.js&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;serviceWorker&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="nb"&gt;navigator&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nb"&gt;window&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;addEventListener&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;load&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nb"&gt;navigator&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;serviceWorker&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;register&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/sw.js&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="p"&gt;});&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  4. Pairing GitHub Pages with Cloudflare DNS &amp;amp; SSL
&lt;/h2&gt;

&lt;p&gt;Deploying your site to a custom domain (e.g., &lt;code&gt;alexmaina.dev&lt;/code&gt;) with Cloudflare provides edge caching and HTTPS enforcement:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;In your GitHub repository settings, go to &lt;strong&gt;Pages&lt;/strong&gt; → Source: &lt;strong&gt;Deploy from a branch&lt;/strong&gt; (&lt;code&gt;main&lt;/code&gt; / root).&lt;/li&gt;
&lt;li&gt;Enter your custom domain in the &lt;strong&gt;Custom domain&lt;/strong&gt; field (creates a &lt;code&gt;CNAME&lt;/code&gt; file in your repo).&lt;/li&gt;
&lt;li&gt;In your &lt;strong&gt;Cloudflare Dashboard&lt;/strong&gt;:

&lt;ul&gt;
&lt;li&gt;Add a &lt;code&gt;CNAME&lt;/code&gt; record for &lt;code&gt;@&lt;/code&gt; pointing to &lt;code&gt;&amp;lt;username&amp;gt;.github.io&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Add a &lt;code&gt;CNAME&lt;/code&gt; record for &lt;code&gt;www&lt;/code&gt; pointing to &lt;code&gt;&amp;lt;username&amp;gt;.github.io&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Toggle the proxy status to &lt;strong&gt;Orange Cloud (Proxied)&lt;/strong&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;Under &lt;strong&gt;SSL/TLS&lt;/strong&gt;, set encryption mode to &lt;strong&gt;Full (Strict)&lt;/strong&gt;.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  5. Automated CI/CD Validation with GitHub Actions
&lt;/h2&gt;

&lt;p&gt;Catch broken links, unclosed tags, and syntax errors automatically on every &lt;code&gt;git push&lt;/code&gt;:&lt;/p&gt;

&lt;p&gt;Create &lt;code&gt;.github/workflows/deploy.yml&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Deploy &amp;amp; Validate Static Site&lt;/span&gt;

&lt;span class="na"&gt;on&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;push&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;branches&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="pi"&gt;[&lt;/span&gt; &lt;span class="nv"&gt;main&lt;/span&gt; &lt;span class="pi"&gt;]&lt;/span&gt;

&lt;span class="na"&gt;jobs&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;validate&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;runs-on&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;ubuntu-latest&lt;/span&gt;
    &lt;span class="na"&gt;steps&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;actions/checkout@v4&lt;/span&gt;

      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Validate HTML5 Syntax&lt;/span&gt;
        &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Cyb3r-Jak3/html5validator-action@v7.2.0&lt;/span&gt;
        &lt;span class="na"&gt;with&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;root&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;.&lt;/span&gt;
          &lt;span class="na"&gt;blacklist&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;node_modules"&lt;/span&gt;

      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Check for Broken Links&lt;/span&gt;
        &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;gaurav-nelson/github-action-markdown-link-check@v1&lt;/span&gt;
        &lt;span class="na"&gt;with&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;use-quiet-mode&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'&lt;/span&gt;&lt;span class="s"&gt;yes'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  Results &amp;amp; Benchmarks
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Performance:&lt;/strong&gt; 100/100&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Accessibility:&lt;/strong&gt; 100/100&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Best Practices:&lt;/strong&gt; 100/100&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;SEO:&lt;/strong&gt; 100/100&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Monthly Infrastructure Cost:&lt;/strong&gt; \$0.00&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  Conclusion
&lt;/h2&gt;

&lt;p&gt;Before reaching for complex React/Next.js scaffolds for personal portfolios, documentation sites, or small marketing landing pages, consider the elegance of vanilla web technologies. It is simpler to maintain, faster for your users, and immune to framework deprecation cycles.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Author: &lt;a href="https://alexmaina.dev/about/" rel="noopener noreferrer"&gt;Alessandro Mainardi&lt;/a&gt; — Computer Engineering Student @ UniBo &amp;amp; Full-Stack Developer. Explore the live implementation at &lt;a href="https://alexmaina.dev/" rel="noopener noreferrer"&gt;alexmaina.dev&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>webdev</category>
      <category>html</category>
      <category>css</category>
      <category>github</category>
    </item>
    <item>
      <title>Running High-Performance WordPress on a NAS with Docker Compose, MariaDB &amp; Redis</title>
      <dc:creator>Alessandro Mainardi</dc:creator>
      <pubDate>Thu, 29 Oct 2026 14:01:38 +0000</pubDate>
      <link>https://dev.to/alexmaina/running-high-performance-wordpress-on-a-nas-with-docker-compose-mariadb-redis-3f5d</link>
      <guid>https://dev.to/alexmaina/running-high-performance-wordpress-on-a-nas-with-docker-compose-mariadb-redis-3f5d</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;📖 &lt;strong&gt;Original Reference:&lt;/strong&gt; Originally published with full volume mapping specs and storage pool benchmarks at &lt;a href="https://alexmaina.dev/wordpress-su-nas/" rel="noopener noreferrer"&gt;alexmaina.dev/wordpress-su-nas&lt;/a&gt;.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Many developers who spin up WordPress on a home or small-business NAS (QNAP Container Station, Synology Container Manager, or Proxmox) face painful TTFB (Time to First Byte) latency of 2 to 5 seconds. Pages feel sluggish, and admin dashboards grind to a halt.&lt;/p&gt;

&lt;p&gt;The root cause is rarely the CPU: it is almost always &lt;strong&gt;disk I/O bottlenecks&lt;/strong&gt; on consumer NAS drives combined with default MySQL settings that write every single transient query to spinning mechanical disks.&lt;/p&gt;

&lt;p&gt;Here is the tuned, production-ready &lt;code&gt;docker-compose.yml&lt;/code&gt; stack with MariaDB performance tweaks and Redis in-memory object caching that brings response times under 200ms on local hardware.&lt;/p&gt;




&lt;h2&gt;
  
  
  1. The High-Performance Docker Compose Stack
&lt;/h2&gt;

&lt;p&gt;Create a directory on your NAS fast storage volume (preferably an SSD pool or NVMe cache tier):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;mkdir&lt;/span&gt; &lt;span class="nt"&gt;-p&lt;/span&gt; /share/Container/wordpress-stack &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nb"&gt;cd&lt;/span&gt; /share/Container/wordpress-stack
nano docker-compose.yml
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Paste the following optimized stack:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;version&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'&lt;/span&gt;&lt;span class="s"&gt;3.8'&lt;/span&gt;

&lt;span class="na"&gt;services&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;db&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;image&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;mariadb:10.11-jammy&lt;/span&gt;
    &lt;span class="na"&gt;container_name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;wp_mariadb&lt;/span&gt;
    &lt;span class="na"&gt;restart&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;always&lt;/span&gt;
    &lt;span class="na"&gt;environment&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="na"&gt;MYSQL_ROOT_PASSWORD&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;YourSuperSecureRootPassword_123!&lt;/span&gt;
      &lt;span class="na"&gt;MYSQL_DATABASE&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;wordpress&lt;/span&gt;
      &lt;span class="na"&gt;MYSQL_USER&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;wp_user&lt;/span&gt;
      &lt;span class="na"&gt;MYSQL_PASSWORD&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;YourSuperSecureUserPassword_123!&lt;/span&gt;
    &lt;span class="na"&gt;volumes&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;./mariadb_data:/var/lib/mysql&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;./mariadb_conf/my.cnf:/etc/mysql/conf.d/my.cnf:ro&lt;/span&gt;
    &lt;span class="na"&gt;networks&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;wp_internal&lt;/span&gt;

  &lt;span class="na"&gt;redis&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;image&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;redis:7-alpine&lt;/span&gt;
    &lt;span class="na"&gt;container_name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;wp_redis&lt;/span&gt;
    &lt;span class="na"&gt;restart&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;always&lt;/span&gt;
    &lt;span class="na"&gt;command&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;redis-server --maxmemory 256mb --maxmemory-policy allkeys-lru&lt;/span&gt;
    &lt;span class="na"&gt;networks&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;wp_internal&lt;/span&gt;

  &lt;span class="na"&gt;wordpress&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;image&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;wordpress:php8.3-fpm-alpine&lt;/span&gt;
    &lt;span class="na"&gt;container_name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;wp_core&lt;/span&gt;
    &lt;span class="na"&gt;restart&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;always&lt;/span&gt;
    &lt;span class="na"&gt;depends_on&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;db&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;redis&lt;/span&gt;
    &lt;span class="na"&gt;environment&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="na"&gt;WORDPRESS_DB_HOST&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;db:3306&lt;/span&gt;
      &lt;span class="na"&gt;WORDPRESS_DB_NAME&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;wordpress&lt;/span&gt;
      &lt;span class="na"&gt;WORDPRESS_DB_USER&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;wp_user&lt;/span&gt;
      &lt;span class="na"&gt;WORDPRESS_DB_PASSWORD&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;YourSuperSecureUserPassword_123!&lt;/span&gt;
      &lt;span class="na"&gt;WORDPRESS_CONFIG_EXTRA&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="pi"&gt;|&lt;/span&gt;
        &lt;span class="s"&gt;define('WP_REDIS_HOST', 'redis');&lt;/span&gt;
        &lt;span class="s"&gt;define('WP_REDIS_PORT', 6379);&lt;/span&gt;
        &lt;span class="s"&gt;define('WP_REDIS_TIMEOUT', 1);&lt;/span&gt;
        &lt;span class="s"&gt;define('WP_REDIS_READ_TIMEOUT', 1);&lt;/span&gt;
        &lt;span class="s"&gt;define('WP_CACHE', true);&lt;/span&gt;
    &lt;span class="na"&gt;volumes&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;./wp_data:/var/www/html&lt;/span&gt;
    &lt;span class="na"&gt;networks&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;wp_internal&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;web_proxy&lt;/span&gt;

&lt;span class="na"&gt;networks&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;wp_internal&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;internal&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;
  &lt;span class="na"&gt;web_proxy&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;external&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  2. Tuning MariaDB: Stop Killing Your Disk I/O
&lt;/h2&gt;

&lt;p&gt;Default MariaDB installations allocate only 128MB to the InnoDB buffer pool. On a NAS, this forces MariaDB to constantly read and write table indices directly to slow SATA hard drives.&lt;/p&gt;

&lt;p&gt;Create &lt;code&gt;./mariadb_conf/my.cnf&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight ini"&gt;&lt;code&gt;&lt;span class="nn"&gt;[mysqld]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c"&gt;# Allocate 50-70% of available RAM allocated to this container
&lt;/span&gt;&lt;span class="py"&gt;innodb_buffer_pool_size&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;1G&lt;/span&gt;
&lt;span class="py"&gt;innodb_log_file_size&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;256M&lt;/span&gt;
&lt;span class="py"&gt;innodb_flush_log_at_trx_commit&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;2&lt;/span&gt;
&lt;span class="py"&gt;innodb_flush_method&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;O_DIRECT&lt;/span&gt;
&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c"&gt;# Connection and query cache settings
&lt;/span&gt;&lt;span class="py"&gt;max_connections&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;100&lt;/span&gt;
&lt;span class="py"&gt;query_cache_type&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;0&lt;/span&gt;
&lt;span class="py"&gt;query_cache_size&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;0&lt;/span&gt;
&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c"&gt;# Prevent slow reverse DNS lookups on internal container network
&lt;/span&gt;&lt;span class="na"&gt;skip-name-resolve&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;blockquote&gt;
&lt;p&gt;⚡ &lt;strong&gt;The Secret Sauce:&lt;/strong&gt; &lt;code&gt;innodb_flush_log_at_trx_commit = 2&lt;/code&gt; writes log buffers to disk once per second instead of on every single transaction commit. This reduces disk write IOPS by over 80% while remaining completely safe against OS crashes.&lt;/p&gt;
&lt;/blockquote&gt;




&lt;h2&gt;
  
  
  3. Enable Redis Object Caching
&lt;/h2&gt;

&lt;p&gt;Instead of querying MariaDB for post metadata, taxonomy terms, and options on every page load, Redis stores the parsed PHP objects in RAM:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Log into your WordPress admin dashboard (&lt;code&gt;/wp-admin&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;Go to &lt;strong&gt;Plugins&lt;/strong&gt; → &lt;strong&gt;Add New&lt;/strong&gt; and search for &lt;strong&gt;Redis Object Cache&lt;/strong&gt; by Till Krüss.&lt;/li&gt;
&lt;li&gt;Click &lt;strong&gt;Install&lt;/strong&gt; → &lt;strong&gt;Activate&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Go to &lt;strong&gt;Settings&lt;/strong&gt; → &lt;strong&gt;Redis&lt;/strong&gt; and click &lt;strong&gt;Enable Object Cache&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;You should see &lt;code&gt;Status: Connected&lt;/code&gt; with zero configuration needed (since we already injected the constants via &lt;code&gt;WORDPRESS_CONFIG_EXTRA&lt;/code&gt;).&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Your database queries will drop from 60-120 per page down to 2-4 queries.&lt;/p&gt;




&lt;h2&gt;
  
  
  4. Automated Daily Backup Script
&lt;/h2&gt;

&lt;p&gt;Never rely solely on NAS snapshots. Run a cron job that creates a clean SQL dump and compresses &lt;code&gt;wp-content&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;#!/bin/bash&lt;/span&gt;
&lt;span class="nv"&gt;BACKUP_DIR&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"/share/Backup/wordpress"&lt;/span&gt;
&lt;span class="nv"&gt;DATE&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="si"&gt;$(&lt;/span&gt;&lt;span class="nb"&gt;date&lt;/span&gt; +%Y%m%d_%H%M%S&lt;span class="si"&gt;)&lt;/span&gt;
&lt;span class="nb"&gt;mkdir&lt;/span&gt; &lt;span class="nt"&gt;-p&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="nv"&gt;$BACKUP_DIR&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt;

&lt;span class="c"&gt;# Dump database without locking tables&lt;/span&gt;
docker &lt;span class="nb"&gt;exec &lt;/span&gt;wp_mariadb mariadb-dump &lt;span class="nt"&gt;-u&lt;/span&gt; wp_user &lt;span class="nt"&gt;-pYourSuperSecureUserPassword_123&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt; &lt;span class="nt"&gt;--single-transaction&lt;/span&gt; wordpress | &lt;span class="nb"&gt;gzip&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="nv"&gt;$BACKUP_DIR&lt;/span&gt;&lt;span class="s2"&gt;/wp_db_&lt;/span&gt;&lt;span class="nv"&gt;$DATE&lt;/span&gt;&lt;span class="s2"&gt;.sql.gz"&lt;/span&gt;

&lt;span class="c"&gt;# Keep last 7 days of backups&lt;/span&gt;
find &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="nv"&gt;$BACKUP_DIR&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; &lt;span class="nt"&gt;-type&lt;/span&gt; f &lt;span class="nt"&gt;-name&lt;/span&gt; &lt;span class="s2"&gt;"*.sql.gz"&lt;/span&gt; &lt;span class="nt"&gt;-mtime&lt;/span&gt; +7 &lt;span class="nt"&gt;-delete&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  Conclusion
&lt;/h2&gt;

&lt;p&gt;Running WordPress on a NAS doesn't have to be slow. By using a lightweight Alpine-based FPM container, tuning MariaDB's InnoDB buffer pool to keep queries in memory, and offloading repetitive lookups to Redis, you get cloud-grade performance right from your local hardware.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Author: &lt;a href="https://alexmaina.dev/about/" rel="noopener noreferrer"&gt;Alessandro Mainardi&lt;/a&gt; — Software Developer &amp;amp; Systems Architect. Read the complete self-hosting and containerization guides at &lt;a href="https://alexmaina.dev/wordpress-su-nas/" rel="noopener noreferrer"&gt;alexmaina.dev/wordpress-su-nas&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>docker</category>
      <category>wordpress</category>
      <category>devops</category>
      <category>selfhosted</category>
    </item>
    <item>
      <title>Building a Zero-Cloud Medical Data Pipeline on Mobile (Apple HealthKit &amp; Health Connect)</title>
      <dc:creator>Alessandro Mainardi</dc:creator>
      <pubDate>Thu, 29 Oct 2026 14:00:57 +0000</pubDate>
      <link>https://dev.to/alexmaina/building-a-zero-cloud-medical-data-pipeline-on-mobile-apple-healthkit-health-connect-312m</link>
      <guid>https://dev.to/alexmaina/building-a-zero-cloud-medical-data-pipeline-on-mobile-apple-healthkit-health-connect-312m</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;📖 &lt;strong&gt;Original Reference:&lt;/strong&gt; Originally published with full architecture diagrams and cryptographic proofs at &lt;a href="https://alexmaina.dev/Health-App/" rel="noopener noreferrer"&gt;alexmaina.dev/Health-App&lt;/a&gt;. Technical monograph published on Zenodo (DOI: &lt;a href="https://doi.org/10.5281/zenodo.23735226" rel="noopener noreferrer"&gt;10.5281/zenodo.23735226&lt;/a&gt;).&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Most health apps ask you to upload blood test reports, doctor notes, and medical records to their backend servers for "AI processing" and parsing. For sensitive biometric and clinical data, this architecture introduces catastrophic compliance risks under GDPR Art. 9, HIPAA, and patient privacy expectations.&lt;/p&gt;

&lt;p&gt;When building &lt;a href="https://alexmaina.dev/Health-App/" rel="noopener noreferrer"&gt;RosettaEdge&lt;/a&gt; — an open-source clinical bridge for iOS and Android — we enforced an uncompromising constraint: &lt;strong&gt;Zero-Cloud Architecture&lt;/strong&gt;. 100% of data parsing, OCR extraction, database indexing, and health store synchronization happens entirely on the user's silicon.&lt;/p&gt;

&lt;p&gt;Here is how the on-device medical ingestion pipeline works, and how you can implement local health data ingestion in Swift and Kotlin.&lt;/p&gt;




&lt;h2&gt;
  
  
  1. The Ingestion Pipeline Architecture
&lt;/h2&gt;

&lt;p&gt;A clinical document usually arrives as an unstructured PDF (scanned or digitally exported from a hospital portal) or an XML file compliant with &lt;strong&gt;HL7 CDA Release 2&lt;/strong&gt; (Clinical Document Architecture).&lt;/p&gt;

&lt;p&gt;The local pipeline executes in 4 strictly isolated phases:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;[ Clinical PDF / CDA2 XML ]
             ↓ (1)
[ Local Memory Buffer (Secure Enclave / Keystore Key) ]
             ↓ (2)
[ Regex Tokenizer &amp;amp; LOINC / UCUM Normalizer ]
             ↓ (3)
[ Encrypted Local Vault (SQLCipher AES-256-GCM) ]
             ↓ (4)
[ HealthKit (iOS) / Health Connect (Android) Batch Sync ]
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  2. Parsing Clinical PDFs Locally without External APIs
&lt;/h2&gt;

&lt;p&gt;Instead of sending raw PDFs to cloud OCR APIs, modern mobile chips (Apple Neural Engine and Android ML Kit) can extract tabular clinical observations in sub-second execution times.&lt;/p&gt;

&lt;p&gt;Here is a simplified pattern in Swift using &lt;code&gt;PDFKit&lt;/code&gt; to extract lab parameters into structured clinical models:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight swift"&gt;&lt;code&gt;&lt;span class="kd"&gt;import&lt;/span&gt; &lt;span class="kt"&gt;Foundation&lt;/span&gt;
&lt;span class="kd"&gt;import&lt;/span&gt; &lt;span class="kt"&gt;PDFKit&lt;/span&gt;

&lt;span class="kd"&gt;public&lt;/span&gt; &lt;span class="kd"&gt;struct&lt;/span&gt; &lt;span class="kt"&gt;ClinicalObservation&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;public&lt;/span&gt; &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;parameterName&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;String&lt;/span&gt;
    &lt;span class="kd"&gt;public&lt;/span&gt; &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;value&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;
    &lt;span class="kd"&gt;public&lt;/span&gt; &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;unit&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;String&lt;/span&gt;
    &lt;span class="kd"&gt;public&lt;/span&gt; &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;referenceRange&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;ClosedRange&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="kt"&gt;Double&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;?&lt;/span&gt;
    &lt;span class="kd"&gt;public&lt;/span&gt; &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;loincCode&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;String&lt;/span&gt;&lt;span class="p"&gt;?&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="kd"&gt;public&lt;/span&gt; &lt;span class="kd"&gt;final&lt;/span&gt; &lt;span class="kd"&gt;class&lt;/span&gt; &lt;span class="kt"&gt;LocalLabExtractor&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;public&lt;/span&gt; &lt;span class="kd"&gt;static&lt;/span&gt; &lt;span class="kd"&gt;func&lt;/span&gt; &lt;span class="nf"&gt;parse&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;pdfDocument&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;PDFDocument&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="kt"&gt;ClinicalObservation&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="k"&gt;var&lt;/span&gt; &lt;span class="nv"&gt;observations&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="kt"&gt;ClinicalObservation&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[]&lt;/span&gt;
        &lt;span class="k"&gt;guard&lt;/span&gt; &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;pageCount&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kt"&gt;Optional&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;pdfDocument&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;pageCount&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt; &lt;span class="n"&gt;pageCount&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;[]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;

        &lt;span class="c1"&gt;// Fast-path text extraction directly from PDF vector stream&lt;/span&gt;
        &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;pageIndex&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="o"&gt;..&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;pageCount&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="k"&gt;guard&lt;/span&gt; &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;page&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;pdfDocument&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;page&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;at&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;pageIndex&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
                  &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;rawText&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;page&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;string&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="k"&gt;continue&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;

            &lt;span class="c1"&gt;// Regex matching: Parameter Name | Value | Unit | Reference Interval&lt;/span&gt;
            &lt;span class="c1"&gt;// Example match: "Emoglobina (Hb)  14.2 g/dL [13.0 - 17.5]"&lt;/span&gt;
            &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;pattern&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="err"&gt;#&lt;/span&gt;&lt;span class="s"&gt;"([A-Za-zÀ-ÿ&lt;/span&gt;&lt;span class="err"&gt;\&lt;/span&gt;&lt;span class="s"&gt;s&lt;/span&gt;&lt;span class="se"&gt;\(&lt;/span&gt;&lt;span class="p"&gt;\&lt;/span&gt;&lt;span class="se"&gt;)&lt;/span&gt;&lt;span class="s"&gt;]+)&lt;/span&gt;&lt;span class="err"&gt;\&lt;/span&gt;&lt;span class="s"&gt;s+([0-9]+[.,]?[0-9]*)&lt;/span&gt;&lt;span class="err"&gt;\&lt;/span&gt;&lt;span class="s"&gt;s+([a-zA-Z&lt;/span&gt;&lt;span class="err"&gt;\&lt;/span&gt;&lt;span class="s"&gt;/%]+)&lt;/span&gt;&lt;span class="err"&gt;\&lt;/span&gt;&lt;span class="s"&gt;s*(&lt;/span&gt;&lt;span class="err"&gt;\&lt;/span&gt;&lt;span class="s"&gt;[[0-9.,&lt;/span&gt;&lt;span class="err"&gt;\&lt;/span&gt;&lt;span class="s"&gt;s-]+&lt;/span&gt;&lt;span class="err"&gt;\&lt;/span&gt;&lt;span class="s"&gt;])?"&lt;/span&gt;&lt;span class="err"&gt;#&lt;/span&gt;
            &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;regex&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;try&lt;/span&gt;&lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="kt"&gt;NSRegularExpression&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;pattern&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;pattern&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;options&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[])&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
                &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;nsString&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;rawText&lt;/span&gt; &lt;span class="k"&gt;as&lt;/span&gt; &lt;span class="kt"&gt;NSString&lt;/span&gt;
                &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;matches&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;regex&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;matches&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;in&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;rawText&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;options&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[],&lt;/span&gt; &lt;span class="nv"&gt;range&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;NSRange&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;location&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;length&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;nsString&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;length&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;

                &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;match&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;matches&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
                    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;nsString&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;substring&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;with&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;match&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;range&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;at&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;trimmingCharacters&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;in&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;whitespacesAndNewlines&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
                    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;rawVal&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;nsString&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;substring&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;with&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;match&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;range&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;at&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;replacingOccurrences&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;of&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;","&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;with&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;"."&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
                    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;unit&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;nsString&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;substring&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;with&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;match&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;range&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;at&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;trimmingCharacters&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;in&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;whitespacesAndNewlines&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

                    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;doubleVal&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;rawVal&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
                        &lt;span class="n"&gt;observations&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;ClinicalObservation&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
                            &lt;span class="nv"&gt;parameterName&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                            &lt;span class="nv"&gt;value&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;doubleVal&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                            &lt;span class="nv"&gt;unit&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;unit&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                            &lt;span class="nv"&gt;referenceRange&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;nil&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                            &lt;span class="nv"&gt;loincCode&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;nil&lt;/span&gt;
                        &lt;span class="p"&gt;))&lt;/span&gt;
                    &lt;span class="p"&gt;}&lt;/span&gt;
                &lt;span class="p"&gt;}&lt;/span&gt;
            &lt;span class="p"&gt;}&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;
        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;observations&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  3. Standardizing to LOINC and UCUM
&lt;/h2&gt;

&lt;p&gt;Hospitals use dozens of informal variations for the same test (e.g., &lt;em&gt;"Glicemia"&lt;/em&gt;, &lt;em&gt;"Glucosio basale"&lt;/em&gt;, &lt;em&gt;"Fasting Glucose"&lt;/em&gt;). Apple HealthKit and Google Health Connect require standardized medical identifiers:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;LOINC (Logical Observation Identifiers Names and Codes)&lt;/strong&gt;: e.g., &lt;code&gt;2345-7&lt;/code&gt; for Glucose in blood.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;UCUM (Unified Code for Units of Measure)&lt;/strong&gt;: e.g., &lt;code&gt;mg/dL&lt;/code&gt; or &lt;code&gt;mmol/L&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Map your parsed names to LOINC codes via an embedded, pre-compiled lookup dictionary to guarantee zero network latency:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight swift"&gt;&lt;code&gt;&lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;loincRegistry&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="kt"&gt;String&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;loinc&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;String&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;hkType&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;HKQuantityTypeIdentifier&lt;/span&gt;&lt;span class="p"&gt;)]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="s"&gt;"glucosio"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s"&gt;"2345-7"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;bloodGlucose&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
    &lt;span class="s"&gt;"glicemia"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s"&gt;"2345-7"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;bloodGlucose&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
    &lt;span class="s"&gt;"emoglobina"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s"&gt;"718-7"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;bloodPressureSystolic&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="c1"&gt;// Map to matching HealthKit identifier&lt;/span&gt;
&lt;span class="p"&gt;]&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  4. Writing into HealthKit with Idempotent Deduplication
&lt;/h2&gt;

&lt;p&gt;The most common bug when importing health documents is &lt;strong&gt;duplicate samples&lt;/strong&gt;: if the user imports the same laboratory report twice, HealthKit will chart double entries.&lt;/p&gt;

&lt;p&gt;Always attach an idempotent metadata key (&lt;code&gt;HKMetadataKeyExternalUUID&lt;/code&gt;) derived from the SHA-256 hash of &lt;code&gt;(TestDate + LOINC + Value)&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight swift"&gt;&lt;code&gt;&lt;span class="kd"&gt;import&lt;/span&gt; &lt;span class="kt"&gt;HealthKit&lt;/span&gt;
&lt;span class="kd"&gt;import&lt;/span&gt; &lt;span class="kt"&gt;CryptoKit&lt;/span&gt;

&lt;span class="kd"&gt;func&lt;/span&gt; &lt;span class="nf"&gt;saveToHealthKit&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;store&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;HKHealthStore&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;obs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;ClinicalObservation&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;sampleDate&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Date&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="k"&gt;throws&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;guard&lt;/span&gt; &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;quantityType&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kt"&gt;HKQuantityType&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;quantityType&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;forIdentifier&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;bloodGlucose&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="c1"&gt;// Generate deterministic hash for deduplication&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;hashPayload&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;"&lt;/span&gt;&lt;span class="se"&gt;\(&lt;/span&gt;&lt;span class="n"&gt;obs&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;parameterName&lt;/span&gt;&lt;span class="se"&gt;)&lt;/span&gt;&lt;span class="s"&gt;_&lt;/span&gt;&lt;span class="se"&gt;\(&lt;/span&gt;&lt;span class="n"&gt;obs&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="se"&gt;)&lt;/span&gt;&lt;span class="s"&gt;_&lt;/span&gt;&lt;span class="se"&gt;\(&lt;/span&gt;&lt;span class="n"&gt;sampleDate&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;timeIntervalSince1970&lt;/span&gt;&lt;span class="se"&gt;)&lt;/span&gt;&lt;span class="s"&gt;"&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;externalId&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kt"&gt;SHA256&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;hash&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;data&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Data&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;hashPayload&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;utf8&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;compactMap&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="kt"&gt;String&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;format&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;"%02x"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;$0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;joined&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;

    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;quantity&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kt"&gt;HKQuantity&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;unit&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;HKUnit&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;from&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;"mg/dL"&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt; &lt;span class="nv"&gt;doubleValue&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;obs&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;sample&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kt"&gt;HKQuantitySample&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="nv"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;quantityType&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="nv"&gt;quantity&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;quantity&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="nv"&gt;start&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;sampleDate&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="nv"&gt;end&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;sampleDate&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="nv"&gt;metadata&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
            &lt;span class="kt"&gt;HKMetadataKeyExternalUUID&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;externalId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="kt"&gt;HKMetadataKeySyncVersion&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;
        &lt;span class="p"&gt;]&lt;/span&gt;
    &lt;span class="p"&gt;)&lt;/span&gt;

    &lt;span class="k"&gt;try&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;store&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;save&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;sample&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  5. Security &amp;amp; Zero-Cloud Guarantees
&lt;/h2&gt;

&lt;p&gt;To ensure complete patient privacy:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;No External Analytics SDKs&lt;/strong&gt;: Strip Firebase, Mixpanel, and third-party trackers.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Encrypted Storage&lt;/strong&gt;: Index document metadata in a local SQLite database encrypted with &lt;strong&gt;SQLCipher (AES-256-GCM)&lt;/strong&gt;, with the master key stored in the platform's hardware key store (iOS Secure Enclave / Android Keystore).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Biometric Vault&lt;/strong&gt;: Protect the database access gate with Face ID, Touch ID, or BiometricPrompt.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  Conclusion
&lt;/h2&gt;

&lt;p&gt;Mobile operating systems now have sufficient hardware performance to process, parse, and analyze unstructured medical documents without depending on remote servers. Designing for zero-cloud architecture is not just better for privacy — it also eliminates server infrastructure costs and guarantees instant offline functionality.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Author: &lt;a href="https://alexmaina.dev/about/" rel="noopener noreferrer"&gt;Alessandro Mainardi&lt;/a&gt; — Computer Engineering Student @ UniBo &amp;amp; Developer of RosettaEdge. Read the 44-page technical monograph at &lt;a href="https://alexmaina.dev/Health-App/" rel="noopener noreferrer"&gt;alexmaina.dev/Health-App&lt;/a&gt; or on &lt;a href="https://doi.org/10.5281/zenodo.23735226" rel="noopener noreferrer"&gt;Zenodo&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ios</category>
      <category>android</category>
      <category>privacy</category>
      <category>security</category>
    </item>
    <item>
      <title>How to Fix WordPress "Too Many Redirects" in Docker behind Reverse Proxy</title>
      <dc:creator>Alessandro Mainardi</dc:creator>
      <pubDate>Wed, 28 Oct 2026 08:49:05 +0000</pubDate>
      <link>https://dev.to/alexmaina/how-to-fix-wordpress-too-many-redirects-in-docker-behind-reverse-proxy-27io</link>
      <guid>https://dev.to/alexmaina/how-to-fix-wordpress-too-many-redirects-in-docker-behind-reverse-proxy-27io</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;📖 &lt;strong&gt;Original Reference:&lt;/strong&gt; Originally published with full architecture diagrams and server configuration templates at &lt;a href="https://alexmaina.dev/wordpress-docker-redirect-loop/" rel="noopener noreferrer"&gt;alexmaina.dev/wordpress-docker-redirect-loop&lt;/a&gt;.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Running WordPress inside Docker behind a reverse proxy (like &lt;strong&gt;Nginx Proxy Manager&lt;/strong&gt;, &lt;strong&gt;Traefik&lt;/strong&gt;, &lt;strong&gt;Caddy&lt;/strong&gt;, or &lt;strong&gt;Cloudflare&lt;/strong&gt;) often leads to the dreaded browser error:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;ERR_TOO_MANY_REDIRECTS
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The browser gets trapped in an infinite HTTP 301 loop. Here is why this happens and how to permanently fix it in under 60 seconds.&lt;/p&gt;




&lt;h2&gt;
  
  
  ⚡ The 30-Second Solution
&lt;/h2&gt;

&lt;p&gt;Open your WordPress volume mount and edit &lt;code&gt;wp-config.php&lt;/code&gt;. Paste this snippet &lt;strong&gt;BEFORE&lt;/strong&gt; the line &lt;code&gt;/* That's all, stop editing! Happy publishing. */&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Trust HTTPS termination from your Reverse Proxy&lt;/span&gt;
&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;isset&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$_SERVER&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'HTTP_X_FORWARDED_PROTO'&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nb"&gt;strpos&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$_SERVER&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'HTTP_X_FORWARDED_PROTO'&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="s1"&gt;'https'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nv"&gt;$_SERVER&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'HTTPS'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;'on'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="nb"&gt;define&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'WP_HOME'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'https://yourdomain.com'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="nb"&gt;define&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'WP_SITEURL'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'https://yourdomain.com'&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="nb"&gt;define&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'FORCE_SSL_ADMIN'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  1. Anatomy of the Loop: Why Does it Happen?
&lt;/h2&gt;

&lt;p&gt;In a modern containerized stack:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;The user requests &lt;code&gt;https://yourdomain.com&lt;/code&gt; (encrypted on port &lt;strong&gt;443&lt;/strong&gt;).&lt;/li&gt;
&lt;li&gt;The Reverse Proxy terminates the SSL session (decrypts the traffic) and forwards the request internally to the WordPress container via HTTP on port &lt;strong&gt;80&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Inside the container, PHP checks &lt;code&gt;$_SERVER['HTTPS']&lt;/code&gt;. Because internal Docker network communication is unencrypted, &lt;code&gt;$_SERVER['HTTPS']&lt;/code&gt; is empty or &lt;code&gt;off&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;WordPress sees that its configured site URL is HTTPS, thinks the visitor accessed via insecure HTTP, and responds with an &lt;code&gt;HTTP 301 Moved Permanently&lt;/code&gt; directing back to &lt;code&gt;https://yourdomain.com&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;The browser follows the redirect, the proxy intercepts it again on port 443, forwards it via port 80, and the cycle repeats infinitely until the browser throws &lt;code&gt;ERR_TOO_MANY_REDIRECTS&lt;/code&gt;.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  2. Nginx Reverse Proxy Headers
&lt;/h2&gt;

&lt;p&gt;Ensure your upstream Nginx proxy passes the correct forwarded protocol headers:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight nginx"&gt;&lt;code&gt;&lt;span class="k"&gt;server&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kn"&gt;listen&lt;/span&gt; &lt;span class="mi"&gt;443&lt;/span&gt; &lt;span class="s"&gt;ssl&lt;/span&gt; &lt;span class="s"&gt;http2&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="kn"&gt;server_name&lt;/span&gt; &lt;span class="s"&gt;yourdomain.com&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="kn"&gt;location&lt;/span&gt; &lt;span class="n"&gt;/&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="kn"&gt;proxy_pass&lt;/span&gt; &lt;span class="s"&gt;http://wordpress_container:80&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="kn"&gt;proxy_set_header&lt;/span&gt; &lt;span class="s"&gt;Host&lt;/span&gt; &lt;span class="nv"&gt;$host&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="kn"&gt;proxy_set_header&lt;/span&gt; &lt;span class="s"&gt;X-Real-IP&lt;/span&gt; &lt;span class="nv"&gt;$remote_addr&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="kn"&gt;proxy_set_header&lt;/span&gt; &lt;span class="s"&gt;X-Forwarded-For&lt;/span&gt; &lt;span class="nv"&gt;$proxy_add_x_forwarded_for&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="kn"&gt;proxy_set_header&lt;/span&gt; &lt;span class="s"&gt;X-Forwarded-Proto&lt;/span&gt; &lt;span class="nv"&gt;$scheme&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;If using &lt;strong&gt;Nginx Proxy Manager (NPM)&lt;/strong&gt;:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Under &lt;strong&gt;Details&lt;/strong&gt;: Scheme is &lt;code&gt;http&lt;/code&gt;, Forward Host is the container name, Port is &lt;code&gt;80&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Under &lt;strong&gt;SSL&lt;/strong&gt;: Enable &lt;em&gt;Force SSL&lt;/em&gt; and &lt;em&gt;HTTP/2 Support&lt;/em&gt;.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  3. The Cloudflare Trap: Flexible vs Full (Strict)
&lt;/h2&gt;

&lt;p&gt;If your DNS is proxied through &lt;strong&gt;Cloudflare&lt;/strong&gt; (orange cloud active):&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Never use Flexible SSL:&lt;/strong&gt; Flexible instructs Cloudflare to contact your origin server strictly on port 80 (HTTP). If WordPress enforces HTTPS, Cloudflare and your origin will bounce redirects back and forth indefinitely.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Fix:&lt;/strong&gt; Change your Cloudflare SSL/TLS encryption mode to &lt;strong&gt;Full&lt;/strong&gt; or &lt;strong&gt;Full (Strict)&lt;/strong&gt;.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  4. Verification with cURL
&lt;/h2&gt;

&lt;p&gt;Run this terminal command to test the raw HTTP status without browser cache pollution:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl &lt;span class="nt"&gt;-ILs&lt;/span&gt; &lt;span class="nt"&gt;-o&lt;/span&gt; /dev/null &lt;span class="nt"&gt;-w&lt;/span&gt; &lt;span class="s2"&gt;"%{http_code} -&amp;gt; %{url_effective}&lt;/span&gt;&lt;span class="se"&gt;\n&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; https://yourdomain.com
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Expected output:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;200 -&amp;gt; https://yourdomain.com/
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;If you see 20 consecutive &lt;code&gt;301 -&amp;gt; ...&lt;/code&gt; lines, the PHP block was either placed too late in &lt;code&gt;wp-config.php&lt;/code&gt; or the reverse proxy is stripping the &lt;code&gt;X-Forwarded-Proto&lt;/code&gt; header.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Author: &lt;a href="https://alexmaina.dev/about/" rel="noopener noreferrer"&gt;Alessandro Mainardi&lt;/a&gt; — Software Developer &amp;amp; Computer Engineering Student @ UniBo. Explore more self-hosting &amp;amp; Docker guides at &lt;a href="https://alexmaina.dev/" rel="noopener noreferrer"&gt;alexmaina.dev&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>docker</category>
      <category>wordpress</category>
      <category>nginx</category>
      <category>devops</category>
    </item>
    <item>
      <title>Access Your Homelab Remotely without Port Forwarding (Bypass CGNAT with Tailscale)</title>
      <dc:creator>Alessandro Mainardi</dc:creator>
      <pubDate>Wed, 28 Oct 2026 08:48:18 +0000</pubDate>
      <link>https://dev.to/alexmaina/access-your-homelab-remotely-without-port-forwarding-bypass-cgnat-with-tailscale-43e8</link>
      <guid>https://dev.to/alexmaina/access-your-homelab-remotely-without-port-forwarding-bypass-cgnat-with-tailscale-43e8</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;📖 &lt;strong&gt;Original Reference:&lt;/strong&gt; Originally published with zero-trust network topologies at &lt;a href="https://alexmaina.dev/tailscale-pihole-homelab-cgnat/" rel="noopener noreferrer"&gt;alexmaina.dev/tailscale-pihole-homelab-cgnat&lt;/a&gt;.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;With modern fiber (FTTH), cellular 5G, or Starlink connections, most ISPs place customer routers behind &lt;strong&gt;CGNAT (Carrier-Grade NAT)&lt;/strong&gt;. Under CGNAT, you do not have a public IPv4 address, rendering classic port forwarding completely useless.&lt;/p&gt;

&lt;p&gt;Even if you have a public IP, opening ports (like port 22 or WireGuard port 51820) exposes your home router to 24/7 automated port scanners and brute-force attacks.&lt;/p&gt;

&lt;p&gt;Here is how to set up a &lt;strong&gt;Tailscale Subnet Router&lt;/strong&gt; with &lt;strong&gt;Pi-hole MagicDNS&lt;/strong&gt; to gain zero-trust, encrypted remote access to every device on your home network without opening a single port.&lt;/p&gt;




&lt;h2&gt;
  
  
  1. Why a Subnet Router?
&lt;/h2&gt;

&lt;p&gt;Instead of installing the Tailscale client on every single device (which is impossible for IoT gear, network printers, IP cameras, or legacy hardware), a &lt;strong&gt;Subnet Router&lt;/strong&gt; acts as a secure gateway:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;One always-on Linux host (Raspberry Pi, mini PC, or VM) acts as the bridge.&lt;/li&gt;
&lt;li&gt;When you enable Tailscale on your laptop or phone while travelling, you can access &lt;code&gt;192.168.1.x&lt;/code&gt; IPs exactly as if you were on your home Wi-Fi.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  2. Configure the Linux Gateway
&lt;/h2&gt;

&lt;p&gt;SSH into your Linux machine and execute:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# 1. Install Tailscale&lt;/span&gt;
curl &lt;span class="nt"&gt;-fsSL&lt;/span&gt; https://tailscale.com/install.sh | sh

&lt;span class="c"&gt;# 2. Enable IP packet forwarding in Linux kernel&lt;/span&gt;
&lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s1"&gt;'net.ipv4.ip_forward = 1'&lt;/span&gt; | &lt;span class="nb"&gt;sudo tee&lt;/span&gt; &lt;span class="nt"&gt;-a&lt;/span&gt; /etc/sysctl.d/99-tailscale.conf
&lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s1"&gt;'net.ipv6.conf.all.forwarding = 1'&lt;/span&gt; | &lt;span class="nb"&gt;sudo tee&lt;/span&gt; &lt;span class="nt"&gt;-a&lt;/span&gt; /etc/sysctl.d/99-tailscale.conf
&lt;span class="nb"&gt;sudo &lt;/span&gt;sysctl &lt;span class="nt"&gt;-p&lt;/span&gt; /etc/sysctl.d/99-tailscale.conf

&lt;span class="c"&gt;# 3. Advertise your local subnet (adjust 192.168.1.0/24 to your LAN subnet)&lt;/span&gt;
&lt;span class="nb"&gt;sudo &lt;/span&gt;tailscale up &lt;span class="nt"&gt;--advertise-routes&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;192.168.1.0/24 &lt;span class="nt"&gt;--accept-dns&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nb"&gt;false&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  3. Approve Subnet Routes in Tailscale Console
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;Open the &lt;a href="https://login.tailscale.com/admin/machines" rel="noopener noreferrer"&gt;Tailscale Admin Machines Console&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;Locate your gateway device and look for the &lt;strong&gt;Subnets&lt;/strong&gt; badge.&lt;/li&gt;
&lt;li&gt;Click the three dots &lt;strong&gt;(...)&lt;/strong&gt; → &lt;strong&gt;Edit route settings...&lt;/strong&gt;
&lt;/li&gt;
&lt;li&gt;Check the box for your subnet (e.g. &lt;code&gt;192.168.1.0/24&lt;/code&gt;) and click &lt;strong&gt;Save&lt;/strong&gt;.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  4. Integrate Pi-hole for Global Ad-Blocking &amp;amp; Local DNS
&lt;/h2&gt;

&lt;p&gt;If you have &lt;strong&gt;Pi-hole&lt;/strong&gt; or &lt;strong&gt;AdGuard Home&lt;/strong&gt; running in your homelab:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;In the Tailscale Admin Console, go to &lt;strong&gt;DNS&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Under &lt;strong&gt;Nameservers&lt;/strong&gt;, click &lt;strong&gt;Add nameserver&lt;/strong&gt; → &lt;strong&gt;Custom...&lt;/strong&gt;
&lt;/li&gt;
&lt;li&gt;Enter your Pi-hole's local IP (e.g. &lt;code&gt;192.168.1.50&lt;/code&gt;) or Tailscale IP (&lt;code&gt;100.x.y.z&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;Toggle &lt;strong&gt;Override local DNS&lt;/strong&gt; ON.&lt;/li&gt;
&lt;/ol&gt;

&lt;h3&gt;
  
  
  The Result:
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Seamless encrypted access to Proxmox, NAS storage, and local servers from anywhere.&lt;/li&gt;
&lt;li&gt;Network-wide ad-blocking and tracker filtering active on your phone and laptop wherever you travel.&lt;/li&gt;
&lt;li&gt;Zero ports forwarded on your home router.&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Author: &lt;a href="https://alexmaina.dev/about/" rel="noopener noreferrer"&gt;Alessandro Mainardi&lt;/a&gt; — Software Developer &amp;amp; Computer Engineering Student @ UniBo. Explore homelab setups at &lt;a href="https://alexmaina.dev/" rel="noopener noreferrer"&gt;alexmaina.dev&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>tailscale</category>
      <category>homelab</category>
      <category>networking</category>
      <category>security</category>
    </item>
    <item>
      <title>QNAP Container Station: Free Up Ports 80 &amp; 443 for Docker Reverse Proxy</title>
      <dc:creator>Alessandro Mainardi</dc:creator>
      <pubDate>Wed, 28 Oct 2026 08:47:26 +0000</pubDate>
      <link>https://dev.to/alexmaina/qnap-container-station-free-up-ports-80-443-for-docker-reverse-proxy-53b7</link>
      <guid>https://dev.to/alexmaina/qnap-container-station-free-up-ports-80-443-for-docker-reverse-proxy-53b7</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;📖 &lt;strong&gt;Original Reference:&lt;/strong&gt; Originally published with complete step-by-step storage configurations at &lt;a href="https://alexmaina.dev/qnap-docker-reverse-proxy/" rel="noopener noreferrer"&gt;alexmaina.dev/qnap-docker-reverse-proxy&lt;/a&gt;.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;When trying to deploy a Reverse Proxy (like &lt;strong&gt;Nginx Proxy Manager&lt;/strong&gt;, &lt;strong&gt;Traefik&lt;/strong&gt;, or &lt;strong&gt;Caddy&lt;/strong&gt;) inside QNAP's &lt;strong&gt;Container Station&lt;/strong&gt;, Docker will fail with:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Error response from daemon: driver failed programming external connectivity on endpoint: bind: address already in use
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This happens because QNAP's operating system (&lt;strong&gt;QTS&lt;/strong&gt; or &lt;strong&gt;QuTS hero&lt;/strong&gt;) occupies port 80 and port 443 by default for its administrative interface and built-in web server.&lt;/p&gt;

&lt;p&gt;Here is how to liberate both ports cleanly and set up a centralized reverse proxy without breaking access to your NAS.&lt;/p&gt;




&lt;h2&gt;
  
  
  Step 1: Move QTS Admin System Ports
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;Log into your QTS web dashboard.&lt;/li&gt;
&lt;li&gt;Go to &lt;strong&gt;Control Panel&lt;/strong&gt; → &lt;strong&gt;System&lt;/strong&gt; → &lt;strong&gt;General Settings&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Under the &lt;strong&gt;System Administration&lt;/strong&gt; section:

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;System port (HTTP):&lt;/strong&gt; Change from &lt;code&gt;8080&lt;/code&gt; (or &lt;code&gt;80&lt;/code&gt;) to &lt;code&gt;8088&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Enable secure connection (HTTPS):&lt;/strong&gt; Change from &lt;code&gt;443&lt;/code&gt; (or &lt;code&gt;4433&lt;/code&gt;) to &lt;strong&gt;&lt;code&gt;8443&lt;/code&gt;&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Uncheck:&lt;/strong&gt; &lt;em&gt;"Redirect HTTP connection to HTTPS"&lt;/em&gt; if bound to port 80.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;Click &lt;strong&gt;Apply&lt;/strong&gt;. Your browser will reload at &lt;code&gt;https://NAS-IP:8443&lt;/code&gt;.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  Step 2: Disable the Built-in Apache Web Server
&lt;/h2&gt;

&lt;p&gt;Even with admin ports moved, QTS runs a background Apache server that listens on port 80.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;In Control Panel, navigate to &lt;strong&gt;Applications&lt;/strong&gt; → &lt;strong&gt;Web Server&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Uncheck &lt;strong&gt;Enable Web Server&lt;/strong&gt; (or change its listening ports to &lt;code&gt;8085&lt;/code&gt; and &lt;code&gt;8445&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;Click &lt;strong&gt;Apply&lt;/strong&gt;.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Ports 80 and 443 are now completely free on the physical network interface!&lt;/p&gt;




&lt;h2&gt;
  
  
  Step 3: Deploy Nginx Proxy Manager with Docker Compose
&lt;/h2&gt;

&lt;p&gt;Open &lt;strong&gt;Container Station&lt;/strong&gt; → &lt;strong&gt;Applications&lt;/strong&gt; → &lt;strong&gt;Create&lt;/strong&gt;, and paste this clean &lt;code&gt;docker-compose.yml&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;version&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'&lt;/span&gt;&lt;span class="s"&gt;3.8'&lt;/span&gt;

&lt;span class="na"&gt;services&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;npm-app&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;image&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'&lt;/span&gt;&lt;span class="s"&gt;jc21/nginx-proxy-manager:latest'&lt;/span&gt;
    &lt;span class="na"&gt;container_name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;nginx-proxy-manager&lt;/span&gt;
    &lt;span class="na"&gt;restart&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;unless-stopped&lt;/span&gt;
    &lt;span class="na"&gt;ports&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s1"&gt;'&lt;/span&gt;&lt;span class="s"&gt;80:80'&lt;/span&gt;    &lt;span class="c1"&gt;# Public HTTP port now available&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s1"&gt;'&lt;/span&gt;&lt;span class="s"&gt;443:443'&lt;/span&gt;  &lt;span class="c1"&gt;# Public HTTPS port now available&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s1"&gt;'&lt;/span&gt;&lt;span class="s"&gt;81:81'&lt;/span&gt;    &lt;span class="c1"&gt;# NPM Web Admin Dashboard&lt;/span&gt;
    &lt;span class="na"&gt;environment&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="na"&gt;DB_MYSQL_HOST&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;npm-db"&lt;/span&gt;
      &lt;span class="na"&gt;DB_MYSQL_PORT&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="m"&gt;3306&lt;/span&gt;
      &lt;span class="na"&gt;DB_MYSQL_USER&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;npm"&lt;/span&gt;
      &lt;span class="na"&gt;DB_MYSQL_PASSWORD&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;SuperSecureDBPassword2026!"&lt;/span&gt;
      &lt;span class="na"&gt;DB_MYSQL_NAME&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;npm"&lt;/span&gt;
    &lt;span class="na"&gt;volumes&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;/share/Container/npm/data:/data&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;/share/Container/npm/letsencrypt:/etc/letsencrypt&lt;/span&gt;
    &lt;span class="na"&gt;depends_on&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;npm-db&lt;/span&gt;
    &lt;span class="na"&gt;networks&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;homelab-net&lt;/span&gt;

  &lt;span class="na"&gt;npm-db&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;image&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'&lt;/span&gt;&lt;span class="s"&gt;mariadb:10.11'&lt;/span&gt;
    &lt;span class="na"&gt;container_name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;npm-database&lt;/span&gt;
    &lt;span class="na"&gt;restart&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;unless-stopped&lt;/span&gt;
    &lt;span class="na"&gt;environment&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="na"&gt;MYSQL_ROOT_PASSWORD&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;RootSecretPassword2026!"&lt;/span&gt;
      &lt;span class="na"&gt;MYSQL_DATABASE&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;npm"&lt;/span&gt;
      &lt;span class="na"&gt;MYSQL_USER&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;npm"&lt;/span&gt;
      &lt;span class="na"&gt;MYSQL_PASSWORD&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;SuperSecureDBPassword2026!"&lt;/span&gt;
    &lt;span class="na"&gt;volumes&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;/share/Container/npm/mysql:/var/lib/mysql&lt;/span&gt;
    &lt;span class="na"&gt;networks&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="s"&gt;homelab-net&lt;/span&gt;

&lt;span class="na"&gt;networks&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;homelab-net&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;homelab-net&lt;/span&gt;
    &lt;span class="na"&gt;driver&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;bridge&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  Step 4: Route Container Traffic Internally
&lt;/h2&gt;

&lt;p&gt;With all your containers attached to &lt;code&gt;homelab-net&lt;/code&gt;:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;You &lt;strong&gt;no longer need to expose ports&lt;/strong&gt; to the host for individual services (WordPress, Nextcloud, etc.).&lt;/li&gt;
&lt;li&gt;Access NPM dashboard at &lt;code&gt;http://NAS-IP:81&lt;/code&gt; (Default credentials: &lt;code&gt;admin@example.com&lt;/code&gt; / &lt;code&gt;changeme&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;Add a &lt;strong&gt;Proxy Host&lt;/strong&gt; with your domain name and set &lt;em&gt;Forward Hostname&lt;/em&gt; to the internal container name (e.g. &lt;code&gt;wordpress-app&lt;/code&gt;) on port &lt;code&gt;80&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Request a free &lt;strong&gt;Let's Encrypt SSL certificate&lt;/strong&gt; directly through NPM.&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Author: &lt;a href="https://alexmaina.dev/about/" rel="noopener noreferrer"&gt;Alessandro Mainardi&lt;/a&gt; — Software Developer &amp;amp; Computer Engineering Student @ UniBo. Explore homelab architectures at &lt;a href="https://alexmaina.dev/" rel="noopener noreferrer"&gt;alexmaina.dev&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>qnap</category>
      <category>docker</category>
      <category>homelab</category>
      <category>selfhosted</category>
    </item>
    <item>
      <title>Speed Up Python CI/CD 10x with uv: Migration from Pip &amp; Poetry</title>
      <dc:creator>Alessandro Mainardi</dc:creator>
      <pubDate>Wed, 28 Oct 2026 08:46:44 +0000</pubDate>
      <link>https://dev.to/alexmaina/speed-up-python-cicd-10x-with-uv-migration-from-pip-poetry-18n0</link>
      <guid>https://dev.to/alexmaina/speed-up-python-cicd-10x-with-uv-migration-from-pip-poetry-18n0</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;📖 &lt;strong&gt;Original Reference:&lt;/strong&gt; Originally published with performance benchmarks and deployment pipelines at &lt;a href="https://alexmaina.dev/python-uv-github-actions/" rel="noopener noreferrer"&gt;alexmaina.dev/python-uv-github-actions&lt;/a&gt;.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;In standard Python CI/CD pipelines, &lt;code&gt;pip install&lt;/code&gt; or &lt;code&gt;poetry install&lt;/code&gt; is notoriously slow, burning 2 to 5 billable minutes on every commit just resolving wheel dependencies.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;uv&lt;/strong&gt;, created in Rust by Astral (the authors of Ruff), is an extremely fast Python package and project manager designed as a drop-in replacement for Pip, Pip-tools, Virtualenv, and Poetry.&lt;/p&gt;

&lt;p&gt;Here is how to migrate an existing project, lock dependencies with &lt;code&gt;uv.lock&lt;/code&gt;, and reduce your GitHub Actions workflow times from minutes to seconds.&lt;/p&gt;




&lt;h2&gt;
  
  
  1. Quick Migration Commands
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Install uv (Linux/macOS)&lt;/span&gt;
curl &lt;span class="nt"&gt;-LsSf&lt;/span&gt; https://astral.sh/uv/install.sh | sh

&lt;span class="c"&gt;# Install uv (Windows PowerShell)&lt;/span&gt;
powershell &lt;span class="nt"&gt;-ExecutionPolicy&lt;/span&gt; ByPass &lt;span class="nt"&gt;-c&lt;/span&gt; &lt;span class="s2"&gt;"irm https://astral.sh/uv/install.ps1 | iex"&lt;/span&gt;

&lt;span class="c"&gt;# Initialize standard PEP 621 project&lt;/span&gt;
uv init my-project
&lt;span class="nb"&gt;cd &lt;/span&gt;my-project

&lt;span class="c"&gt;# Add dependencies with automatic lockfile update&lt;/span&gt;
uv add fastapi uvicorn &lt;span class="s2"&gt;"pydantic&amp;gt;=2.0"&lt;/span&gt;
uv add &lt;span class="nt"&gt;--dev&lt;/span&gt; pytest ruff

&lt;span class="c"&gt;# Run tests instantly in isolated environment&lt;/span&gt;
uv run pytest
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  2. Optimized GitHub Actions Workflow
&lt;/h2&gt;

&lt;p&gt;In &lt;code&gt;.github/workflows/ci.yml&lt;/code&gt;, leverage the official &lt;code&gt;astral-sh/setup-uv&lt;/code&gt; action with built-in cache keying:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Test &amp;amp; Lint Python&lt;/span&gt;

&lt;span class="na"&gt;on&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;push&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;branches&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="pi"&gt;[&lt;/span&gt;&lt;span class="nv"&gt;main&lt;/span&gt;&lt;span class="pi"&gt;]&lt;/span&gt;
  &lt;span class="na"&gt;pull_request&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;

&lt;span class="na"&gt;jobs&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;test&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;runs-on&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;ubuntu-latest&lt;/span&gt;
    &lt;span class="na"&gt;steps&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;actions/checkout@v4&lt;/span&gt;

      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Setup uv with automatic dependency caching&lt;/span&gt;
        &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;astral-sh/setup-uv@v5&lt;/span&gt;
        &lt;span class="na"&gt;with&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;version&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;latest"&lt;/span&gt;
          &lt;span class="na"&gt;enable-cache&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;
          &lt;span class="na"&gt;cache-dependency-glob&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;uv.lock"&lt;/span&gt;

      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Install required Python version&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;uv python install &lt;/span&gt;&lt;span class="m"&gt;3.12&lt;/span&gt;

      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Sync dependencies from lockfile&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;uv sync --frozen --all-extras --dev&lt;/span&gt;

      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Lint with Ruff&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;uv run ruff check .&lt;/span&gt;

      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Run Pytest&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;uv run pytest --maxfail=1 -q&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  3. Production Multi-Stage Dockerfile
&lt;/h2&gt;

&lt;p&gt;Use uv during the build stage to compile wheels and copy strictly the finalized &lt;code&gt;.venv&lt;/code&gt; into the production runtime container:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight docker"&gt;&lt;code&gt;&lt;span class="c"&gt;# STAGE 1: Dependency resolution &amp;amp; build&lt;/span&gt;
&lt;span class="k"&gt;FROM&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;ghcr.io/astral-sh/uv:python3.12-bookworm-slim&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;AS&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;builder&lt;/span&gt;

&lt;span class="k"&gt;WORKDIR&lt;/span&gt;&lt;span class="s"&gt; /app&lt;/span&gt;
&lt;span class="k"&gt;ENV&lt;/span&gt;&lt;span class="s"&gt; UV_COMPILE_BYTECODE=1 \&lt;/span&gt;
    UV_LINK_MODE=copy

&lt;span class="k"&gt;COPY&lt;/span&gt;&lt;span class="s"&gt; pyproject.toml uv.lock ./&lt;/span&gt;
&lt;span class="k"&gt;RUN &lt;/span&gt;uv &lt;span class="nb"&gt;sync&lt;/span&gt; &lt;span class="nt"&gt;--frozen&lt;/span&gt; &lt;span class="nt"&gt;--no-dev&lt;/span&gt; &lt;span class="nt"&gt;--no-install-project&lt;/span&gt;

&lt;span class="k"&gt;COPY&lt;/span&gt;&lt;span class="s"&gt; . .&lt;/span&gt;
&lt;span class="k"&gt;RUN &lt;/span&gt;uv &lt;span class="nb"&gt;sync&lt;/span&gt; &lt;span class="nt"&gt;--frozen&lt;/span&gt; &lt;span class="nt"&gt;--no-dev&lt;/span&gt;

&lt;span class="c"&gt;# STAGE 2: Minimal runtime image&lt;/span&gt;
&lt;span class="k"&gt;FROM&lt;/span&gt;&lt;span class="s"&gt; python:3.12-slim-bookworm&lt;/span&gt;

&lt;span class="k"&gt;WORKDIR&lt;/span&gt;&lt;span class="s"&gt; /app&lt;/span&gt;
&lt;span class="k"&gt;COPY&lt;/span&gt;&lt;span class="s"&gt; --from=builder /app/.venv /app/.venv&lt;/span&gt;
&lt;span class="k"&gt;COPY&lt;/span&gt;&lt;span class="s"&gt; . /app&lt;/span&gt;

&lt;span class="k"&gt;ENV&lt;/span&gt;&lt;span class="s"&gt; PATH="/app/.venv/bin:$PATH"&lt;/span&gt;

&lt;span class="k"&gt;EXPOSE&lt;/span&gt;&lt;span class="s"&gt; 8000&lt;/span&gt;
&lt;span class="k"&gt;CMD&lt;/span&gt;&lt;span class="s"&gt; ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;p&gt;&lt;em&gt;Author: &lt;a href="https://alexmaina.dev/about/" rel="noopener noreferrer"&gt;Alessandro Mainardi&lt;/a&gt; — Software Developer &amp;amp; Computer Engineering Student @ UniBo. Explore modern tooling and software engineering guides at &lt;a href="https://alexmaina.dev/" rel="noopener noreferrer"&gt;alexmaina.dev&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>python</category>
      <category>githubactions</category>
      <category>devops</category>
      <category>rust</category>
    </item>
    <item>
      <title>Keep Your Microsoft 365 E5 Developer Tenant Active Automatically</title>
      <dc:creator>Alessandro Mainardi</dc:creator>
      <pubDate>Wed, 28 Oct 2026 08:45:43 +0000</pubDate>
      <link>https://dev.to/alexmaina/keep-your-microsoft-365-e5-developer-tenant-active-automatically-1n9i</link>
      <guid>https://dev.to/alexmaina/keep-your-microsoft-365-e5-developer-tenant-active-automatically-1n9i</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;📖 &lt;strong&gt;Original Reference:&lt;/strong&gt; Originally published with security architecture baselines at &lt;a href="https://alexmaina.dev/m365-developer-rinnovo-automatico/" rel="noopener noreferrer"&gt;alexmaina.dev/m365-developer-rinnovo-automatico&lt;/a&gt;.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;The &lt;strong&gt;Microsoft 365 Developer Program&lt;/strong&gt; provides a free 25-user E5 enterprise sandbox subscription (worth over $1,300/year). However, it comes with a strict condition: &lt;strong&gt;it expires every 90 days unless Microsoft detects continuous developer activity&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;If your sandbox goes idle, Microsoft terminates the tenant, permanently erasing your users, mailboxes, and configurations.&lt;/p&gt;

&lt;p&gt;Here is an automated, serverless solution using &lt;strong&gt;Microsoft Graph API&lt;/strong&gt; and &lt;strong&gt;GitHub Actions&lt;/strong&gt; to generate valid developer telemetry and maintain your tenant indefinitely.&lt;/p&gt;




&lt;h2&gt;
  
  
  1. Register a Daemon App in Microsoft Entra ID
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;Sign into the &lt;a href="https://entra.microsoft.com" rel="noopener noreferrer"&gt;Microsoft Entra Admin Center&lt;/a&gt; as tenant admin.&lt;/li&gt;
&lt;li&gt;Go to &lt;strong&gt;Identity&lt;/strong&gt; → &lt;strong&gt;Applications&lt;/strong&gt; → &lt;strong&gt;App registrations&lt;/strong&gt; → &lt;strong&gt;New registration&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Name it &lt;code&gt;M365-KeepAlive-Automation&lt;/code&gt; (Accounts in this organizational directory only).&lt;/li&gt;
&lt;li&gt;Save the &lt;strong&gt;Application (client) ID&lt;/strong&gt; and &lt;strong&gt;Directory (tenant) ID&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Under &lt;strong&gt;Certificates &amp;amp; secrets&lt;/strong&gt;, create a new client secret (24-month validity) and copy its value.&lt;/li&gt;
&lt;li&gt;Under &lt;strong&gt;API permissions&lt;/strong&gt; → &lt;strong&gt;Add permission&lt;/strong&gt; → &lt;strong&gt;Microsoft Graph&lt;/strong&gt; → &lt;strong&gt;Application permissions&lt;/strong&gt;, select:

&lt;ul&gt;
&lt;li&gt;&lt;code&gt;User.Read.All&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Calendars.ReadWrite&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Directory.Read.All&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;Click &lt;strong&gt;Grant admin consent for [Your Tenant]&lt;/strong&gt;.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  2. Python Telemetry Script (keepalive.py)
&lt;/h2&gt;

&lt;p&gt;Create &lt;code&gt;keepalive.py&lt;/code&gt; in a private GitHub repository:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;os&lt;/span&gt;
&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;requests&lt;/span&gt;
&lt;span class="kn"&gt;from&lt;/span&gt; &lt;span class="n"&gt;datetime&lt;/span&gt; &lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;datetime&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;timedelta&lt;/span&gt;

&lt;span class="n"&gt;TENANT_ID&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;os&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;environ&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;M365_TENANT_ID&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="n"&gt;CLIENT_ID&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;os&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;environ&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;M365_CLIENT_ID&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="n"&gt;CLIENT_SECRET&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;os&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;environ&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;M365_CLIENT_SECRET&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;

&lt;span class="c1"&gt;# 1. Acquire OAuth2 Token via Client Credentials Flow
&lt;/span&gt;&lt;span class="n"&gt;token_url&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;https://login.microsoftonline.com/&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;TENANT_ID&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;/oauth2/v2.0/token&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
&lt;span class="n"&gt;token_data&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;grant_type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;client_credentials&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;client_id&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;CLIENT_ID&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;client_secret&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;CLIENT_SECRET&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;scope&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;https://graph.microsoft.com/.default&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="n"&gt;res&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;requests&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;post&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;token_url&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;token_data&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="n"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;raise_for_status&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
&lt;span class="n"&gt;access_token&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;()[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;access_token&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="n"&gt;headers&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Authorization&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Bearer &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;access_token&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Content-Type&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;application/json&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;✅ Microsoft Graph token successfully acquired.&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="c1"&gt;# 2. Query tenant user directory
&lt;/span&gt;&lt;span class="n"&gt;users_res&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;requests&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;https://graph.microsoft.com/v1.0/users?$top=5&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;headers&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="n"&gt;users&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;users_res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;value&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;[])&lt;/span&gt;
&lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;📡 Found &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nf"&gt;len&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;users&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; users in tenant.&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="c1"&gt;# 3. Create simulated developer calendar event
&lt;/span&gt;&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;users&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;target_user_id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;users&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;][&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;id&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
    &lt;span class="n"&gt;now&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;datetime&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;utcnow&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
    &lt;span class="n"&gt;event_payload&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;subject&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Dev Sprint Sync - &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;now&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;strftime&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;%Y-%m-%d %H&lt;/span&gt;&lt;span class="si"&gt;:&lt;/span&gt;&lt;span class="o"&gt;%&lt;/span&gt;&lt;span class="n"&gt;M&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;body&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;contentType&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;HTML&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;content&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Automated Graph API Developer Telemetry.&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;start&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;dateTime&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;now&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nf"&gt;timedelta&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;hours&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)).&lt;/span&gt;&lt;span class="nf"&gt;isoformat&lt;/span&gt;&lt;span class="p"&gt;(),&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;timeZone&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;UTC&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;end&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;dateTime&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;now&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nf"&gt;timedelta&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;hours&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)).&lt;/span&gt;&lt;span class="nf"&gt;isoformat&lt;/span&gt;&lt;span class="p"&gt;(),&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;timeZone&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;UTC&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="n"&gt;event_res&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;requests&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;post&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;https://graph.microsoft.com/v1.0/users/&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;target_user_id&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;/events&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;headers&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;event_payload&lt;/span&gt;
    &lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;event_res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;status_code&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="mi"&gt;201&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;📅 Developer telemetry event created in calendar.&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  3. GitHub Actions Cron Workflow
&lt;/h2&gt;

&lt;p&gt;In &lt;code&gt;.github/workflows/keepalive.yml&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;M365 E5 KeepAlive Automation&lt;/span&gt;

&lt;span class="na"&gt;on&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;schedule&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="c1"&gt;# Runs Monday, Wednesday, Friday at 08:30 UTC&lt;/span&gt;
    &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;cron&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'&lt;/span&gt;&lt;span class="s"&gt;30&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;8&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;*&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;*&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;1,3,5'&lt;/span&gt;
  &lt;span class="na"&gt;workflow_dispatch&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;

&lt;span class="na"&gt;jobs&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;telemetry&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;runs-on&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;ubuntu-latest&lt;/span&gt;
    &lt;span class="na"&gt;steps&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;actions/checkout@v4&lt;/span&gt;

      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;actions/setup-python@v5&lt;/span&gt;
        &lt;span class="na"&gt;with&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;python-version&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'&lt;/span&gt;&lt;span class="s"&gt;3.12'&lt;/span&gt;

      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;pip install requests&lt;/span&gt;

      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Run Graph Telemetry&lt;/span&gt;
        &lt;span class="na"&gt;env&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;M365_TENANT_ID&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;${{ secrets.M365_TENANT_ID }}&lt;/span&gt;
          &lt;span class="na"&gt;M365_CLIENT_ID&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;${{ secrets.M365_CLIENT_ID }}&lt;/span&gt;
          &lt;span class="na"&gt;M365_CLIENT_SECRET&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;${{ secrets.M365_CLIENT_SECRET }}&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;python keepalive.py&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Store &lt;code&gt;M365_TENANT_ID&lt;/code&gt;, &lt;code&gt;M365_CLIENT_ID&lt;/code&gt;, and &lt;code&gt;M365_CLIENT_SECRET&lt;/code&gt; under &lt;strong&gt;Repository Settings&lt;/strong&gt; → &lt;strong&gt;Secrets and variables&lt;/strong&gt; → &lt;strong&gt;Actions&lt;/strong&gt;.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Author: &lt;a href="https://alexmaina.dev/about/" rel="noopener noreferrer"&gt;Alessandro Mainardi&lt;/a&gt; — Software Developer &amp;amp; Computer Engineering Student @ UniBo. Explore cloud identity guides at &lt;a href="https://alexmaina.dev/" rel="noopener noreferrer"&gt;alexmaina.dev&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>azure</category>
      <category>devops</category>
      <category>githubactions</category>
      <category>automation</category>
    </item>
    <item>
      <title>How to Fix Error AADSTS50011 in Microsoft Entra ID (Redirect URI Mismatch)</title>
      <dc:creator>Alessandro Mainardi</dc:creator>
      <pubDate>Wed, 28 Oct 2026 08:43:35 +0000</pubDate>
      <link>https://dev.to/alexmaina/how-to-fix-error-aadsts50011-in-microsoft-entra-id-redirect-uri-mismatch-3c2h</link>
      <guid>https://dev.to/alexmaina/how-to-fix-error-aadsts50011-in-microsoft-entra-id-redirect-uri-mismatch-3c2h</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;📖 &lt;strong&gt;Original Reference:&lt;/strong&gt; Originally published with interactive diagrams and enterprise identity baselines at &lt;a href="https://alexmaina.dev/entra-id-redirect-uri-aadsts50011/" rel="noopener noreferrer"&gt;alexmaina.dev/entra-id-redirect-uri-aadsts50011&lt;/a&gt;.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;If you are developing applications using &lt;strong&gt;MSAL (Microsoft Authentication Library)&lt;/strong&gt; and Microsoft Entra ID (formerly Azure AD), you have likely run into this frustrating blocker:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;AADSTS50011: The reply URL specified in the request does not match the reply URLs configured for the application '{client-id}'.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This error appears during the OAuth 2.0 / OpenID Connect authorization handshake. Microsoft's token endpoint performs a &lt;strong&gt;strict character-by-character validation&lt;/strong&gt;, meaning even a single trailing slash or port mismatch will immediately halt authentication.&lt;/p&gt;

&lt;p&gt;Here is how to diagnose the root cause and fix it in under 3 minutes.&lt;/p&gt;




&lt;h2&gt;
  
  
  1. The 4 Most Common Causes of Mismatch
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Root Cause&lt;/th&gt;
&lt;th&gt;What MSAL Request Sends&lt;/th&gt;
&lt;th&gt;What Entra ID App Has Configured&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Trailing Slash&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;http://localhost:3000&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;http://localhost:3000/&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Protocol Scheme&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;https://app.mydomain.com/callback&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;http://app.mydomain.com/callback&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Dynamic Dev Port&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;http://localhost:5173&lt;/code&gt; (Vite)&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;http://localhost:3000&lt;/code&gt; (Create-React-App)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Wrong Platform Type&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;SPA with PKCE (CORS)&lt;/td&gt;
&lt;td&gt;Configured under "Web" section&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;




&lt;h2&gt;
  
  
  2. Step-by-Step Fix via Microsoft Entra Admin Center
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;Navigate to the &lt;a href="https://entra.microsoft.com" rel="noopener noreferrer"&gt;Microsoft Entra Admin Center&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;Go to &lt;strong&gt;Identity&lt;/strong&gt; → &lt;strong&gt;Applications&lt;/strong&gt; → &lt;strong&gt;App registrations&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Select the &lt;strong&gt;All applications&lt;/strong&gt; tab and open your registered application (match the &lt;code&gt;client-id&lt;/code&gt; from your error log).&lt;/li&gt;
&lt;li&gt;In the left navigation menu, click &lt;strong&gt;Authentication&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Inspect your platform configuration:

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Single-Page Application (SPA):&lt;/strong&gt; If you are using React, Vue, Angular, or vanilla JS with MSAL Browser (Auth Code flow with PKCE), your URI &lt;strong&gt;MUST&lt;/strong&gt; be under the &lt;em&gt;Single-page application&lt;/em&gt; section. If registered under "Web", token requests will fail due to missing CORS headers.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Web:&lt;/strong&gt; Use this only for backend-rendered apps with client secrets (Next.js server-side, Node/Express, Django, Flask, ASP.NET Core).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Mobile and desktop applications:&lt;/strong&gt; Required for CLI tools, PowerShell, Python scripts, or desktop apps using loopback listeners (&lt;code&gt;http://localhost&lt;/code&gt;).&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;Paste the exact Redirect URI from the error message.&lt;/li&gt;
&lt;li&gt;Click &lt;strong&gt;Save&lt;/strong&gt; at the top.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  3. Fast Fix with Microsoft Graph PowerShell
&lt;/h2&gt;

&lt;p&gt;If you frequently rotate ports during local testing, you can update redirect URIs programmatically using the official Microsoft Graph PowerShell SDK:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Authenticate to Microsoft Graph&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;Connect-MgGraph&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-Scopes&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Application.ReadWrite.All"&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="nv"&gt;$AppId&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"YOUR-APPLICATION-CLIENT-ID"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="nv"&gt;$App&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Get-MgApplication&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-Filter&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"appId eq '&lt;/span&gt;&lt;span class="nv"&gt;$AppId&lt;/span&gt;&lt;span class="s2"&gt;'"&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="c"&gt;# Configure allowed redirect URIs for local dev + production&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="nv"&gt;$SpaRedirects&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;@(&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s2"&gt;"http://localhost:3000"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s2"&gt;"http://localhost:5173"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s2"&gt;"https://alexmaina.dev/auth/callback"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="c"&gt;# Update SPA Platform configuration&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;Update-MgApplication&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-ApplicationId&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nv"&gt;$App&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;Id&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-Spa&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;@{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;RedirectUris&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nv"&gt;$SpaRedirects&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="n"&gt;Write-Host&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"✅ Redirect URIs successfully updated for: &lt;/span&gt;&lt;span class="si"&gt;$(&lt;/span&gt;&lt;span class="nv"&gt;$App&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;DisplayName&lt;/span&gt;&lt;span class="si"&gt;)&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-ForegroundColor&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;Green&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  4. Crucial Rules for Localhost in Entra ID
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;HTTP is strictly reserved for Localhost:&lt;/strong&gt; Microsoft Entra ID enforces HTTPS for all production domain redirect URIs. The only exception is loopback addresses (&lt;code&gt;http://localhost&lt;/code&gt; or &lt;code&gt;http://127.0.0.1&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Wildcards are deprecated:&lt;/strong&gt; Microsoft no longer allows wildcard characters (&lt;code&gt;*&lt;/code&gt;) in redirect URIs for security reasons (preventing token interception and open-redirect attacks). Each callback endpoint must be explicitly declared.&lt;/li&gt;
&lt;/ul&gt;




&lt;h3&gt;
  
  
  Need Deep Dive Architecture?
&lt;/h3&gt;

&lt;p&gt;For full zero-trust setups, enterprise RBAC baselines, and tenant isolation, check out my technical guide hub at &lt;a href="https://alexmaina.dev/" rel="noopener noreferrer"&gt;alexmaina.dev&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Author: &lt;a href="https://alexmaina.dev/about/" rel="noopener noreferrer"&gt;Alessandro Mainardi&lt;/a&gt; — Software Developer &amp;amp; Computer Engineering Student @ Alma Mater Studiorum - University of Bologna.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>azure</category>
      <category>entra</category>
      <category>oauth</category>
      <category>webdev</category>
    </item>
  </channel>
</rss>
