This article applies to:
- Trustwave MailMarshal Cloud
- Azure Information Protection Rights Management
Question:
- What setup is required for Azure Information Protection (AIP) with MailMarshal Cloud?
- How do I get the AIP credentials and settings that I need to enter in MailMarshal Cloud?
Procedure:
To set up AIP in MailMarshal Cloud, you will need a Microsoft Azure account configured with AIP. This article assumes you have such an account.
Prerequisites
MailMarshal Cloud Licensing
This functionality is licensed separately. Your MailMarshal Cloud account must have Azure Information Protection enabled.
Information Needed
- NOTE: To use the PowerShell commands described, you must use a minimum version of PowerShell and you must install certain modules. For details, see the Microsoft document Installing the AADRM PowerShell Module.
You will need to obtain the following information:
- BposTenantId: Azure Tenant Id
- AppPrincipalId: Azure user to use in MailMarshal with super-user rights
- Base64Key: Symmetric key for AppPrincipalId
- LicensingExtranetUrl: URL for retrieving use license, templates, and other items
- LicensingIntranetUrl: URL for retrieving use license, templates, and other items from Intranet locations.
- Typically the same as LicensingExtranetUrl
Getting the Tenant ID and Licensing Url
- As an administrator, run PowerShell with the appropriate modules installed (see note above)
- Import the RMS module: Import-Module AADRM
- Connect to the service, using Microsoft credentials that have appropriate permissions: Connect-AadrmService –Verbose
- Ensure RMS is enabled: Enable-AADRM
- Get your tenant ID by running: Get-AadrmConfiguration
Creating a Service Principal
A service principal is credentials configured globally for access control that allow a service to authenticate with Microsoft Azure AD and to protect information using Microsoft Azure AD Rights Management.
If you do not already have a service principal that you can use for MailMarshal Cloud, follow the following steps:
- As an administrator, run PowerShell with the appropriate modules installed (see note above)
- Import the Microsoft Azure AD module using: Import-Module MSOnline
- Connect to your online service with the assigned user credentials: Connect-MsolService
- Create a new service principal by running: New-MsolServicePrincipal
- Provide a name for the Service Principal
- Record the results (symmetric key and AppPrincipalID)
Enabling the Super User feature
MailMarshal Cloud requires the super user feature to be able to decrypt all messages for the domain. To enable this for the created principal, follow the following steps:
- As an administrator, run PowerShell with the appropriate modules installed (see note above)
- Import the RMS module: Import-Module AADRM
- Connect to the service with the assigned user credentials: Connect-AadrmService –Verbose
- Enable the Aadrm super user feature: Enable-AadrmSuperUserFeature
- Add the Service Principal as a super user to Rights Management: Add-AadrmSuperUser -ServicePrincipalId <AppPrincipalId>
Entering the Information in MailMarshal Cloud
To enter the AIP settings and credentials, open the MailMarshal Cloud Console and navigate to System Configuration > Azure Information Protection. For further instructions, see Help for that page.
Trustwave MailMarshal Cloud KB article Q21121
Last Modified: February 9, 2025