User Authentication
Nexus Repository includes a simple user management system and integrations with a number of external authentication sources. Users stored in the internal system can also be managed via the REST API.
After authentication methods have been configured they can be activated or deactivated without removing the configuration through the user interface as detailed in the Security Realms section.
Supported External Authentication Methods
Atlassian Crowd PRO
Nexus Repository can be configured as an application in Atlassian Crowd.
LDAP
A server supporting the Lightweight Directory Access Protocol can also be used by Nexus Repository for authentication.
RUT Authentication
With Remote User Token (RUT) authentication a reverse proxy placed in front of Nexus Repository supplies the identification for the user as a header.
SAML PRO
An identity provider supporting SAML can also provide authentication for Nexus Repository.
User Tokens
PRO For improved security, consider enabling user token support which allows users to generate a random token pair for use with client tools and avoids storing credentials in local files.
Security Realms
The feature view for security realms administration displayed in Figure: “Security Realms Administration” allows you to activate and prioritize security realms used for authentication and authorization by adding them to the Active list on the right and placing them higher or lower on the list. It can be accessed via the Realms menu item located under Security, in the Administration main menu.
Figure: Security Realms Administration
Effectively, this configuration determines what authentication realm is used to grant a user access and the order the realms are used.
Local Authenticating Realm and Local Authorizing Realm
These are the built-in realms used by default. They allow the repository manager to manage security setup without additional external systems.
Recommended Ordering
Sonatype recommends keeping the Local realms at the top of the active list. In the event of system recovery, if you have them lower in the order (or removed), restoration may be more difficult.
Crowd Realm PRO
This realm identifies external storage in an Atlassian Crowd system with details documented in Atlassian Crowd Support.
Default Role Realm
This realm will append the configured role to all users when they are authenticated, see the Default Role page.
Docker Bearer Token Realm
This realm permits docker repositories with the ability to have anonymous read enabled on their repositories in conjunction with the Force basic authentication configuration setting. This is documented further in Docker Authentication.
LDAP Realm
This realm identifies external storage in an LDAP system including e.g., Microsoft ActiveDirectory, ApacheDS, OpenLDAP with details documented in LDAP.
npm Bearer Token Realm
This realm permits users with previously generated bearer tokens to publish npm packages. See npm Security to learn how to establish a connection in order to publish.
NuGet API-Key Realm
This realm is required for deployments to NuGet repositories as documented in NuGet Repositories.
Rut Auth Realm
This realm uses an external authentication in any system with the user authorization passed to the repository manager in a HTTP header field with details documented in Authentication via Remote User Token.
SAML Realm PRO
This realm uses an external Identity Provider (IdP) to handle authentication; details documented in SAML.
User Token Realm PRO
This realm activates token-based authentication for users as a substitute for plain-text username and password authentication. When the user token capability is enabled, the realm is automatically added to the Active Realms list. A full description of this realm is documented in Accessing User Tokens in Realms.
Removing all realms from the Active section prevents access to the repository manager for any user including any administrative access and has to be avoided.