# Implementation ITSM-35 - Helpdesk: mail server administration

Project: Stream IT service management (ITSM)
Status: closed
URL: https://community.openproject.org/work_packages/ITSM-35

## OPEN POINTS

_No work packages_

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Designer |  |
| Developers | Eric Schubert |

## Technical details

| Attribute | Value |
| --- | --- |
| Target versions | 18.1.0 |
| Module |  |
| Requires doc change | No |

## Belongs to

_No work packages_

## Previous chunks

_No work packages_

## Next chunks

_No work packages_

## Estimates

| Attribute | Value |
| --- | --- |
| Effort (shirt size) |  |
| Work |  |

## Details

| Attribute | Value |
| --- | --- |
| Date |  |
| % Complete | 100% |
| Category |  |
| Priority | Medium |
| List |  |
| Pull preview |  |

## Description

As an instance administrator

I want to set up the mail server for incoming and outgoing email in the administration

so that project administrators can connect their project's helpdesk mailbox to it without knowing the server details.

### **Acceptance criteria**

*   Administration → Helpdesk has a "Mail server" page.
    
*   Without a mail server, the page explains what it's for and has a "Set up mail server" button.
    
*   The form has three parts, saved together:
    
    *   Name
        
    *   Incoming email (IMAP): server name, port, encryption (TLS / STARTTLS)
        
    *   Outgoing email (SMTP): server name, port, encryption (TLS / STARTTLS)
        
*   Choosing an encryption fills in the usual port, unless the administrator changed the port:
    
    *   IMAP: 993 for TLS, 143 for STARTTLS
        
    *   SMTP: 465 for TLS, 587 for STARTTLS
        
*   The form doesn't ask for usernames or passwords. Those are entered per project mailbox (SISMI-31).
    
*   Invalid input is shown next to the field, e.g. an IP address or URL as server name, or a port outside 1–65535.
    
*   The overview shows both connections and how many project mailboxes use the server.
    
*   The administrator can edit the mail server.
    
*   The administrator can delete the mail server only while no mailbox uses it. Otherwise the error says how many mailboxes use it.
    
*   There is one mail server in 18.0.
    

### **Technical notes**

*   Contracts and services for create, update and delete, following storages and XWiki
    
*   Primer forms and Turbo
    
*   Feature specs for create, edit and delete, plus contract and service specs
    

### **Permissions and visibility considerations**

*   To whom is this feature visible?
    
    *   Instance administrators, while the feature flag is on
        
*   When is it not visible?
    
    *   With the feature flag off: no menu entry, and the pages return 404.
        
    *   For non-administrators: no menu entry, and the pages return 403.
        

###   

### **Out of scope**

*   Health check (work package 3)
    
*   Testing a mailbox's login and sending a test email (SISMI-31)
    
*   More than one mail server
    
*   OAuth (not in 18.0)