Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents


Service users are programmatic (machine) users that can communicate with WhiteSource via the APIs with no access to the GUI. These users assist with the automation in the CI/CD workflow and enable the organization administrators to manage these users via the GUI.

Creating a Service User


To create a service user, do as follows:


  1. From the home page, select Admin. The Organization Administration screen is displayed.

  2. In Users, select Create Service User. The Create New Service User dialog box is displayed.

    Image Removed
  3. Do as follows:

    1. In Full Name, enter the service

    username. Note that in
    1. user’s name.

    2. In Email, an email address is auto-generated according to the user name, so leave as is. NOTE:

    1.  No email notifications or alerts will be sent to this email address. The email address is used only for reporting purposes.

      The service user is created and assigned to the default

    1. Users group.

    1. At the bottom of the dialog box, a user token is also displayed for this user

    Click the 'copy' icon next
    1. .

  4. Next to the user token, click the copy icon to


    copy the new user token.

    Image RemovedImage Added
  5. Click Close. The service user is now displayed in the users table. Unlike regular users, the account status of service users includes the text Service User, and it is indicated as a service user by

    aImage Removedavatar.

Managing Service Users

You can do the following from the specific service user's links that are displayed on the users table:

  • copy token: Copy the user token.
  • remove: Removes the service user.

Image Removed


  1. this avatar:

    Image Added

Removing a User

To remove a service user, do as follows:

  • In the Users table, in the user’s row, click Remove. The user is removed.

Managing User Groups

You can add/remove a service user to/from a group. Do as follows:

  1. From the home page, select Admin. The Organization Administration screen is displayed.

  2. In System, select Groups. The Groups screen is displayed.

  3. In the Groups table, select either Users or Admins - this determines to which group the user will be added.

  4. Click Add Users. The Add Users to Groups dialog box is displayed.

  5. Select the user that you want to add to the group (you can select multiple users).

  6. Click OK. The user is added to the group.