You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-commits@maven.apache.org by sv...@apache.org on 2025/02/09 10:14:14 UTC
svn commit: r1923684 - in /maven/website/content: ./ guides/introduction/ guides/mini/
Author: svn-site-role
Date: Sun Feb 9 10:14:13 2025
New Revision: 1923684
Log:
Site checkin for project Apache Maven Site
Added:
maven/website/content/guides/mini/guide-encryption-4.html
Modified:
maven/website/content/guides/introduction/introduction-to-repositories.html
maven/website/content/guides/mini/guide-3rd-party-jars-local.html
maven/website/content/guides/mini/guide-3rd-party-jars-remote.html
maven/website/content/guides/mini/guide-deployment-security-settings.html
maven/website/content/guides/mini/guide-encryption.html
maven/website/content/guides/mini/guide-http-settings.html
maven/website/content/guides/mini/guide-large-scale-centralized-deployments.html
maven/website/content/guides/mini/guide-mirror-settings.html
maven/website/content/guides/mini/guide-multiple-repositories.html
maven/website/content/guides/mini/guide-proxies.html
maven/website/content/guides/mini/guide-relocation.html
maven/website/content/guides/mini/guide-repository-ssl.html
maven/website/content/guides/mini/guide-resolver-transport.html
maven/website/content/guides/mini/guide-wagon-providers.html
maven/website/content/repository-management.html
Modified: maven/website/content/guides/introduction/introduction-to-repositories.html
==============================================================================
--- maven/website/content/guides/introduction/introduction-to-repositories.html (original)
+++ maven/website/content/guides/introduction/introduction-to-repositories.html Sun Feb 9 10:14:13 2025
@@ -92,7 +92,8 @@
<li><a href="../../guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
<li><a href="../../guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
<li><a href="../../guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
- <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords</a></li>
+ <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="../../guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li><a href="../../guides/mini/guide-proxies.html">Using Proxies</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
<li><a href="../../guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>
Modified: maven/website/content/guides/mini/guide-3rd-party-jars-local.html
==============================================================================
--- maven/website/content/guides/mini/guide-3rd-party-jars-local.html (original)
+++ maven/website/content/guides/mini/guide-3rd-party-jars-local.html Sun Feb 9 10:14:13 2025
@@ -92,7 +92,8 @@
<li><a href="../../guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
<li><a href="../../guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
<li><a href="../../guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
- <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords</a></li>
+ <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="../../guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li><a href="../../guides/mini/guide-proxies.html">Using Proxies</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
<li><a href="../../guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>
Modified: maven/website/content/guides/mini/guide-3rd-party-jars-remote.html
==============================================================================
--- maven/website/content/guides/mini/guide-3rd-party-jars-remote.html (original)
+++ maven/website/content/guides/mini/guide-3rd-party-jars-remote.html Sun Feb 9 10:14:13 2025
@@ -91,7 +91,8 @@
<li><a href="../../guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
<li><a href="../../guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
<li><a href="../../guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
- <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords</a></li>
+ <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="../../guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li><a href="../../guides/mini/guide-proxies.html">Using Proxies</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
<li><a href="../../guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>
Modified: maven/website/content/guides/mini/guide-deployment-security-settings.html
==============================================================================
--- maven/website/content/guides/mini/guide-deployment-security-settings.html (original)
+++ maven/website/content/guides/mini/guide-deployment-security-settings.html Sun Feb 9 10:14:13 2025
@@ -91,7 +91,8 @@
<li><a href="../../guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
<li><a href="../../guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
<li class="active"><a>Deployment and Security Settings</a></li>
- <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords</a></li>
+ <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="../../guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li><a href="../../guides/mini/guide-proxies.html">Using Proxies</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
<li><a href="../../guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>
Added: maven/website/content/guides/mini/guide-encryption-4.html
==============================================================================
--- maven/website/content/guides/mini/guide-encryption-4.html (added)
+++ maven/website/content/guides/mini/guide-encryption-4.html Sun Feb 9 10:14:13 2025
@@ -0,0 +1,254 @@
+<!DOCTYPE html>
+
+
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/markdown/guides/mini/guide-encryption-4.md at 2025-02-09
+ | Rendered using Apache Maven Fluido Skin 2.0.1
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0" />
+ <title>Password Encryption (Maven 4) â Maven</title>
+ <link rel="stylesheet" href="../../css/apache-maven-fluido-2.0.1.min.css" />
+ <link rel="stylesheet" href="../../css/site.css" />
+ <link rel="stylesheet" href="../../css/print.css" media="print" />
+ <script src="../../js/apache-maven-fluido-2.0.1.min.js"></script>
+ <!-- Matomo -->
+ <script>
+ var _paq = window._paq = window._paq || [];
+ _paq.push(['disableCookies']);
+ _paq.push(['trackPageView']);
+ _paq.push(['enableLinkTracking']);
+
+ (function() {
+ var u="https://analytics.apache.org/";
+ _paq.push(['setTrackerUrl', u+'/matomo.php']);
+ _paq.push(['setSiteId', '3']);
+ var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
+ g.async=true; g.src=u+'/matomo.js'; s.parentNode.insertBefore(g,s);
+ })();
+ </script>
+ <!-- End Matomo Code -->
+ </head>
+ <body>
+ <div class="container-fluid container-fluid-top">
+ <header>
+ <div id="banner">
+ <div class="pull-left"><div id="bannerLeft"><h1><a href="https://www.apache.org/"><img class="class java.lang.Object" src="../../images/apache-maven-project.png" /></a></h1></div></div>
+ <div class="pull-right"><div id="bannerRight"><h1><a href="../.././"><img class="class java.lang.Object" src="../../images/maven-logo-black-on-white.png" /></a></h1></div></div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+ <li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li>
+ <li><a href="../../index.html">Maven</a><span class="divider">/</span></li>
+ <li class="active">Password Encryption (Maven 4) <a href="https://github.com/apache/maven-site/tree/master/content/markdown/guides/mini/guide-encryption-4.md"><img src="../../images/accessories-text-editor.png" alt="Edit" /></a></li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2025-02-09</li>
+ <li class="pull-right"><span class="divider">|</span>
+<a href="../../scm.html">Get Sources</a></li>
+ <li class="pull-right"><a href="../../download.cgi">Download</a></li>
+ </ul>
+ </div>
+ </header>
+ <div class="row-fluid">
+ <header id="leftColumn" class="span2">
+ <nav class="well sidebar-nav">
+ <ul class="nav nav-list">
+ <li><a href="../../index.html">Welcome</a></li>
+ <li><a href="https://www.apache.org/licenses/" class="externalLink">License</a></li>
+ <li class="nav-header">About Maven</li>
+ <li><a href="../../what-is-maven.html">What is Maven?</a></li>
+ <li><a href="../../maven-features.html">Features</a></li>
+ <li><a href="../../download.html">Download</a></li>
+ <li><a href="../../users/index.html"><span class="icon-chevron-right"></span>Use</a></li>
+ <li><a href="../../docs/history.html">Release Notes</a></li>
+ <li class="nav-header">Documentation</li>
+ <li><a href="../../plugins/index.html">Maven Plugins</a></li>
+ <li><a href="../../extensions/index.html">Maven Extensions</a></li>
+ <li><a href="../../tools/index.html">Maven Tools</a></li>
+ <li><a href="../../guides/index.html">Index (category)</a></li>
+ <li><a href="../../users/index.html"><span class="icon-chevron-down"></span>User Centre</a>
+ <ul class="nav nav-list">
+ <li><a href="../../guides/getting-started/maven-in-five-minutes.html">Maven in 5 Minutes</a></li>
+ <li><a href="../../guides/getting-started/index.html"><span class="icon-chevron-right"></span>Getting Started Guide</a></li>
+ <li><a href="../../users/getting-help.html">Getting Help</a></li>
+ <li><a href="../../run-maven/index.html">Running Maven</a></li>
+ <li><a href="../../guides/plugins/validation/index.html">Plugins Validation</a></li>
+ <li><a href="../../guides/mini/guide-configuring-plugins.html"><span class="icon-chevron-right"></span>Configuring Plugins</a></li>
+ <li><a href="../../guides/mini/guide-site.html"><span class="icon-chevron-right"></span>Creating a site</a></li>
+ <li><a href="../../guides/introduction/introduction-to-archetypes.html"><span class="icon-chevron-right"></span>Archetypes</a></li>
+ <li><a href="../../guides/introduction/introduction-to-repositories.html"><span class="icon-chevron-down"></span>Repositories</a>
+ <ul class="nav nav-list">
+ <li><a href="../../guides/mini/guide-3rd-party-jars-local.html">Install to Local</a></li>
+ <li><a href="../../guides/mini/guide-3rd-party-jars-remote.html">Deploy to Remote</a></li>
+ <li><a href="../../repository-management.html">Repository Management</a></li>
+ <li><a href="../../guides/mini/guide-multiple-repositories.html">Using Multiple Repositories</a></li>
+ <li><a href="../../guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
+ <li><a href="../../guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
+ <li><a href="../../guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
+ <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li class="active"><a>Encrypting Passwords (Maven 4)</a></li>
+ <li><a href="../../guides/mini/guide-proxies.html">Using Proxies</a></li>
+ <li><a href="../../guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
+ <li><a href="../../guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>
+ <li><a href="../../guides/mini/guide-http-settings.html">Advanced Wagon HTTP Configuration</a></li>
+ <li><a href="../../guides/mini/guide-wagon-providers.html">Alternative Wagon Providers</a></li>
+ <li><a href="../../guides/mini/guide-relocation.html">Relocation</a></li>
+ </ul></li>
+ <li><a href="../../guides/mini/index.html"><span class="icon-chevron-right"></span>Guides</a></li>
+ <li><a href="../../settings.html">Settings Reference</a></li>
+ <li><a href="../../pom.html">POM Reference</a></li>
+ <li><a href="../../general.html">FAQ</a></li>
+ </ul></li>
+ <li><a href="../../plugin-developers/index.html"><span class="icon-chevron-right"></span>Plugin Developer Centre</a></li>
+ <li><a href="../../repositories/index.html"><span class="icon-chevron-right"></span>Maven Repository Centre</a></li>
+ <li><a href="../../developers/index.html"><span class="icon-chevron-right"></span>Maven Developer Centre</a></li>
+ <li><a href="../../articles.html">Books and Resources</a></li>
+ <li><a href="../../security.html">Security</a></li>
+ <li class="nav-header">Community</li>
+ <li><a href="../../community.html">Community Overview</a></li>
+ <li><a href="../../project-roles.html">Project Roles</a></li>
+ <li><a href="../../guides/development/guide-helping.html">How to Contribute</a></li>
+ <li><a href="../../users/getting-help.html">Getting Help</a></li>
+ <li><a href="../../issue-management.html">Issue Management</a></li>
+ <li><a href="../../scm.html">Getting Maven Source</a></li>
+ <li><a href="../../team.html">The Maven Team</a></li>
+ <li class="nav-header">Project Documentation</li>
+ <li><a href="../../project-info.html"><span class="icon-chevron-right"></span>Project Information</a></li>
+ <li class="nav-header">Maven Projects</li>
+ <li><a href="../../ref/current">Maven</a></li>
+ <li><a href="../../archetypes/index.html">Archetypes</a></li>
+ <li><a href="../../extensions/index.html">Extensions</a></li>
+ <li><a href="../../pom/index.html">Parent POMs</a></li>
+ <li><a href="../../plugins/index.html">Plugins</a></li>
+ <li><a href="../../skins/index.html">Skins</a></li>
+ <li><a><span class="icon-chevron-down"></span>Components</a>
+ <ul class="nav nav-list">
+ <li><a href="../../archetype/index.html">Archetype</a></li>
+ <li><a href="../../resolver/index.html">Artifact Resolver</a></li>
+ <li><a href="../../doxia/index.html">Doxia</a></li>
+ <li><a href="../../maven-indexer/index.html">Indexer</a></li>
+ <li><a href="../../jxr/index.html">JXR</a></li>
+ <li><a href="../../plugin-testing/index.html">Plugin Testing</a></li>
+ <li><a href="../../plugin-tools/index.html">Plugin Tools</a></li>
+ <li><a href="../../apache-resource-bundles/index.html">Resource Bundles</a></li>
+ <li><a href="../../scm/index.html">SCM</a></li>
+ <li><a href="../../shared/index.html">Shared Components</a></li>
+ <li><a href="../../surefire/index.html">Surefire</a></li>
+ <li><a href="../../wagon/index.html">Wagon</a></li>
+ </ul></li>
+ <li class="nav-header">ASF</li>
+ <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a></li>
+ <li><a href="https://www.apache.org/foundation/" class="externalLink">Foundation</a></li>
+ <li><a href="https://privacy.apache.org/policies/privacy-policy-public.html" class="externalLink">Data Privacy</a></li>
+ <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a></li>
+ <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a></li>
+ </ul>
+ </nav>
+ <div class="well sidebar-nav">
+ <div id="poweredBy">
+ <div class="clear"></div>
+ <div class="clear"></div>
+<a href="https://maven.apache.org/" class="builtBy" target="_blank"><img class="builtBy" alt="Built by Maven" src="../../images/logos/maven-feather.png" /></a>
+ </div>
+ </div>
+ </header>
+ <main id="bodyColumn" class="span10">
+<section><a id="Password_Encryption_.28Maven_4.29"></a>
+<h1>Password Encryption (Maven 4)</h1><!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+<ul>
+<li><a href="#Introduction">Introduction</a></li>
+<li><a href="#Dispatchers">Dispatchers</a>
+<ul>
+<li><a href="#Master">Master</a></li>
+<li><a href="#Master_Source_Lookup_Dispatcher">Master Source Lookup Dispatcher</a></li>
+<li><a href="#Legacy_Dispatcher">Legacy Dispatcher</a></li></ul></li>
+<li><a href="#Master_Key_Sources">Master Key Sources</a></li>
+<li><a href="#Setup">Setup</a></li>
+<li><a href="#Create_encrypted_values">Create encrypted values</a></li>
+<li><a href="#Implementation">Implementation</a>
+<ul>
+<li><a href="#Configuration_File">Configuration File</a></li></ul></li></ul>
+<section><a id="Introduction"></a>
+<h2>Introduction</h2>
+<p>Maven 4 introduces an enhanced encryption providing more secure handling of passwords than provided by <a href="guide-encryption.html">the one from Maven 3</a>.
+It ships with multiple pluggable providers (internally referred to as dispatchers) which use different approaches for decrypting secret values from <a href="../../settings.html"><code>settings.xml</code></a>.</p></section><section><a id="Dispatchers"></a>
+<h2>Dispatchers</h2><section><a id="Master"></a>
+<h3>Master</h3>
+<p>The <code>master</code> dispatcher still sticks to the principle of keeping the <em>symmetrically encrypted values</em> directly within the <code>settings.xml</code> (same approach as in Maven 3).</p>
+<p>A single master key is used for both decrypting and encrypting and therefore should be always kept at a safe place. <em>Everyone with that key can decrypt all encrypted values from your <code>settings.xml</code>.</em>
+The master key may be provided from different sources therefore this dispatcher requires the configuration of a master <code>source</code>.</p>
+<p>Currently the only cipher used is <code>AES/GCM/NoPadding</code> leveraging <code>PBKDF2WithHmacSHA512</code> hashes of the master key as crypto key (this may change in the future though).</p></section><section><a id="Master_Source_Lookup_Dispatcher"></a>
+<h3>Master Source Lookup Dispatcher</h3>
+<p>The <code>masterSourceLookup</code> dispatcher (introduced in <a href="https://issues.apache.org/jira/browse/MNG-8555" class="externalLink">Maven 4.0.0-rc-3</a>) does not actually perform any crypto operations. It merely looks up a secret value references from one of Master Key Sources.
+Instead of using an actually encrypted value one leverages master key source configurations within the <code>settings.xml</code>.
+The placeholder to be used within the <code>settings.xml</code> should be created with <code>mvnenc encrypt</code> as outlined in section <em>Create encrypted values</em>.
+It has the format <code>{[name=masterSourceLookup,version=4.0]<master source config>}</code>.</p></section><section><a id="Legacy_Dispatcher"></a>
+<h3>Legacy Dispatcher</h3>
+<p>This is provided as compatibility layer with the <a href="guide-encryption.html">Maven 3 encryption</a> and should only be used if the same <code>settings.xml</code> is supposed to be used with Maven < 4 and above. It is using the same decryption and master key as in Maven 3.</p></section></section><section><a id="Master_Key_Sources"></a>
+<h2>Master Key Sources</h2>
+<p>There are different master key source implementations shipping with Maven with which the master key may be retrieved. Each of them have a unique prefix used
+in the dispatcher's <code>source</code> property of the <code>settings-security4.xml</code> (for the Master Dispatcher) or the reference used in the <code>settings.xml</code> (for the Master Source Lookup Dispatcher).
+This is the list of implementations (in parentheses the format of the <code>source</code>):</p>
+<ol style="list-style-type: decimal;">
+
+<li>Plain file (<code>file:<filepath></code>), the given filepath must be absolute. Only considered secure if located on a protected file system.</li>
+<li>Environment variable (<code>env:<variable-name></code>), the environment variable must be externally populated via some secure means.</li>
+<li>Java System Properties (<code>system-property:<property-name></code>), the Java system property must be externally populated via some secure means.</li>
+<li><a href="https://www.gnupg.org/documentation/manuals/gnupg/Invoking-GPG_002dAGENT.html" class="externalLink">GnuPG Agent</a> (<code>gpg-agent:<agentSocketPath>(?non-interactive)</code>), requires one manual input per user session. The default agent socket path is <code>.gnupg/S.gpg-agent</code> within the user's home directory.</li>
+<li><a href="https://www.gnupg.org/related_software/pinentry/index.html" class="externalLink">Pinentry</a> (<code>pinentry-prompt:<pinentry-binary-path></code>), requires manual input of the password every time a decryption is required. The path should specify the absolute location of the pinentry binary to be used. The one used by GnuPG Agent can be found in <code>~/.gnupg/gpg-agent.conf</code> in property <code>pinentry-program</code>.</li>
+<li>1Password CLI (<code>onepassword:<1Password Secret Reference URI></code>), looks up secret values from a 1Password vault leveraging the <a href="https://developer.1password.com/docs/cli/get-started" class="externalLink">1Password CLI</a>. The <a href="https://developer.1password.com/docs/cli/secret-reference-syntax" class="externalLink">1Password Secret Reference URI</a> always starts with <code>op://</code>.</li>
+</ol>
+<p>One has to pick a suitable source depending on the security and ease-of-use requirements.</p></section><section><a id="Setup"></a>
+<h2>Setup</h2>
+<p>There is a dedicated tool named <code>mvnenc</code> shipping with Maven 4 which helps both with the setup and encryption of values, as well as diagnosis in case of issues.
+Start by executing <code>mvnenc init</code> and then select the desired dispatcher.</p>
+<p>Depending on this choice there may be multiple subsequent configuration steps.</p>
+<p>Afterwards check with <code>mvnenc diag</code> if the configuration is valid.</p>
+<p><em>In contrast to <a href="../../settings.html"><code>settings.xml</code></a> there is no support for expressions in the security related settings</em></p></section><section><a id="Create_encrypted_values"></a>
+<h2>Create encrypted values</h2>
+<p>Execute <code>mvnenc encrypt</code> and afterwards enter the value to encrypt via the CLI. The tool emits the encrypted value in the format</p>
+
+<pre><code class="nohighlight nocode">{[name=<dispatcher name>,<dispatcher-specific attributes>,version=4.0]<the encrypted value>}
+</code></pre>
+<p>which can be just used as is in the <code>settings.xml</code>.</p></section><section><a id="Implementation"></a>
+<h2>Implementation</h2>
+<p>The implementation relies on the <a href="https://github.com/codehaus-plexus/plexus-sec-dispatcher" class="externalLink">Plexus Security Dispatcher Component</a> which also provides an SPI to implement your own source of the master password or other dispatcher implementations.</p><section><a id="Configuration_File"></a>
+<h3>Configuration File</h3>
+<p>The Maven 4 security configuration is stored in the <code><maven.user.conf>/settings-security4.xml</code> (where <code><maven.user.conf></code> is by default<code>~/.m2</code>). The path can be overwritten with config <code>maven.settings.security</code>. The XML must adhere to the format defined by <a href="https://codehaus-plexus.github.io/plexus-sec-dispatcher/settings-security.html" class="externalLink">https://codehaus-plexus.github.io/plexus-sec-dispatcher/settings-security.html</a>.
+It is recommended to only write the configuration file with the aforementioned <code>mvnenc</code> CLI tool, though.</p></section></section></section> </main>
+ </div>
+ </div>
+ <hr/>
+ <footer>
+ <div class="container-fluid">
+ <div class="row-fluid">
+ <p>© 2002â2025
+<a href="https://www.apache.org/">The Apache Software Foundation</a>
+</p>
+ </div>
+ </div>
+ </footer>
+ </body>
+</html>
\ No newline at end of file
Modified: maven/website/content/guides/mini/guide-encryption.html
==============================================================================
--- maven/website/content/guides/mini/guide-encryption.html (original)
+++ maven/website/content/guides/mini/guide-encryption.html Sun Feb 9 10:14:13 2025
@@ -92,7 +92,8 @@
<li><a href="../../guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
<li><a href="../../guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
<li><a href="../../guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
- <li class="active"><a>Encrypting Passwords</a></li>
+ <li class="active"><a>Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="../../guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li><a href="../../guides/mini/guide-proxies.html">Using Proxies</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
<li><a href="../../guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>
@@ -161,6 +162,7 @@
<main id="bodyColumn" class="span10">
<section>
<h1><a id="Password_Encryption">Password Encryption</a></h1>
+<p>(If you're working with Maven 4, please refer to the <a href="./guide-encryption-4.html">Maven 4 edition of this guide</a>)</p>
<ul>
<li><a href="#Introduction">Introduction</a></li>
<li><a href="#How_to_create_a_master_password">How to create a master password</a></li>
Modified: maven/website/content/guides/mini/guide-http-settings.html
==============================================================================
--- maven/website/content/guides/mini/guide-http-settings.html (original)
+++ maven/website/content/guides/mini/guide-http-settings.html Sun Feb 9 10:14:13 2025
@@ -91,7 +91,8 @@
<li><a href="../../guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
<li><a href="../../guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
<li><a href="../../guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
- <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords</a></li>
+ <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="../../guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li><a href="../../guides/mini/guide-proxies.html">Using Proxies</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
<li><a href="../../guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>
Modified: maven/website/content/guides/mini/guide-large-scale-centralized-deployments.html
==============================================================================
--- maven/website/content/guides/mini/guide-large-scale-centralized-deployments.html (original)
+++ maven/website/content/guides/mini/guide-large-scale-centralized-deployments.html Sun Feb 9 10:14:13 2025
@@ -91,7 +91,8 @@
<li class="active"><a>Large Scale Centralized Deployments</a></li>
<li><a href="../../guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
<li><a href="../../guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
- <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords</a></li>
+ <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="../../guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li><a href="../../guides/mini/guide-proxies.html">Using Proxies</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
<li><a href="../../guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>
Modified: maven/website/content/guides/mini/guide-mirror-settings.html
==============================================================================
--- maven/website/content/guides/mini/guide-mirror-settings.html (original)
+++ maven/website/content/guides/mini/guide-mirror-settings.html Sun Feb 9 10:14:13 2025
@@ -93,7 +93,8 @@
<li><a href="../../guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
<li class="active"><a>Mirror Settings</a></li>
<li><a href="../../guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
- <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords</a></li>
+ <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="../../guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li><a href="../../guides/mini/guide-proxies.html">Using Proxies</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
<li><a href="../../guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>
Modified: maven/website/content/guides/mini/guide-multiple-repositories.html
==============================================================================
--- maven/website/content/guides/mini/guide-multiple-repositories.html (original)
+++ maven/website/content/guides/mini/guide-multiple-repositories.html Sun Feb 9 10:14:13 2025
@@ -91,7 +91,8 @@
<li><a href="../../guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
<li><a href="../../guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
<li><a href="../../guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
- <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords</a></li>
+ <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="../../guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li><a href="../../guides/mini/guide-proxies.html">Using Proxies</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
<li><a href="../../guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>
Modified: maven/website/content/guides/mini/guide-proxies.html
==============================================================================
--- maven/website/content/guides/mini/guide-proxies.html (original)
+++ maven/website/content/guides/mini/guide-proxies.html Sun Feb 9 10:14:13 2025
@@ -91,7 +91,8 @@
<li><a href="../../guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
<li><a href="../../guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
<li><a href="../../guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
- <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords</a></li>
+ <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="../../guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li class="active"><a>Using Proxies</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
<li><a href="../../guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>
Modified: maven/website/content/guides/mini/guide-relocation.html
==============================================================================
--- maven/website/content/guides/mini/guide-relocation.html (original)
+++ maven/website/content/guides/mini/guide-relocation.html Sun Feb 9 10:14:13 2025
@@ -91,7 +91,8 @@
<li><a href="../../guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
<li><a href="../../guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
<li><a href="../../guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
- <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords</a></li>
+ <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="../../guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li><a href="../../guides/mini/guide-proxies.html">Using Proxies</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
<li><a href="../../guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>
Modified: maven/website/content/guides/mini/guide-repository-ssl.html
==============================================================================
--- maven/website/content/guides/mini/guide-repository-ssl.html (original)
+++ maven/website/content/guides/mini/guide-repository-ssl.html Sun Feb 9 10:14:13 2025
@@ -91,7 +91,8 @@
<li><a href="../../guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
<li><a href="../../guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
<li><a href="../../guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
- <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords</a></li>
+ <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="../../guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li><a href="../../guides/mini/guide-proxies.html">Using Proxies</a></li>
<li class="active"><a>Authenticated HTTPS</a></li>
<li><a href="../../guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>
Modified: maven/website/content/guides/mini/guide-resolver-transport.html
==============================================================================
--- maven/website/content/guides/mini/guide-resolver-transport.html (original)
+++ maven/website/content/guides/mini/guide-resolver-transport.html Sun Feb 9 10:14:13 2025
@@ -89,7 +89,8 @@
<li><a href="../../guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
<li><a href="../../guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
<li><a href="../../guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
- <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords</a></li>
+ <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="../../guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li><a href="../../guides/mini/guide-proxies.html">Using Proxies</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
<li class="active"><a>Resolver Transport</a></li>
Modified: maven/website/content/guides/mini/guide-wagon-providers.html
==============================================================================
--- maven/website/content/guides/mini/guide-wagon-providers.html (original)
+++ maven/website/content/guides/mini/guide-wagon-providers.html Sun Feb 9 10:14:13 2025
@@ -91,7 +91,8 @@
<li><a href="../../guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
<li><a href="../../guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
<li><a href="../../guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
- <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords</a></li>
+ <li><a href="../../guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="../../guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li><a href="../../guides/mini/guide-proxies.html">Using Proxies</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
<li><a href="../../guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>
Modified: maven/website/content/repository-management.html
==============================================================================
--- maven/website/content/repository-management.html (original)
+++ maven/website/content/repository-management.html Sun Feb 9 10:14:13 2025
@@ -89,7 +89,8 @@
<li><a href="guides/mini/guide-large-scale-centralized-deployments.html">Large Scale Centralized Deployments</a></li>
<li><a href="guides/mini/guide-mirror-settings.html">Mirror Settings</a></li>
<li><a href="guides/mini/guide-deployment-security-settings.html">Deployment and Security Settings</a></li>
- <li><a href="guides/mini/guide-encryption.html">Encrypting Passwords</a></li>
+ <li><a href="guides/mini/guide-encryption.html">Encrypting Passwords (Maven 3)</a></li>
+ <li><a href="guides/mini/guide-encryption-4.html">Encrypting Passwords (Maven 4)</a></li>
<li><a href="guides/mini/guide-proxies.html">Using Proxies</a></li>
<li><a href="guides/mini/guide-repository-ssl.html">Authenticated HTTPS</a></li>
<li><a href="guides/mini/guide-resolver-transport.html">Resolver Transport</a></li>