<a id="msui-manual"></a>

# MSUI manual

Managed Service User Interface (MSUI) is an add-on component to Halon.
It enables end-users or domain administrators to carry out email-related tasks such as changing settings, trace messages in real time, or look at statistics.
It’s ideal for organisations that doesn’t have their own customer portal.

<a id="overview"></a>

## Overview

MSUI allows for extensive customization, including configurable settings and permission levels. It also offers comprehensive branding capabilities with the option of adding custom company logos and color schemes.
Advanced customer requests can be implemented with ease thanks to the flexibility and powerful scripting.

<a id="provided-functionality"></a>

### Provided functionality

* Management of domains, based on access control lists
  : * Settings (fully customizable)
    * Statistics (fully customizable, such as traffic volumes and spam classification)
    * Monitoring, tracking and management of email history, queue and quarantine
* Management of users
  : * Settings (fully customizable)
    * Monitoring, tracking and management of email history, queue and quarantine
    * Optionally with external authentication sources such as LDAP
    * Optionally with 2-factor authentication
* Common settings
  : * DKIM key management
    * Block/allow lists
    * Rate limits
    * Spam settings
    * File type and document fingerprint settings
* Audit log for tracking changes
* Delegation of specific permissions to users
* Language and translation support
* Branding; logotype, naming and color theme
* API for programmatically working with users and permissions

This manual references other resources as well, such as:

* [Script language reference](https://docs.halon.io/hsl/)
* [Knowledge base](https://docs.halon.io)

<a id="table-of-contents"></a>

## Table of contents

* [Installation](install.html.md)
  * [Requirements](install.html.md#requirements)
  * [Setup](install.html.md#setup)
    * [Ubuntu](install.html.md#ubuntu)
    * [RHEL](install.html.md#rhel)
    * [Initial setup](install.html.md#initial-setup)
  * [Upgrade](install.html.md#upgrade)
    * [Downgrade](install.html.md#downgrade)
* [Configuration](config.html.md)
  * [Minimal configuration](config.html.md#minimal-configuration)
    * [Listener configuration](config.html.md#listener-configuration)
    * [Database configuration](config.html.md#database-configuration)
    * [Basic authentication](config.html.md#basic-authentication)
  * [Authentication methods](config.html.md#authentication-methods)
    * [Local users and database example](config.html.md#local-users-and-database-example)
    * [Forwarded header example](config.html.md#forwarded-header-example)
    * [LDAP example](config.html.md#ldap-example)
  * [Additional settings](config.html.md#additional-settings)
    * [Server directives](config.html.md#server-directives)
    * [Database directives](config.html.md#database-directives)
    * [App directives](config.html.md#app-directives)
    * [Frontend directives](config.html.md#frontend-directives)
    * [Backend directives](config.html.md#backend-directives)
    * [Authentication directives](config.html.md#authentication-directives)
    * [User authentication directives](config.html.md#user-authentication-directives)
    * [Access token authentication directives](config.html.md#access-token-authentication-directives)
    * [LDAP authentication directives](config.html.md#ldap-authentication-directives)
    * [SMTP authentication directives](config.html.md#smtp-authentication-directives)
    * [Forwarded header authentication directives](config.html.md#forwarded-header-authentication-directives)
    * [Database password directives](config.html.md#database-password-directives)
    * [Session directives](config.html.md#session-directives)
    * [Rate limit directives](config.html.md#rate-limit-directives)
    * [Audit log directives](config.html.md#audit-log-directives)
    * [Elasticsearch directives](config.html.md#elasticsearch-directives)
    * [MTA directives](config.html.md#mta-directives)
    * [Digest report directives](config.html.md#digest-report-directives)
    * [FP/FN Report settings](config.html.md#fp-fn-report-settings)
* [History logging](history.html.md)
  * [Install Elasticsearch](history.html.md#install-elasticsearch)
  * [Import an index template](history.html.md#import-an-index-template)
    * [Delivery attempts](history.html.md#delivery-attempts)
    * [Transactions](history.html.md#transactions)
  * [Elasticsearch configuration](history.html.md#elasticsearch-configuration)
* [Configuration export](export.html.md)
  * [Configure MSUI](export.html.md#configure-msui)
  * [Configuration export directives](export.html.md#configuration-export-directives)
* [Web administration](administration.html.md)
  * [Creating new settings](administration.html.md#creating-new-settings)
  * [Digest reports](administration.html.md#digest-reports)
  * [Input validation](administration.html.md#input-validation)
  * [Branding](administration.html.md#branding)
* [Permissions](permissions.html.md)
  * [User roles](permissions.html.md#user-roles)
  * [Inheritance](permissions.html.md#inheritance)
  * [Global settings](permissions.html.md#global-settings)
  * [Two-factor authentication](permissions.html.md#two-factor-authentication)
* [Integration](integration.html.md)
  * [MSUI Client](integration.html.md#msui-client)
    * [Ubuntu](integration.html.md#ubuntu)
    * [RHEL](integration.html.md#rhel)
  * [Settings in MSUI](integration.html.md#settings-in-msui)
    * [msui-config.yaml](integration.html.md#msui-config-yaml)
* [API](api.html.md)

* [Changelog](changelog.html.md)
