Configure Basic Authentication for Custom Artifactory Location

You require to configure Smart Agent to use basic authentication if it needs to communicate with an HTTP server that requests authentication. This applies to servers such as, Nexus, Artifactory, or any custom HTTP server.

Note: To use mutual TLS, you can set up access through an HTTPS proxy. For more information, see Configure Smart Agent.
To specify basic authentication credentials, use the following keys in the Custom Configurations section:
user_portal_username: <username>
user_portal_password: <password>
user_portal_auth: basic

If you are using Smart Agent CLI, specify the variables before running the appd:

Important: The Smart Agent CLI is deprecated and will reach End of Support on February 2, 2026. Until then, only critical security fixes and bug fixes will be provided and a release will be made as needed.

It is recommend to use the Custom Configurations section in the Agent Management UI.

sudo env ENABLE_CUSTOM_HTTP=true CUSTOM_HTTP_USERNAME=<username> CUSTOM_HTTP_PASSWORD=<password> ./appd install …

You can specify the agent_source_location:

sudo env ENABLE_CUSTOM_HTTP=true CUSTOM_HTTP_USERNAME=<username> CUSTOM_HTTP_PASSWORD=<password> .
/appd install <agent-type> —extra-vars agent_source_location=<path-to-agent-zip-from-custom-url>