In an earlier post I wrote how you can setup and enable Office 365 message encryption.

In this post I will explain how you can apply custom branding to customize the Office 365 Message encryption email messages and the look of the message viewing portal using PowerShell cmdlets.

You can customize the following items of the Office 365 Message Encryption email and viewing portal:

Introductory text of the email that contains the encrypted message

Disclaimer text of the email that contains the encrypted message

Portal text that will appear in the message viewing portal.

Logo that will appear in the email message and on the viewing portal.

I have highlighted the areas that you can customize in the below screenshots. You can however only insert plain text (i.e. no html code for url links but some mail client will detect URL’s and make them clickable).

The parts that are not highlighted you cannot change the text but you can influence the language used in the outgoing e-mail message which I will explain further down this post.

screenshot 1 – This first screenshot shows the mail message the recipient receives in his or her mailbox.



screenshot 2 – This second screenshot shows the content of the HTML attachment.



Steps to customize

1. Connect to Exchange online using Remote PowerShell

Set-ExecutionPolicy RemoteSigned $cred = Get-Credential $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/powershell-liveid/ -Credential $cred -Authentication Basic –AllowRedirection Import-PSSession $Session 1 2 3 4 5 6 7 8 9 Set-ExecutionPolicy RemoteSigned $cred = Get-Credential $Session = New-PSSession -ConfigurationName Microsoft . Exchange -ConnectionUri https : / / outlook . office365 . com / powershell -liveid / -Credential $cred -Authentication Basic – AllowRedirection Import-PSSession $Session

2. Use the Set-OMEConfiguration cmdlet to customize the message and / or viewing portal. In the table below I have outlined how to customize the area’s

Feature Windows PowerShell command Default text that accompanies encrypted email messages (screenshot 1 – text block 1) Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -EmailText “<string of up to 1024 characters>” Example: Set-OMEConfiguration -Identity “OME Configuration” -EmailText “Display your custom message for the recipient here.” Disclaimer statement in the email that contains the encrypted message

(screenshot 1 – text block 2) Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -DisclaimerText “<disclaimer statement, string of up to 1024 characters>” Example: Set-OMEConfiguration -Identity “OME Configuration” -DisclaimerText “Possibility to enter your own disclaimer at the bottom………” Logo

(screenshot 1 & 3 – block 3) Set-OMEConfiguration -Identity ” <OMEConfigurationIdParameter> -Image <Byte[]> Example: Set-OMEConfiguration -Identity “OME configuration” -Image (Get-Content “D:\image\yourlogo.png” -Encoding byte)

Supported file formats: .png, .jpg, .bmp, or .tiff

Optimal size of logo file: less than 40 KB

Optimal size of logo image: 170×70 pixels Text at the top of the encrypted mail viewing portal.

(screenshot 2 – text block 4) Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -PortalText “<portal header, string of up to 128 characters>” Example: Set-OMEConfiguration -Identity “OME Configuration” -PortalText “your company secure e-mail portal”

Non-editable text area’s

e-mail message

In screenshot 1 you can see a text block which is not highlighted and starts with the heading: “to view your message”. You cannot change the content or directly influence the language of this part. The language of this text block is based upon the language setting of the senders mailbox.

This is something to keep in mind especially in organisations operating Internationally.

for example: if one of your users has chosen to set the mailbox language to Italian and then sent an encrypted message to a person in Finland, the recipient in Finland will see that part of the message in the Italian language.

That means you either need to educate the users about the impact of changing the mailbox language or add custom text into text block 1 explaining the recipient what to do.

HTML Attachment

The language displayed when opening the HTML Attachment (screenshot 2) is based upon the language setting of the senders mailbox. This is obviously a real downside of this product especially if the language setting of your users mailbox isn’t English.

Viewing portal

The language used in the viewing portal is based upon the language setting in the browser of the recipient opening the message. This in theory should automatically be the preferred language of the recipient.

Tip:

Create a web page on which you explain to the recipient that you use secure mail and how he/she can use this. Perhaps add a short manual for the recipient.

And add a link to this page in either the first text block or the disclaimer text.

Steps to remove the custom branding

1. Connect to Exchange online using Remote PowerShell

Set-ExecutionPolicy RemoteSigned $cred = Get-Credential $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/powershell-liveid/ -Credential $cred -Authentication Basic –AllowRedirection Import-PSSession $Session 1 2 3 4 5 6 7 8 9 Set-ExecutionPolicy RemoteSigned $cred = Get-Credential $Session = New-PSSession -ConfigurationName Microsoft . Exchange -ConnectionUri https : / / outlook . office365 . com / powershell -liveid / -Credential $cred -Authentication Basic – AllowRedirection Import-PSSession $Session

2. Use the Set-OMEConfiguration cmdlet to remove the custom branding. In the table below I have outlined how to customize the area’s

Feature Windows PowerShell command Default text that accompanies encrypted email messages (screenshot 1 – text block 1) Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -EmailText “<empty string>” Example: Set-OMEConfiguration -Identity “OME Configuration” -EmailText “” Disclaimer statement in the email that contains the encrypted message

(screenshot 1 – text block 2) Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -DisclaimerText “<empty string>” Example: Set-OMEConfiguration -Identity “OME Configuration” -DisclaimerText “” Logo

(screenshot 1 & 3 – block 3) Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -Image <“$null”> Example: Set-OMEConfiguration -Identity “OME configuration” -Image $null

Supported file formats: .png, .jpg, .bmp, or .tiff

Optimal size of logo file: less than 40 KB

Optimal size of logo image: 170×70 pixels Text at the top of the encrypted mail viewing portal.

(screenshot 2 – text block 4) Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -PortalText “<empty string>” Example: Set-OMEConfiguration -Identity “OME Configuration” -PortalText “”

I hope this was informative. For questions or comments you can always give a reaction in the comment section or contact me.









Related

I hope this was informative. For questions or comments you can always give a reaction in the comment section or contact me: