Difference between revisions of "Mailbox Rights and Roles"

From Hornbill
Jump to navigation Jump to search
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOTOC__[[Main Page|Home]] > [[Administration]] > [[Email Administration]] > Set Up Email
+
This document can now be found at its new location in the [https://docs.hornbill.com/esp-config/email/shared-mailboxes#associated-roles/ Hornbill Document Library].
  
 +
[[file:hornbill-document-library.png|Shared Mailbox Roles|link=https://docs.hornbill.com/esp-config/email/shared-mailboxes#associated-roles/]]
 +
<!--
 +
 +
 +
<div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;">
 +
__NOTOC__
 +
{| style="width:100%"
 +
|[[Main Page|Home]] > [[Administration]] > [[Email Administration]] > Mailbox Rights and Roles
 +
|style="text-align:right;"|[[:Category:Service Manager Administration|Index]]
 +
|}
 +
</div>
 +
{|style="width: 100%"
 +
|- valign="top"
 +
|style="width:73%"|
 +
== Introduction ==
 
Email is used by the Hornbill applications in various processes. For example, Service Manager within Incident management it can be used to both receive [[What_are_Requests? |requests]] to create a call or to communicate progress or resolution of a request.  
 
Email is used by the Hornbill applications in various processes. For example, Service Manager within Incident management it can be used to both receive [[What_are_Requests? |requests]] to create a call or to communicate progress or resolution of a request.  
  
Your new Hornbill instance is equipped with a default mailbox (helpdesk) which has an inbound service and email address already configured. This can be used to get up and running more quickly. To begin using the default mailbox (or any other new Shared Mailbox you create) a new Security Role must be created. Before creating a new role for use with your shared mailbox, we recommend reading general information on the Hornbill Roles, please see the [[Roles]] wiki page.
+
Your new Hornbill instance is equipped with a default mailbox (helpdesk) which has an inbound service and email address already configured. This can be used to get up and running more quickly. To begin using the default mailbox a new Security Role must be created. Before creating a new role for use with your shared mailbox, we recommend reading general information on the Hornbill Roles, please see the [[Roles|'''Roles''']] wiki page.
 +
 
 +
|style="width:5%"|
 +
|
 +
|style="width:22%; border-style: solid; border-width: 1px; border-color:#e6e6e6; background-color:#f2f2f2;"|
 +
 
 +
== Related Articles ==
 +
:* [[Email_Administration|Email Administration]]
 +
:* [[Shared_Mailboxes|Configuring Shared Mailboxes]]
 +
:* [[Mailboxes|Working With Shared Mailboxes]]
 +
|}
  
 
== Creating a Shared Mailbox Role ==
 
== Creating a Shared Mailbox Role ==
 +
::[[File:New_Mailbox_Role.PNG|700px|right|thumb|<div align="center">'''Create a new Security Role'''</div>]]
 +
=== Create a New Security Role ===
 +
Navigate to '''''Home > System > Organisational Data > Roles''''' in Hornbill Administration
  
Roles are created via Hornbill Administration '''Home > System > Organisational Data > Roles'''
+
:Click 'Create New Role'(located to the top right of the list) and populate the fields as follows:-
 +
:::* '''Role ID''': Mailbox – ''mySharedMailboxname''
 +
:::* '''Privilege Level''': User
 +
:::* '''Type''': Security
 +
:::* '''Description''': This Role will be used to grant access to the ''mySharedMailboxname'' Shared Mailbox
  
:# Click 'Create New Role'(located to the top right of the list) and populate the fields as follows:-
+
:At this stage the "Applications" and "Shared Mailboxes" fields aren't active so simply click 'Create Role'
:::* Role ID: Mailbox – Helpdesk
 
:::* Privilege Level: User
 
:::* Description: This Role will be used to grant access to the ''xxxxx'' Shared Mailbox
 
::[[File:New_Mailbox_Role.PNG|700px|Creating a Role to control Shared Mailbox Access]]
 
At this stage the "Applications" and "Shared Mailboxes" fields aren't active so simply click 'Create Role'
 
 
<br>
 
<br>
 
<br>
 
<br>
Now complete the remaining fields. A role purely governing access to a Shared Mailbox does not need application context so the "Applications" field can be left blank.
+
=== Associate a Shared Mailbox to the New Role ===
:::* Shared Mailboxes: helpdesk
+
::[[File:Mailbox_Role_Select_Mailbox.PNG|700px|right|thumb|<div align="center">'''Associate a Mailbox to the new role'''</div>]]
 +
:Now complete the remaining fields. A role purely governing access to a Shared Mailbox does not need application context so the "Applications" field can be left blank.
 +
:::* '''Shared Mailboxes''': select the relevant shared mailbox
 
:::* Click 'Save'
 
:::* Click 'Save'
 
 
A further tab will now be exposed at the top of the form labelled "Shared Mailbox Rights".
 
A further tab will now be exposed at the top of the form labelled "Shared Mailbox Rights".
 
+
<br>
 +
<br>
 +
=== Select the desired rights ===
 +
::[[File:Mailbox_Role_Mailbox_Saved.PNG|700px|right|thumb|<div align="center">'''When a Mailbox is associated, a new tab appears called "Shared Mailbox Rights"'''</div>]]
 
:::* Click the “Shared Mailbox rights” Tab
 
:::* Click the “Shared Mailbox rights” Tab
:::* Then set the following rights...
+
:::* Then set the desired rights
::[[File:Email_rights.png|700px|Minimum Email Rights for a User]]
 
:::* 'Save changes'
 
::2.  [[Roles|'''Associate the Role to a User''']] who will require access to this mailbox
 
 
 
 
 
== Integrate with your own Email ==
 
 
 
Hornbill includes some powerful email integration capabilities. This is performed in Hornbill Administration in the context of Instance Configuration under the "Email" menu item.
 
  
See [[Email_Administration]] for information on configuring
+
==== Suggested Rights for a Typical User====
:::*[[Email_Domains|Email Domains]]
+
This set of rights allows a user to perform all the common actions required to process messages that are received by the Shared Mailbox. It allows a user to view and manage the contents of the shared mailbox.
:::*[[Shared_Mailboxes|Shared Mailboxes]]
+
:::* Can Get Folder Properties
:::*[[Email_Routing_Rules|Email Routing Rules]]
+
:::* Can Get message
 +
:::* Can Flag Message
 +
:::* Can Delete Message
 +
:::* Can Add File Attachment
 +
:::* Can send message
 +
:::* Can Edit Message
 +
:::* Can Search Message
  
[[Category: Email_Administration]][[Category: Administration]]
+
==== Minimum Rights for Sending An Email ====
 +
This set of rights only allows an agent to send a message from the Hornbill Platform. It does not allow the user to view or process the contents of the shared mailbox.
 +
:::* Can Send Message
 +
:::* Can Add File Attachment
 +
::[[File:Email_rights.png|700px|right|thumb|<div align="center">'''Check the desired rights and save. The image shows a suggested set of Mailbox rights'''</div>]]
 +
Once you're happy with your chosen rights, click "Save" and proceed to [[Roles|'''Associate the Role to the Users''']] who will require access to this mailbox.
 +
-->
 +
[[Category: HDOC]]

Latest revision as of 22:45, 15 March 2024

This document can now be found at its new location in the Hornbill Document Library.

Shared Mailbox Roles