Skip to content

Sofie's Integratie Hub comes with four roles. They control who can open the Sofie's Integratie Hub application and what they can see or change there.

Integrations do not need a role

Integrations run without any Sofie's Integratie Hub role:

  • Outgoing: messages are created and sent no matter which roles the user who updates the record has. An ITIL user, or a user without any role, triggers outgoing integrations as usual.
  • Incoming: an integration user only needs to be linked to the Web Service (see Web Services). The SofieHub Endpoint does not require a Sofie's Integratie Hub role.

Grant the roles below only to people who need to work in the application itself.

Overview ​

RoleIntended forAccess
x_sofbv_sofiehub.adminAdministrators who configure integrationsCreate, change and delete all configuration, and use Import and Properties
x_sofbv_sofiehub.integration_ro_adminSupport and reviewRead all configuration, queue records and logging; no changes
x_sofbv_sofiehub.integration_logreaderMonitoringRead integrations, queue records and logging only
x_sofbv_sofiehub.integration_userNot requiredIntegration users do not need this role (see the tip above)

Users with the ServiceNow admin role have full access without any of these roles.

The roles do not include each other. For example, x_sofbv_sofiehub.admin does not contain x_sofbv_sofiehub.integration_logreader.

Moduleadminintegration_ro_adminintegration_logreader
Integrations✓readread
Endpoints, Triggers, Web Services, Pollings, Actions, Mappings, Response Handlers, Validation Rules✓read–
Queue Records✓readread
Logging✓readread
Attachment Status✓read–
Dashboard✓read–
Properties✓––
Import✓––
Documentation✓✓✓

Integration field on tasks ​

Tasks (for example incidents and changes) have an Integration field that shows which integration the record belongs to. The field is filled by the integration itself, so users never have to fill it in.

adminintegration_ro_adminintegration_logreaderNo role
See the field✓✓––
Change the field✓–––

The Update by Integration field is not restricted.

Choosing a role ​

  • Configures integrations: x_sofbv_sofiehub.admin
  • Investigates issues, but should not change anything: x_sofbv_sofiehub.integration_ro_admin
  • Only monitors messages and errors: x_sofbv_sofiehub.integration_logreader
  • Only works with tickets (for example a service desk): no role needed

Message content

Queue records contain the full request and response messages. Users with integration_ro_admin or integration_logreader can read this content, which may include personal data.