From caccc572ef28d4f78d6313e57de6b56882af2bd0 Mon Sep 17 00:00:00 2001 From: Cristian-Venticinque Date: Tue, 16 Jun 2026 12:18:07 -0300 Subject: [PATCH 1/2] Adding info and links to configure MuleSoft enterprise repositories --- modules/ROOT/pages/ref-acb-maven.adoc | 13 +++++++++++++ modules/ROOT/pages/troubleshooting.adoc | 7 +++++++ 2 files changed, 20 insertions(+) diff --git a/modules/ROOT/pages/ref-acb-maven.adoc b/modules/ROOT/pages/ref-acb-maven.adoc index 59300b128..5872e79f1 100644 --- a/modules/ROOT/pages/ref-acb-maven.adoc +++ b/modules/ROOT/pages/ref-acb-maven.adoc @@ -14,6 +14,19 @@ include::anypoint-code-builder::partial$acb-maven-settings.adoc[tag="maven-setti include::anypoint-code-builder::partial$acb-maven-settings.adoc[tag="maven-acb-settings-file"] +[[authenticating-to-mulesoft-repositories]] +== Authenticating to MuleSoft Repositories + +When you open a MuleSoft project that uses dependencies from the MuleSoft Enterprise Repository, Maven requires authentication to download the artifacts. If authentication is not configured, you receive a 401 Unauthorized error. + +To configure authentication: + +. If you don't already have Nexus enterprise credentials, contact https://help.mulesoft.com[MuleSoft Support^] to request them. +. Configure your Maven `settings.xml` file with the credentials in the `` section. + +For detailed instructions on configuring the `settings.xml` file, see xref:mule-runtime::maven-reference.adoc#configure-maven-to-access-mulesoft-enterprise-repository[Configure Maven to Access MuleSoft Enterprise Repository]. + +For instructions on encrypting your credentials to avoid storing passwords in plain text (recommended), see xref:mule-runtime::deploy-to-cloudhub.adoc#encrypt-credentials[Encrypt Credentials]. == See Also diff --git a/modules/ROOT/pages/troubleshooting.adoc b/modules/ROOT/pages/troubleshooting.adoc index 4a7e4077b..22fd63de6 100644 --- a/modules/ROOT/pages/troubleshooting.adoc +++ b/modules/ROOT/pages/troubleshooting.adoc @@ -97,6 +97,13 @@ To find this icon, see xref:start-discover-ui.adoc[]. * If the extension pack is _not_ installed, follow the installation steps at xref:start-acb.adoc#set-up-desktop[Set up the Desktop IDE]. * If the extension pack is installed but the MuleSoft icon is not present in the Activity Bar, see xref:troubleshoot-missing-features.adoc#missing-mulesoft-icon[MuleSoft Icon Missing from Activity Bar] to display the icon. +[[maven-401-error]] +== Maven 401 Unauthorized Error + +If Maven fails to download dependencies with a 401 Unauthorized error when opening or building a MuleSoft project, you need to configure authentication for the MuleSoft Enterprise Repository. + +See xref:ref-acb-maven.adoc#authenticating-to-mulesoft-repositories[Authenticating to MuleSoft Repositories] for instructions on configuring your credentials. + [[folder-permission]] == Folder Permission Error From 56558beff238243d026183a85ebbadf93846d208 Mon Sep 17 00:00:00 2001 From: Cristian-Venticinque Date: Tue, 16 Jun 2026 12:32:13 -0300 Subject: [PATCH 2/2] updated link, wording, structure --- modules/ROOT/pages/ref-acb-maven.adoc | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/modules/ROOT/pages/ref-acb-maven.adoc b/modules/ROOT/pages/ref-acb-maven.adoc index 5872e79f1..468272de4 100644 --- a/modules/ROOT/pages/ref-acb-maven.adoc +++ b/modules/ROOT/pages/ref-acb-maven.adoc @@ -22,11 +22,13 @@ When you open a MuleSoft project that uses dependencies from the MuleSoft Enterp To configure authentication: . If you don't already have Nexus enterprise credentials, contact https://help.mulesoft.com[MuleSoft Support^] to request them. -. Configure your Maven `settings.xml` file with the credentials in the `` section. - +. Optionally, encrypt your credentials. ++ +For instructions on encrypting your credentials to avoid storing passwords in plain text, see https://maven.apache.org/guides/mini/guide-encryption.html[Password Encryption^] in the Apache Maven documentation. +. Add your credentials in the `` section of your Maven `settings.xml` file. ++ For detailed instructions on configuring the `settings.xml` file, see xref:mule-runtime::maven-reference.adoc#configure-maven-to-access-mulesoft-enterprise-repository[Configure Maven to Access MuleSoft Enterprise Repository]. -For instructions on encrypting your credentials to avoid storing passwords in plain text (recommended), see xref:mule-runtime::deploy-to-cloudhub.adoc#encrypt-credentials[Encrypt Credentials]. == See Also