Appearance
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
| Role | Intended for | Access |
|---|---|---|
x_sofbv_sofiehub.admin | Administrators who configure integrations | Create, change and delete all configuration, and use Import and Properties |
x_sofbv_sofiehub.integration_ro_admin | Support and review | Read all configuration, queue records and logging; no changes |
x_sofbv_sofiehub.integration_logreader | Monitoring | Read integrations, queue records and logging only |
x_sofbv_sofiehub.integration_user | Not required | Integration 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.
Menu access
| Module | admin | integration_ro_admin | integration_logreader |
|---|---|---|---|
| Integrations | ✓ | read | read |
| Endpoints, Triggers, Web Services, Pollings, Actions, Mappings, Response Handlers, Validation Rules | ✓ | read | – |
| Queue Records | ✓ | read | read |
| Logging | ✓ | read | read |
| 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.
| admin | integration_ro_admin | integration_logreader | No 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.
