Follow

Configure Email Manager (EMM) 365

This article will guide you through the setup of EMM 365

The Email Manager 365 architecture

The Email Manager 365 architecture

EMM 365 is built on the principles of EMM on-premise and replicates much of the same functions. The core components share the same code and the database structure is the same. EMM 365 contains the following components.

  1. Office 365 Exchange Online: The emails from the customers Exchange Online are archived in EMM 365 using the Exchange Online Journaling function.
  2. EMM 365 Smart Host: The EMM 365 Smart Host receives the journal envelopes from the Exchange Online Journaling service. The Smart Host is a SMTP receiver and is multi-tenant. The emals are temporary stored until the EMM 365 Sniffer processes them.
  3. EMM 365 Sniffer: The EMM 365 Sniffer processes the emails, extracts meta-data and stores it in the EMM 365 database. The Emails are stored in Azure Blob Storage.
  4. EMM 365 Database: The EMM 365 database is an Azure SQL Database and can either be hosted in WorkPoint's Azure tenant or in a tenant owned by the customer.
  5. EMM 365 Blob Storage: Emails are stored in the Azure Blob Storage which can be hosted in either WorkPoint's Azure tenant or in a tenant owned by the customer.
  6. WorkPoint Express: Use WorkPoint Express to journal emails, access emails stored in journals and search for them based on their meta-data. Everything which is possible with WorkPoint Express against EMM on-premise is possible with EMM 365
  7. EMM 365 Sync: EMM 365 Sync is used to synchronize entities, users and security between WorkPoint 365 and EMM 365.
  8. EMM 365 Web API: The EMM 365 Web API is used by WorkPoint Express and mobile clients to communicate with EMM 365.
  9. Mobile Clients: The currently only Mobile Client supporting EMM 365 is the Windows Phone, but IOS and Android will also be supporting this feature in the near future.

Configuring the Office 365 Send Connector

Configuring the Office 365 Send Connector
  1. Open the Exchange Admin Center located at: https://outlook.office365.com/ecp/.
  2. Log in with an tenant administrator account.
  3. In the Exchange Admin Center click on "mail flow".
  4. Choose the "connectors" pane.
  5. Click on the "+" icon to add a Send Connector.

Selecting the mail flow scenario

Selecting the mail flow scenario
  1. In the "From" field select "Office 365", then select "Partner organization" in the "To" field and click on "Next" to continue.

Naming the new connector

Naming the new connector
  1. Enter a name for the new connector.
  2. OPTIONAL Here you can enter a description of the new connector.
  3. Leave the default "Turn it on" checkbox checked.
  4. Click on "Next" to continue.

Adding the domain

Adding the domain
  1. Leave the default "Only when email messages are sent to these domains" option selected.
  2. Click on the "+" icon to add a domain.
  3. Enter "journal.YOURDOMAINHERE.COM" (If your domain name is adventurewind.com enter journal.adventurewind.com) then click on OK.
  4. Click on "Next" to continue.

Routing the email messages through the EMM Smart Host

Routing the email messages through the EMM Smart Host
  1. Select the "Route email through these smart hosts" option.
  2. Click on the "+" icon to add a smart host.
  3. Enter "emm365smtpreceiver.cloudapp.net" into the field and click on the "Save" button.
  4. Click on "Next" to continue.

Choosing the connection method to the EMM Smart Host

Choosing the connection method to the EMM Smart Host
  1. Remove the default "Always use Transport Layer Security (TLS) to secure the connection (recommended)" setting.
  2. Click on "Next" to continue.

Checking the configuration

Checking the configuration
  1. Validate the shown settings and click on "Next" to continue

Validating the configuration

Validating the configuration
  1. Click on the "+" icon to add an validation email address.
  2. Enter an email address which is outside of your domain and click on "OK" Note that this is only necessary to finish the "Configuring the Office 365 Send Connector" process and not for any validation purpose.
  3. Click on "Validate".

Saving the configuration

Saving the configuration
  1. Ignore this warnings and click on the "Save" button.

Creating the Office 365 journal rule

Creating the Office 365 journal rule
  1. In the "Exchange admin center" select "compliance management".
  2. Choose the "journal rules" pane.
  3. Click on "Select address"

Setting up the rollback address for undeliverable journal reports

Setting up the rollback address for undeliverable journal reports
  1. Click on "Browse" to search for email addresses.
  2. Choose the email address of your IT-Administrator or the one managing the Office 365 tenant
  3. Then click on "Save"

Creating the Office 365 journal rule

Creating the Office 365 journal rule
  1. Select the "compliance management" pane again.
  2. Then choose the "journal rules" pane.
  3. Click on the "+" icon to add a new journal rule.

Configuring the new journal rule

Configuring the new journal rule
  1. Enter the journaling email address. The syntax is "emmjournal@journal.YOURDOMAINHERE.COM" (If your domain name is adventurewind.com enter emmjournal@journal.adventurewind.com). Note that this email can not exist on the tenant before.
  2. Enter a name for the new journal rule.
  3. Choose "[Apply to all messages]".
  4. Choose "All messages" and click on "Save".

Giving consent for the EMM services

Giving consent for the EMM services
  1. Visit https://emm365webapi-dev.azurewebsites.net/ and click on the "Sign-Up !" button.
  2. Login with your tenant administrator account.

Accepting the consent

Accepting the consent

Click on "Accept" to give consent to the EMM365 API.

Collecting the required information for WorkPoint

Collecting the required information for WorkPoint
  1. Start PowerShell and enter the following command: "(Invoke-WebRequest https://login.windows.net/YOURDOMAINHERE.onmicrosoft.com/.well-known/openid-configuration|ConvertFrom-Json).token_endpoint.Split('/')[3]" like shown above.
  2. Now copy the returned value.

Sending the collected information to WorkPoint

Sending the collected information to WorkPoint

Send an email with the following information to support@workpoint.dk:

  1. Tenant ID (See Step 2. in the "Collecting the required information for WorkPoint" step.
  2. WorkPoint 365 Host Url (The Url to the Sitecollection on which you installed WorkPoint 365. If you are running a multi sitecollection environment enter the WorkPoint 365 root site collection URL.
  3. Exchange user (This can just be a random user on your tenant with an mailbox. This user will just be used to dissolve distribution groups to each recipient of an email. You can either use an existing user or you create a new user with an assigned mailbox.  Please note that  you shouldn't disable or delete the chosen user.
  4. Service Account for WorkPoint 365 (If there is no Service Account configured, please create one. Note that this user should be a site collection administrator of the WorkPoint365 site collection).
  5. Service Account Password (The password to the Service account defined in step 5).
  6. Journaling Email Address (The Journal email address defined in step 1 of the "Configuring the new journal rule" step.
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments