Difference between revisions of "Mailbox Rights and Roles"

From Hornbill
Jump to navigation Jump to search
 
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
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.  
  
By default you will have a temporary mailbox set up as part of your instance. You will have received an email with details of this when your new instance was set up.
+
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.
  
== Using the Pre-configured Mailbox ==
+
|style="width:5%"|
 +
|
 +
|style="width:22%; border-style: solid; border-width: 1px; border-color:#e6e6e6; background-color:#f2f2f2;"|
  
Your new Hornbill instance is equipped with a pre-configured mailbox which will allow you to get up and running more quickly. To make use of this you must complete the following steps :-
+
== Related Articles ==
 +
:* [[Email_Administration|Email Administration]]
 +
:* [[Shared_Mailboxes|Configuring Shared Mailboxes]]
 +
:* [[Mailboxes|Working With Shared Mailboxes]]
 +
|}
  
:# '''Create a Mailbox Role''' - Go to [[Administration|Hornbill Administration]], and then ''Users and Groups'' then ''Roles''. Click 'Create New Role', select "Security Role", and populate the fields as follows:-
+
== Creating a Shared Mailbox Role ==
:::* Role ID: Mailbox – Helpdesk
+
::[[File:New_Mailbox_Role.PNG|700px|right|thumb|<div align="center">'''Create a new Security Role'''</div>]]
:::* Privilege Level: User
+
=== Create a New Security Role ===
:::* Application: Hornbill Service Manager
+
Navigate to '''''Home > System > Organisational Data > Roles''''' in Hornbill Administration
:::* Description: Role to manage Mailbox Access
 
:::* Applications: Hornbill Service Manager
 
:::* Groups: Leave Blank
 
:::* Shared Mailboxes: helpdesk
 
:::* Click 'create role'
 
:::* Click the “Shared Mailbox rights” Tab
 
:::* Then set the following rights...
 
::[[File:Email_rights.png| 700px|email rights]]
 
:::* 'Save changes'  
 
::2.  [[How_do_I_assign_or_remove_roles_from_Co-Workers? |'''Associate the Role to a User''']] who will require access to this mailbox
 
  
 +
: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
  
== Integrate with your own Email ==  
+
:At this stage the "Applications" and "Shared Mailboxes" fields aren't active so simply click 'Create Role'
 
+
<br>
Hornbill includes some powerful email integration capabilities. This is performed in Hornbill Administration in the context of Instance Configuration under the "Email" menu item.
+
<br>
 +
=== Associate a Shared Mailbox to the New Role ===
 +
::[[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'
 +
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
 +
:::* Then set the desired rights
  
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]]
+
:::* Can Get message
 +
:::* Can Flag Message
 +
:::* Can Delete Message
 +
:::* Can Add File Attachment
 +
:::* Can send message
 +
:::* Can Edit Message
 +
:::* Can Search Message
  
[[Category: Email]]
+
==== 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