Skip to end of metadata
Go to start of metadata

This guide explains how to use the features on the User Admin tab of the TCIA Radiology Portal.

Authorizing Protection Groups

An administrator can grant access for a selected user to a protection group with an associated access role. 

To grant access to a protection group and access role

  1. Log in to the TCIA Radiology Portal.
  2. Select the User Admin tab.
  3. Select User Authorization w/ PG.
  4. Select a user name from the list by starting to enter it and selecting the name you want, or by clicking the arrow and selecting a name in the list.
  5. Click Add Protection Group and Access Role button.

    If you know the name of the protection group and access role, you can enter them into the respective fields. As you type, the tool will suggest options matching the characters you entered.

  6. Click Save.

Return to top of page

To change a user's access to a protection group and access role

  1. In the Change the Access column for a selected user, click Change the access button, which is a pencil image.
    The Grant Access to Selected User window appears.
    Grant Access to Selected User window with a Login Name field (grayed out), Protection Group field (grayed out), and Role field (selectable), Delete button, and Update button.
  2. Select a different role and then click Update,
    or
    Click Delete to remove the user's access to that protection group.

Return to top of page

Managing User Groups

TCIA administrators create user groups to limit data access and visibility by protection group and user role. Before or after creating user groups, you can assign users and roles to protection groups.

Managing user groups involves:

Editing or Deleting a User Group

You can edit a user group's name and description. If you choose to delete a user group, you do not delete the users in it.

  1. Log in to the TCIA Radiology Portal and select the User Admin tab.
    The User Authorization Tool appears.
  2. Select the User Group tab.

    User Group tab in the User Authentication Tool

  3. In the row for the user group you want to edit or delete, click Edit button in the Edit User Group column.
    The Edit or Delete Group dialog box appears.
    Edit or Delete the Group dialog box with two text fields, User Group Name and Description, and two buttons, Delete the Group and Save

  4. Edit the User Group Name and/or Description and click Save button.
    or
    Click Delete Group button.

    Warning!

    Clicking the Delete Group button deletes the group immediately. There is no confirmation message in case you change your mind about this action.

Return to top of page

Assigning a Protection Group with Roles to a User Group

An administrator uses protection groups to limit data access and visibility by image collection and site(s). You can assign roles to a protection group and associate that protection group with a user group.

  1. On the User Group tab, in the row of the user group you want to assign protection groups with roles to, click Plus sign button in the Assign Protection Group(s) with Role(s) column.
    The Add Protection Group to Selected User Group dialog box appears. 
  2. From the Protection Group list, select the Protection Group (already created on the Protection Group tab) you want to assign to the selected user group.
  3. From the Role list, select one or more roles to that the user group should have. For more information about these roles and what they are designed to do, see Creating a New NBIA User
  4. Click Save button.
    The user group is now associated with the selected protection group and role(s).

Return to top of page

Modifying the Authorization for a User Group

The authorization for a user group consists of the protection group and its roles assigned to a user group. You can remove the protection group you assigned to the user group. You can then assign a new protection group to that user group. You can also change the assignment of roles to the existing protection group. 

  • On the User Group tab, find the user group you want to modify and expand it by clicking the arrow to the left of the user group name.
    The user group's protection group and assigned role(s) appears.
    the User Group tab of the User Authentication Tool
  • In the row you expanded, click .
    The Modify Authorization for Selected User Group dialog box appears.
    Modify Authorization for Selected User Group dialog box, showing text boxes for User Group Name and Protection Group Name, Remove PG and Update Role a dropdown list for Role, and two buttons, Remove PG and Update Role
  • Click the Role list to open it. Click or clear the checkboxes you want to add or remove, respectively. Click Update Role button.
    or
    To remove this protection group from this user group, click Remove PG button.

Return to top of page

Showing Users Associated with a User Group

You can view the users associated with a user group on the User Group tab but if you want to modify which group those users belong to, you need to authorize them with protection groups.

  1. On the User Group tab, find the user group you want to view.
    Row of the User Group tab showing the 4d-Lung-VCU user group
  2. In that row, clickShow Associated Users button in the Show Associated User(s) column.
    The Users in User Group window appears.
    Users in User Group 4D-Lung-VCU window. No users are in the list.

Return to top of page

Managing Users

Once a user submits data, an administrator adds the user to TCIA. The administrator must create the user in LDAP to manage data access privileges.

What to do if the user is not in LDAP

Contact the Help Desk to request that a user be added to LDAP.

Managing users involves:

Adding a User to TCIA

  1. Log in to the TCIA Radiology Portal and select the User Admin tab.
    The User Authorization Tool appears.
  2. Select the User tab.
    User tab of the User Authentication Tool
  3. Click Add User button.
    The User Details dialog box appears.
  4. Add the user's Login Name. The login name is not case-sensitive.
  5. Add a valid Email address of the user.
  6. To activate the user, set Active Status to True. To deactivate the user in TCIA, set Active Status to False.

  7. Click Save button to save the changes.
    The user is added to TCIA and the table on the User tab.

Return to top of page

Finding a User

To find a user on the User tab, narrow the list by adding one or more characters to one or more column header boxes.

In the following example, the displayed users have aa as part of their login name.

Filter of users by login name

Return to top of page

Updating User Information

  1. On the User tab, find the user whose information you want to update.
  2. Click Edit User button.
    The user information becomes editable.
    User details including email address and status, and a checkmark icon and X icon.

  3. Update the email address and status as needed. Note that a user cannot be deleted from TCIA, only deactivated. The Login Name cannot be updated.

  4. Click Checkmark iconto save the changes or X mark icon to cancel the change.
    The user information is updated in the table.

Return to top of page

Managing Protection Groups

A TCIA administrator uses the Protection Group tab to create protection groups and assign protection elements to them to limit data access and visibility by image collection and site.

Protection elements are created automatically

TCIA automatically creates protection elements when data is submitted.

Managing protection groups involves:

Adding a Protection Group

  1. Log in to the TCIA Radiology Portal and select the User Admin tab.
    The User Authorization Tool appears.
  2. Select the Protection Group tab.
  3. Scroll to the end of the page and click Add Protection Group button.
    The Protection Group Details dialog box appears.
    Protection Group Details dialog box with two text boxes, Protection Group Name and Description, a Save button, and a Delete button
    • In the Protection Group Name field, start the name with "NCIA” followed by a dot, then enter your name of choice. For example: NCIA.Prostate-3T.

      No Special Characters

      Do not use special characters such as # or \ in group names.

    • Optionally, enter a description.

  4. Click Save button to save the changes.
    The protection group is added to the table.

Return to top of page

Associating Protection Elements with a Protection Group

Seting up security for a collection's visibility in TCIA involves creating a protection group for it and then assigning protection element(s) to it. The protection element identifies the collection and site associated with the data.

Data Access and Protection Elements

To associate a protection element with a protection group

  1. On the Protection Group tab, find the protection group you want to edit.
  2. Click Assign Protection Element icon in the Assign/Remove Protection Element(s) column.
    The Add Protection Element(s) to Protection Group window appears.
    Add Protection Element(s) to Protection Group dialog box
  3. Open the list next to Available Protection Elements.

  4. Select the elements to be associated with the protection group by clicking the box to the left of the element name. You can select more than one.

    Narrowing a List

    To narrow the list of protection elements, type the name or part of the name next to the magnifying glass icon (Magnifying glass icon).

    Filter box with a checkbox, text box where you can enter a protection element name or partial name, and magnifying glass icon. In this example, it says No results found.

  5. Click Add button to save the changes.

    The Associated Protection Element(s) column lists the elements that you added.

    In the following example protection element, NCIA.SportInjury//ACL

    • NCIA.SportInjury is the collection.
    • ACL is the site.

      Multiple Sites

      If there are multiple sites for a collection, you might want to create a protection group for each site. This process would grant access to verify submissions per site.

Return to top of page

Removing Protection Elements from a Protection Group

  1. Click Remove protection elements icon in the Remove Protection Element(s) column.
    The Remove Protection Element(s) from Protection Group window appears.
    Remove Protection Elements from Protection Groups with two text boxes, Protection Group Name and Included Protection Elements, and a Remove button.
    The Protection Group Name cannot be changed.
  2. Open the list next to Included Protection Elements, and select the elements to remove.

    Narrowing a List

    To narrow the list of protection elements, type the name or part of the name next to the magnifying glass icon (Magnifying glass icon). 

    Filter box with a checkbox, text box where you can enter a protection element name or partial name, and magnifying glass icon. In this example, it says No results found.

    Click x to return without saving.

  3. Select the elements you want to remove by clicking the box to the left of the element name. You can select more than one.
  4. Click Remove button to save the changes.
    The protection element you removed is no longer listed in the Associated Protection Elements column.

Return to top of page

Finding a Protection Group

On the Protection Group tab, you can perform a global search or a column search, which are both described in the following table.

 You can perform both searching techniques to filter a list, but do not forget to clear the search boxes to expand the list.

Type of SearchPerforming a Search
Global Search

You can search for a term or part of a term in all the protection group columns in the table. All protection groups with the characters you entered are returned.

In the following example, a Global Search on brain finds protection groups with "brain" in the Protection Group name and the Associated Protection Elements.

List of protection groups with search word of brain
Column Search

You can also find protection groups in the table by adding a term to a column header or more than one column header to further narrow the list.

In the following example, searching for pilot in the Protection Group column displays the following results.

Return to top of page

Updating a Protection Group Description

  1. On the Protection Group tab, find the protection group you want to update.
  2. Click Edit protection group button.
    The Protection Group Details window appears.

  3. Update the group description.
    Note that you cannot update the protection group name.

  4. Click Save button to save the changes.

Return to top of page

Deleting a Protection Group

  1. On the Protection Group tab, find the protection group you want to delete.
  2. Click Edit protection group button.
    The Protection Group Details window appears.

  3. Click Delete button.
    The row is removed from the table.

Return to top of page

Managing Protection Elements

The TCIA administrator can create new protection elements, which consist of collection names and site names, so that when new images are submitted, they can be associated with these protection elements. Administrators can then add these protection elements to a protection group or remove these protection elements from a protection group.

Topics in this section include:

Adding a Protection Element to a Protection Group

  1. Log in to the TCIA Radiology Portal and select the User Admin tab.
    The User Authorization Tool appears.
  2. Select the Protection Element tab.
    The Protection Element tab appears.

    Protection Element tab of the User Authentication Tool

    You can sort the list of Collections and Sites by clicking the arrows. If both arrows are showing (Two arrows pointing on top of one another, one pointing up and one pointing down), that column is displaying its default sort order. If one arrow is showing, the column is sorted alphabetically in the direction the arrow is pointing.

  3. Click Add Protection Element button.
    The Protection Element Details window appears.
    Protection Element Details window with text boxes for Collection and Site and a Save button.
  4. Enter a name for the new collection and new site.
  5. Click Save button.

Return to top of page

Adding Protection Groups and Assigning Roles

A TCIA administrator creates protection groups to limit data access and visibility by image collection and site(s). Administrators add users to protection groups and can then further manage their access by assigning them one or more roles. Users can only access the protection group data in the way that the role specifies.

For example, John Smith needs to be a curator within the Mouse Astrocytoma protection group, so user johnsmith is assigned to protection group TCIA Mouse Astrocytoma with the role of CURATOR.

Topics in this section include:

Adding a Protection Group

  1. Log in to the TCIA Radiology Portal and select the User Admin tab.
    The User Authorization Tool appears.
  2. Select the Protection Group tab.
  3. Scroll down to the bottom of the page and click Add Protection Group button.
    The Protection Group Details window appears.
  4. Enter a name for the new group and optionally, a description.

    No Special Characters

    Do not use special characters such as # or \ in group names.

  5. Click Save button.
    The protection group appears on the Protection Group tab.

Return to top of page

Assigning a User to a Protection Group with Roles

Super Administrator

If you are a Super Administrator for one protection group, your privileges extend to all of the protection groups.

To assign a user to a protection group and assign roles

  1. Log in to the TCIA Radiology Portal and select the User Admin tab.
    The User Authorization Tool appears.
  2. Select the User Authorization w/PG tab.
    User Authorization with PG tab
  3. Select a user name from the list at the top left.
    A page listing the protection groups and access roles associated with the selected user appears.

  4. Click Add Protection Group and Access Role button.
    The Grant Access to Selected User window opens.
    Grant Access to Selected User page

  5. From the Protection Group list, select the group to which you want to assign the user.
  6. From the Role list, select the access role that the user should have in that protection group.
    The following table lists and describes the access roles available in TCIA.

    Access Role
    Description of Access Role
    NCIA ADMIN

    Access the User Authorization Tool to manage users

    NCIA CURATE

    Add or modify curation data

    NCIA DELETE_ADMIN

    Super Administrator role for deletions

    NCIA MANAGE_COLLECTION_DESCRIPTION

    Manage collection descriptions

    NCIA MANAGE_VISIBILITY_STATUS

    Access the Quality Control (QC) Tool

    NCIA READ

    Public role for searching

    NCIA SUPER_CURATOR

    Super Administrator role for approving deletions

    NCIA VIEW_SUBMISSION_REPORT

    Access the Submission Reports option to verify submissions.

  7. Click Save to save the changes.

    The row is added to the table.

    Working with the table

    To adjust how the table is sorted, click the arrows in the column header. To narrow the list, type the name or part of the name in the column header. You can also enter information in multiple column headers to further narrow the list.

Return to top of page

Changing a User's Access Role Within a Protection Group

  1. Log in to the TCIA Radiology Portal and select the User Admin tab.
    The User Authorization Tool appears.
  2. Select the Protection Group tab.
  3. Select a user from the list in the top left.
    A page listing the protection groups and access roles associated with the selected user opens.

  4. In the row of the protection group you want to change, click Change Access button.
    The Grant Access to Selected User dialog box opens.

    Grant Access to Selected User, Update

  5. To change the user's access to roles in this protection group, click the down arrow to open the Role list. Select the boxes next to roles you want to assign to the selected user. Clear the boxes next to roles you do not want the user to have. Click Update button to save your changes.

    To delete a role, open the Role list, select a role, and click Delete button.

    The User Authentication tab appears.

Return to top of page

Authorizing User Groups

An administrator can grant a user access to a user group and remove a user's access from a user group.

Granting a User Access to a User Group

  1. Log in to the TCIA Radiology Portal.
  2. Select the User Admin tab.
    The User Authorization Tool appears.
  3. Select User Authorization w/ User Group.
  4. Select a user name from the list at the top of the screen.
    User Authorization with User Group tab of the User Authorization Tool

    Click the arrow in the Select a user name list to open a text box where you can find a user name quickly by entering a name or partial name. 

  5. Click the user whose access you want to change.
    The page refreshes with a list of user groups the user has access to.
    User Authorization with User Group tab showing a selected user, NBIAtest1, and a list of user groups this user can access.
  6. Click Add Group button.
    The Assign Group(s) to Selected User window appears.
  7. Click the arrow next to the Groups box. 
    A list of groups you can select appears.
    An empty text box with a magnifying class, followed by a list of user groups. Each group has a box to the left of it you can click to select the group.
  8. Click the box to the left of the user group you want to authorize for this user. You can select as many as you want. When you are done selecting groups, click the X at the top of the list of user groups or click outside the list.
    The groups you selected appear in the Assign Group(s) to Selected User window.

    To find the user group quickly, enter the whole or partial user group name in the search box at the top. If you only want to select one user group, enter it into the search box and then click the box to the left of the search box. If you want to select more than one user group, do not do this but rather select the groups in the user group list.

  9. Click Save button.

Removing a User's Access from a User Group

  1. Log in to the TCIA Radiology Portal.
  2. Select the User Admin tab.
    The User Authorization Tool appears.
  3. Select User Authorization w/ User Group.
  4. Select a user name from the list at the top of the screen.
    User Authorization with User Group tab of the User Authorization Tool

    Click the arrow in the Select a user name list to open a text box where you can find a user name quickly by entering a name or partial name. 

  5. Click the user whose access you want to change.
    The page refreshes with a list of user groups the user has access to.
    User Authorization with User Group tab showing a selected user, NBIAtest1, and a list of user groups this user can access.
  6. Find the user group you want to deassign from the user. To find the user group quickly, enter a name or partial name in the User Group box.
  7. Click  next to that user group.
    A confirmation message appears. Click Yes or No as appropriate.

  • No labels