Principal Investigator’s can add users to their groups (named by proposal-ids) in order to allow others to access the data on the archive or submit blocks on the OPT for that project.

What is a group for?

You can manage who has access to your data using groups in keycloak. Each Proposal ID has an associated group. Every member of your group will be able to see your data when they log into the archive interface.

You can add or remove anybody who has registered to your group.

How do I get rights to manage a group?

You will need to be added as an administrator to the group. You will have to ask your SARAO contact person to organise this for you. You will either have to be a Principal Investigator or technical lead for the group or have the permission of the PI to manage the group for them.

Where do I manage my groups

Direct your web browser to 

https://keycloak.sarao.ac.za/admin/SKASA/console/

You will be directed to log in via SARAO login interface (See Figure 1).

Open

Figure 1: Keycloak login

On logging in you will be directed to the keycloak management portal (See Figure 2).

Open

Figure 2: Keycloak management interface

If access denied please contact your PI or raise a ticket on the MeerKAT service desk.

View group membership

Click on groups on the keycloak landing page.

Open

Figure 3: Groups

Search for your group (for example the Test user is the admin of the proposal EXT-20240516-SB-01). Click on the group in the results.

Open

Figure 4: Search for group

Open

Figure 5: The membership list can be viewed under the membership tab

Add user to group

The user to be added must already be registered on the SARAO archive (see https://skaafrica.atlassian.net/wiki/spaces/ESDKB/pages/333676627/Getting+a+SARAO+account?atlOrigin=eyJpIjoiNmU2ZjI2ZjA1NzJkNDIzNWE4OGVmNjQwMTU5ODNkZDUiLCJwIjoiYyJ9 ).

Click on the add member button for the group

Open

A search page will open. Search for the user by name or email address. Select the correct user and press the add button.

Open

Figure 6: Adding a new user to the group

Open

Figure 7: The new user is shown in the group

Remove a user from your group

1. Complete the steps under https://skaafrica.atlassian.net/wiki/spaces/ESDKB/pages/edit-v2/2722103298#View-group-membership earlier in this document

2. Select the user you wish to remove.

3. Click leave to remove the user from the group.

Open

Figure 8: Removing a user from the group