How roles work in DCB Admin

Certain functionality in DCB Admin is role-restricted. This document explains what those roles are, which functionality is affected, and how to tell what role your account currently has.

What are the roles in DCB Admin?

These roles are defined within Keycloak and assigned to individual users through the Keycloak management console.

  • ADMIN: Generally only available to developers. This role has access to all functionality in DCB Admin.

  • CONSORTIUM_ADMIN: Available to staff at the consortium central office. This role has access to almost all functionality in DCB Admin.

  • LIBRARY_ADMIN (planned): This will be available to library staff. It will have access to functionality concerning that specific library only.

  • No special role: Users without any of these roles essentially have ‘read-only’ access to DCB Admin.

Which functionality is role-restricted?

ADMIN and CONSORTIUM_ADMIN only

Mappings

  • Uploading mappings for a Host LMS

  • Editing the ‘to value’ of a reference value mapping, and the ‘mapped value’ of a numeric range mapping.

  • Deleting an individual mapping.

Locations

  • Editing the name, latitude and longitude of a location.

  • Deleting a location.

  • Changing the pickup status of a location.

Libraries

  • Editing the following attributes of a library

    • Full name

    • Short name

    • Abbreviated name

    • Backup/downtime schedule

    • Support hours

    • Latitude and longitude

  • Editing a library’s contacts.

  • Deleting a library.

  • Changing the participation status of a library (toggling borrowing / supplying).

Patron requests

  • Manually finalising patron requests.

  • ‘Check for updates’ on a patron request.

Data change log

  • Only users with CONSORTIUM_ADMIN or greater can see the data change log.

How do I see which roles my account has?

You can view the role of the currently signed-in account by clicking on the ‘Profile’ icon (to the left of the LOGOUT button). This will take you to a screen where you can see the information of the currently logged-in user, including their roles.

Operated as a Community Resource by the Open Library Foundation