# Managing Administrator Roles and Permissions

UNIWeb administrators are differentiated from general UNIWeb members because they can perform certain tasks within UNIWeb that general users cannot, or would not need to. The ability to perform a particular administrative task is called a [***permission***](#administrator-permissions).

Not every UNIWeb administrator will need access to every permission across the entire UNIWeb network. Generally, a small number of users will need to have a particular set of permissions to perform administrative tasks within their academic unit. Accordingly, UNIWeb delegates administrator permissions through the creation of administrator ***roles***, groupings of permissions that are restricted to a particular [academic unit](https://guides.uniweb.io/uniweb-accounts/academic-units) and its sub-units. Roles can be assigned, modified, and removed from multiple UNIWeb members at once.

For example, a department of health sciences may have 3 faculty members that are dedicated to performing administrative tasks within the health sciences academic unit. These three administrators could be assigned a single role that looks like this:

| Role Name                         | Academic Unit   | Permissions                                                                                                                                                                                                         |
| --------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Health Sciences Administrator** | Health Sciences | <ul><li>Approve new themes</li><li>Assign roles to members</li><li>Create new accounts</li><li>Delete existing accounts</li><li>Edit member information</li><li>Send email invites</li><li>View analytics</li></ul> |

As the role in the example above applies only to the Health Sciences academic unit, the administrators who have been assigned the role above would ***only be able to perform those tasks within the Health Sciences academic unit and its sub-units***. If the role above is modified - if permissions are added or removed - those modifications would be applied to all three administrator accounts at the same time.

When your institution sets up their network, the Proximify team will create your first administrator accounts. As an administrator, it is your responsibility to create and assign roles to future users.

#### On this page:

* [Creating Administrator Roles](#creating-administrator-roles)
* [Editing Administrator Roles](#editing-administrator-roles)
* [Deleting Administrator Roles](#deleting-administrator-roles)
* [Administrator Permissions](#administrator-permissions)

## <img src="https://2954995804-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LnTRAckO4EmWYdsPpjv%2F-LvMbzpcgW9Kg4ozG7L0%2F-LvMcBhHRhUWSJmNl5h2%2Fkey.svg?alt=media&#x26;token=12b60dce-d2bc-4664-8e7d-e721fa690c10" alt="" data-size="line"> Creating Administrator Roles

{% hint style="warning" %}
**Before you begin:** this procedure requires an administrator role within the subject’s academic unit that includes the following [permissions](#administrator-permissions):

* Edit Roles

If you have not been assigned a role with the permissions listed above, and believe that you should be able to perform this task within your academic unit, please contact your system administrator.
{% endhint %}

1. From your [UNIWeb Administration ](https://guides.uniweb.io/navigating-uniweb/the-administration-page)page, go to **Access Control**
2. Click the **Add role** button in the left panel
3. In the *New Role* dialog, type in a **Role name** and select the **Academic Unit** where the new role’s permissions will be applied. You may only create Roles within your own Academic Unit and its sub-units.
4. Select the [**permissions**](#administrator-permissions) that you would like to assign to the new role. You may only assign permissions that you have access to within your Academic Unit.
5. Click **Save**.

{% hint style="info" %}
**Tip:** The permissions that you assign to a role are applied within the role’s selected academic unit and all of its sub-units. If you want a role to have access to all members and academic units of the network, choose the name of your institution as the academic unit for the role.
{% endhint %}

## <img src="https://2954995804-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LnTRAckO4EmWYdsPpjv%2F-LvMbzpcgW9Kg4ozG7L0%2F-LvMcBhHRhUWSJmNl5h2%2Fkey.svg?alt=media&#x26;token=12b60dce-d2bc-4664-8e7d-e721fa690c10" alt="" data-size="line"> Editing Administrator Roles

{% hint style="warning" %}
**Before you begin:** this procedure requires an administrator role within the subject’s Academic Unit that includes the following [permissions](#administrator-permissions):

* Edit Roles

If you have not been assigned a role with the permissions listed above, and believe that you should be able to perform this task within your academic unit, please contact your system administrator.
{% endhint %}

1. From your [UNIWeb Administration ](https://guides.uniweb.io/navigating-uniweb/the-administration-page)page, go to **Access Control**
2. In the left panel, locate and **click on the role** that you would like to modify. You may only edit roles within your Academic Unit and its sub-units.
3. In the role dialog, you can modify the role name, Academic Unit, and select or deselect permissions for the role. You may only assign permissions that you have access to within your Academic Unit.
4. Select the [**permissions**](#administrator-permissions) that you would like to assign to the new role
5. Click **Save.**

{% hint style="danger" %}
**Note:** Any changes made to an existing role will immediately affect all of the administrators who have previously been assigned that role.
{% endhint %}

## <img src="https://2954995804-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LnTRAckO4EmWYdsPpjv%2F-LvMbzpcgW9Kg4ozG7L0%2F-LvMcBhHRhUWSJmNl5h2%2Fkey.svg?alt=media&#x26;token=12b60dce-d2bc-4664-8e7d-e721fa690c10" alt="" data-size="line"> Deleting Administrator Roles

Roles cannot be deleted, but their [permissions](#administrator-permissions) can be revoked. Roles that do not have any permissions assigned are greyed out and considered inactive, but can be made active again by reassigning permissions to it.

{% hint style="warning" %}
**Before you begin:** this procedure requires an administrator role within the subject’s academic unit that includes the following [permissions](#administrator-permissions):

* Edit Roles

If you have not been assigned a role with the permissions listed above, and believe that you should be able to perform this task within your academic unit, please contact your system administrator.
{% endhint %}

1. From your [UNIWeb Administration ](https://guides.uniweb.io/navigating-uniweb/the-administration-page)page, go to **Access Control**
2. In the left panel, locate and **click on the role** that you would like to modify. **You may only edit roles within your academic unit and its sub-units.**
3. In the role dialog, deselect all of the role’s assigned permissions.
4. Click **Save**.

{% hint style="danger" %}
**Note:** Any changes made to an existing role will immediately affect all of the administrators who have previously been assigned that role.
{% endhint %}

## Administrator Permissions

| Permission Name                     | Permission Function                                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Approve new themes**              | Edit, delete or approve [**research themes**](https://guides.uniweb.io/networking-on-uniweb/research-themes/managing-research-themes) that have been proposed by UNIWeb members within your Academic Unit.                                                                                                                                                                                                         |
| **Assign roles to members**         | [**Assign roles**](https://guides.uniweb.io/uniweb-accounts/access-control/managing-administrators) to grant other UNIWeb members **administrator access** to your Academic Unit or its sub-units.                                                                                                                                                                                                                 |
| **Create API clients**              | Grant other software systems secure read/write access to information stored by UNIWeb. See **API Access** for more information.                                                                                                                                                                                                                                                                                    |
| **Create new accounts**             | [**Create**](https://guides.uniweb.io/account-management/account-creation#creating-uniweb-member-accounts-manually) UNIWeb member accounts.                                                                                                                                                                                                                                                                        |
| **Delete existing accounts**        | [**Delete**](https://guides.uniweb.io/account-management/account-deletion#deleting-a-uniweb-members-account) UNIWeb member accounts.                                                                                                                                                                                                                                                                               |
| **Edit academic units**             | Create, edit or delete [**academic units**](https://guides.uniweb.io/academic-units/managing-academic-units#create-an-academic-unit-manually) and [**unit types**](https://guides.uniweb.io/academic-units/managing-academic-units#add-a-unit-type).                                                                                                                                                               |
| **Edit equipment information**      | Create, edit or delete **equipment / resource profiles**.                                                                                                                                                                                                                                                                                                                                                          |
| **Edit member information**         | [**Edit the public profile data of UNIWeb members**](https://guides.uniweb.io/networking-on-uniweb/filling-out-your-public-profile#filling-out-another-uniweb-members-public-profile) in your academic unit, **view their CV information**, and [**generate CVs and Reports**](https://guides.uniweb.io/your-academic-information/downloading-cvs-and-reports#downloading-member-cvs-and-reports) on their behalf. |
| **Edit roles**                      | Add, edit or delete [**administrator roles**](https://guides.uniweb.io/uniweb-accounts/access-control/managing-administrator-roles-and-permissions).                                                                                                                                                                                                                                                               |
| **Edit web articles**               | Add, edit or delete **web articles**.                                                                                                                                                                                                                                                                                                                                                                              |
| **Receive new theme notifications** | Get automatic emails whenever a new [**research theme**](https://guides.uniweb.io/networking-on-uniweb/research-themes/managing-research-themes#approving-research-themes) is created by a UNIWeb member in your Academic Unit.                                                                                                                                                                                    |
| **Receive signup notifications**    | Get automatic emails whenever a new UNIWeb member completes the [**UNIWeb signup process**](https://guides.uniweb.io/uniweb-accounts/account-management/account-creation).                                                                                                                                                                                                                                         |
| **Send email invites**              | Invite users to join the UNIWeb network by [**sending account sign-up invitations**](https://guides.uniweb.io/account-management/account-creation#sending-account-activation-emails) and **reminder emails**.                                                                                                                                                                                                      |
| **Upgrade profile schema**          | Accept requests to update profile schemas.                                                                                                                                                                                                                                                                                                                                                                         |
| **View analytics**                  | View and download **Academic Metrics** data from an Academic Unit.                                                                                                                                                                                                                                                                                                                                                 |

####
