User Management - Research Service Workbench on AWS

User Management

Create new admin user

  1. You must go to the Cognito console in your AWS Management Console.

  2. Under User pools, look for and click on rsw-userpool-<stage>-<abbreviation>.

  3. Under the Users tab, choose Create user.

  4. Once the user is created, click on the username and under Group memberships, choose Add user to group to add the user to the ITAdmin group.

Create Users

  1. In RSW Official Postman Collection under users folder choose Create User API.

  2. Send Create User request.

    POST {{API_URL}}/users
    { "firstName": "<first name>", "lastName": "<last name>", "email": "<email address>" }
  3. In the response take note of the id that was returned. We'll refer to this value as USER_ID.

Reset User Password

  1. Go to the Amazon Cognito console in your main account. If prompted, enter your AWS credentials.

  2. Choose User Pools.

  3. Choose your RSW user pool with name rsw-userpool-<STAGE>-<Region>.

  4. Choose the App integration tab.

  5. Under App client list choose RSW app client with name rsw-client-<STAGE>-<Region>.

  6. Under Hosted UI choose View Hosted UI.

  7. If the user has a temporary password, login with your user crendentials and you will be prompted to set a new password.

  8. If the user already has a non temporary password follow instructions here to reset password.

Assign Project to User

Note

Only Researchers and ProjectAdmin require project association.

  1. In RSW Official Postman Collection under projects folder choose Add User To Project API.

  2. In the params tab set userId parameter to the USER_ID value from Create User step.

  3. In the params tab set projectId parameter to the PROJECT_ID value from Setup Project step.

  4. In the body tab set role parameter to the role the user is going to be assigned for the provided project(ProjectAdmin/Researcher).

  5. Send Add User To Project request.

    POST {{API_URL}}/projects/:projectId/users/:userId/relationships

    { "role": "Researcher" }