Skip to main content

Setting Up Organizations on my.sonatype.com

my.sonatype.com is a self-service hub for creating and configuring Organizations with Sonatype product licenses. You can add members and administrators, designate authorized contacts to open support tickets, access Cloud instances, and set up an Identity Provider (IdP).

my.sonatype.com landing page screenshot

Creating an Account

  1. Go to my.sonatype.com and click on the profile icon profile_icon_loggedout.png at the top right.

  2. Click Sign Up at the bottom of the page.

  3. Enter the requested information and click on the Sign Up button.

  4. Accept the Terms and Conditions.

  5. You will be asked to verify your email address.

    1. Visit your email inbox and select the email titled "Verify email." This email will come from donotreply@sonatype.com.

    2. Click the link provided in the email.

    3. Select Click here to proceed. You will see a confirmation message indicating that your email address has been verified.

Signing In

  1. Go to my.sonatype.com and click on the profile icon profile_icon_loggedout.png at the top right.

  2. Enter your credentials and click Sign In.

When an account already exists for you and your organization is using a Google or GitHub as an SSO solution, select the Google or GitHub buttons to sign in.

126653828.png

Creating an Organization

Your company is identified as an Organization within my.sonatype.com. As the account Owner, you need to create an Organization to manage your Sonatype product licenses.

To create an organization:

  1. After signing in, click the profile drop-down menu in the top-right and select Organizations to open the page.

    Screenshot_2025-03-04_at_2_50_10_PM.png
  2. Click the Create Organization button and enter a name for the organization. You can also upload an image and provide a description in the respective fields. Click Next.

  3. Enter the license fingerprint. Click Next.

    If your license applies to Sonatype Cloud products, you'll be prompted to enter the administrator email addresses for each platform instance. Click Next.

    my-sonatype-administrator-email.png
  4. Add email addresses to send invitations to the members of the newly created organization. Click Finish.

Opening an Organization

  1. After signing in, click the profile drop-down menu in the top-right and select Organizations to open the page.

    Screenshot_2025-03-04_at_2_50_10_PM.png
  2. Click Open next to the organization.

    my-sonatype-open-organization.png

Once you’ve opened the organization, you can click the Edit button to change your organization's image, name, and description. Use the tabs to add or edit members, verify or download licenses, and add or modify support contacts. If you have a Cloud license, you can also view cloud instance details and configure an Identity Provider (IdP).

my-sonatype-organization.png

Verifying an Organization's License

You are required to verify your organization's license before you can designate your Support Contacts.

You'll be prompted to verify the license when you first create the organization. If you didn't verify it then, follow the steps below:

  1. Open the organization you want to verify.

  2. Click the Licenses tab.

  3. If you haven't verified a license yet, click Verify Now.

  4. Enter your license fingerprint into the text field. Owners and Admins can find the fingerprint from one of the following sources:

    1. The email received when the license was created.

    2. Lifecycle Self-Hosted: Open the System Preference cogwheel dropdown menu and select Product License.

    3. Nexus Repository Self-Hosted: Open the Administration cogwheel and in the left menu and navigate to System → Licensing.

  5. Click Verify License.

After a license is verified, you can view the list of products it covers in the Licenses section.

Downloading a License

Owners and Admins can download an existing license by following the steps below:

  1. Open the organization whose license you want to download.

  2. Click the Licenses tab.

  3. Click the Download License button.

License.png

Adding Members to an Organization

Once you have an Organization, you can add members to it. When you verify your organization, we will try to integrate any existing members from our support case management system into the Organization you just created. However, you can also manually invite members into your Organization.

  1. Open the organization where you want to add members.

  2. Click the Members tab.

  3. Click the Invite Members button.

  4. Add the email addresses of the members you want to invite.

  5. Click Send Invitations.

This will email instructions for signing up for my.sonatype.com. Once that person creates an account with the specified email address, they'll automatically be added to your Organization.

When members are invited to join an Organization, they default to the Member role. Owners and Admins can assign a role to each member by clicking the cogwheel to the right of their info in the Members section. Review the table below for more information about the available roles and their privileges:

Role

Description

Privileges

Member

All users belonging to an organization have this role.

This is the lowest privilege level.

  • View all active members of the Organization

Admin

This role can be assigned to multiple Organization members.

  • All privileges of the Member role

  • Manage the list of members belonging to the Organization

  • Assign the Admin role to other Organization members

  • Verify the Organization

  • Assign members as Authorized Support Contacts

  • Rename the Organization

  • Update the Organization's image

Owner

This is the role assigned to the user who first creates an organization.

This is the highest privilege level.

  • All privileges of the Admin role

  • Delete the Organization

  • Assign another Organization member as new Owner

Assigning Support Contacts

Authorized support contacts are the people in your organization whom you assign to serve as the liaisons between your company and the Sonatype support team. They are chosen from the pool of existing members in your organization.

  • The number of members allowed to be support contacts is determined by the customer contract.

  • Being a member of an Organization does not automatically make them a support contact.

  • Only verified Organizations can have support contacts.

  • Individuals who have been invited to an Organization but haven't accepted the invite email cannot be designated a support contact.

Assign a support contact on my.sonatype.com screenshot

To assign support contacts:

  1. Open the organization where you want to add support contacts.

  2. Click the Support Contacts tab.

  3. Click the Assign a Contact button.

  4. Select the member to be assigned as a support contact.

  5. Click the Assign Now button, and verify the action.

Accessing Cloud Instances

Note

This section is only available for Sonatype Cloud.

my-sonatype-platform-tab.png
  1. Open the organization where you want to view cloud instances information.

  2. Click the Platform tab.

    You’ll see each licensed Sonatype solution instance’s URL and administrator email. Instances are organized by product:

    • Sonatype IQ Server

      Includes any instances for Lifecycle, Repository Firewall, SBOM Manager, and Developer.

    • Sonatype Nexus Repository

      Lists all licensed Nexus Repository instances.

    If you haven’t configured administrator emails yet, you should add them here.

    my-sonatype-administrator-platform-tab.png

Setting up an Identity Provider (IdP)

Note

This section is only available for Sonatype Cloud.

my-sonatype-idp-tab.png
  1. Open the organization to set up an IdP.

  2. Click the Identity Provider tab.

  3. Click the Connect IDP button and follow the on-screen instructions to link your instance’s URL to your IdP.

After setting up an IdP, you can remove it or edit it from this tab.

Select the Enable Identity Provider Groups checkbox to manage access via IdP groups rather than individual users.

my-sonatype-enable-idp-groups.png