[!Warning]
This repository has been deprecated. We will not be making any changes or enhancements to this repository. If you are actively using this utility. Please contact your Customer Success Manager to get in touch with a Mend Professional Services Engineer to discuss possible alternative solutions.

]

WhiteSource IAM User Management

API Service to perform users operations on large scale environment (Global Organizations).
The service supports 2 actions:

1. Create and assign users to products with multi-organization setup.

   1. Create user in the organization.
   2. Create group with the role name in the organization.
   3. Assign user to the designated group
   4. Assign group to given product(s)

   Call: /createAndAssignUser

   {
     "userName": "userName", 
     "userEmail": "userEmail",
     "ghOrgNames": [ghOrgName1, ghOrgName2, …],
     "wsRole": "ws_role" 
   }
   

2. Delete users from multi organizations
   Call: /deleteUser

   {
     "userEmail": "user_mail",
     "ghOrgNames": [gh_org_name_1, gh_org_name_2, … ],
   }
   

Prerequisites

• Provided user key must be defined as Global admin and admin on all organizations

Installation

Download and deploy Docker image:

docker pull ghcr.io/whitesource-ps/ws-ums:latest
docker run --name ws-ums -p 8432:8432 -e WS_USER_KEY=<WS_USER_KEY> -e WS_GLOBAL_TOKEN=<WS_GLOBAL_TOKEN> -e WS_URL=<WS_URL> \
-e WS_INVITER=<WS_INVITER> -v /<PATH>:/tmp whitesourcetools/ws-ums