Prerequisites
- An existing self-hosted Nexus Repository 3 installation. This guide was verified with Community 3.96.5-05; Nexus Repository Cloud compatibility is unverified. For installation, follow Sonatype’s guide.
- An HTTPS path from CloudThinker to Nexus. For CloudThinker Cloud, follow Reaching private services. On a self-hosted deployment of CloudThinker, allow access from your CloudThinker deployment.
- A Nexus administrator who can create a dedicated user and assign roles.
- The Admin role in your CloudThinker workspace. See Roles.
Setup
Create a role for CloudThinker
cloudthinker-reader.Under Privileges, choose Edit Privileges, select the privileges in Required permissions, and click Confirm, then Save. Leave Contained Roles empty. See Sonatype’s role instructions.Create a dedicated local user
Add the connection in CloudThinker
Connection details
my.sonatype.com portal. CloudThinker refuses redirects, so include /nexus only if your installation uses that path.
For a self-signed certificate, Skip SSL verification (self-signed) keeps traffic encrypted but cannot verify the server’s identity. Prefer a trusted certificate and verification; a publicly trusted HTTPS address needs no skip option. For a private certificate authority, contact CloudThinker.
User tokens require a licensed Nexus entitlement. If your administrator already supplies a Nexus user token, enter its separate name code and passcode in the matching fields. Otherwise, use the local-user credentials above.
Required permissions
Assign these Nexus privileges for the checks you need:Agent capabilities
Verify the connection
Example prompts
Troubleshooting
Nexus rejected the username and password, or the user token.
Nexus rejected the username and password, or the user token.
The user signed in, but it cannot browse repositories. Give it nx-repository-view---browse.
The user signed in, but it cannot browse repositories. Give it nx-repository-view---browse.
Nexus answered with a redirect. Use the exact address, including any /nexus path.
Nexus answered with a redirect. Use the exact address, including any /nexus path.
That address has no Nexus REST API. Check the URL and any context path such as /nexus.
That address has no Nexus REST API. Check the URL and any context path such as /nexus.
The Nexus certificate is not trusted. Set TLS certificate to Skip SSL verification for a self-signed certificate.
The Nexus certificate is not trusted. Set TLS certificate to Skip SSL verification for a self-signed certificate.
HTTP 403 during an investigation
HTTP 403 during an investigation
The Nexus URL must start with https://.
The Nexus URL must start with https://.
Security
- Least privilege — grant only the permissions the agents need for your use case; start read-only and widen later.
- Read-only by default — use read-only credentials unless you want agents to make changes through this connection.
- Rotate credentials — rotate keys and tokens on your normal schedule; CloudThinker picks up the new value when you update the connection.
- Revoke on offboarding — remove the credential at the provider when you delete a connection or a teammate leaves.
- Keep the Nexus account limited to the repositories and checks you need, even though this connection exposes no changes.
- Keep certificate verification on and restrict network access to the sources that need Nexus.