diff --git a/modules/ROOT/pages/ref-acb-maven.adoc b/modules/ROOT/pages/ref-acb-maven.adoc index 59300b128..468272de4 100644 --- a/modules/ROOT/pages/ref-acb-maven.adoc +++ b/modules/ROOT/pages/ref-acb-maven.adoc @@ -14,6 +14,21 @@ 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. +. 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]. + == 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