Topics on this page
Azure Active Directory (AD) setup guide
Download the metadata XML for Trend Micro Cloud One
- Log into Trend Micro Cloud One with Full Access to the Identity and Account permissions.
- Click Administration near the bottom of the page.
- Click the Identity Providers tab on the left.
- Click the Download Metadata XML for Trend Micro Cloud One link, or right-click the link, and select an option to save the file.
This XML file will be uploaded to Azure in order to configure SAML. You will use a different XML file to upload into Cloud One later.
Configuring SAML in Azure AD
Refer to Azure's Documentation for further details on the steps below.
Create your Azure application
- Login to Azure. Ensure you select the directory that you wish to setup SAML.
- Navigate to Azure Active Directory and select Enterprise Applications.
- Click New Application then select Create your own application (if it is disabled--that is, grayed out--then ensure you have admin access to your subscription).
- Provide a name for your app and select non-gallery (below), then click Create.
- Click Single sign-on in the left nav bar and select SAML for the single sign-on method.
Assign users and groups
- Click Users and groups on the left, then click Add user/group. Select the user or group you wish to assign to your application.
- If you select individual users, ensure that they are part of a group and take note of any Group ID, as we will use it later. If you select a group then take note of the Object ID for later use.
Basic SAML configuration
- Click Single sign-on on the left, then click Upload metadata file and select the Cloud One metadata file.
- Verify that the Identifier (Entity ID) and Reply URL (Assertion Consumer Service URL) have been filled out. Note that the Reply URL will contain the path
/idpresponse. In addition, to have the user's sign-in open Workload Security automatically, in the Relay State field, type
- Click Save on the right hand side.
Set console theme
Specifying a theme query parameter is optional, and it allows customers to specify a particular theme in the relayState they get from the Identity Provider SAML response. The valid theme values are "light" and "dark". If "dark" is chosen, then the Trend Micro Cloud One console will open in the dark mode. If no theme parameter is specified, the browser will default to light mode, or whatever is saved within a customer's local browser setting.
To specify the theme, the relayState in the SAML response should include "theme" as a query parameter with a value of either "dark" or "light".
/theme=darkfor dark theme.
/theme=lightfor light theme.
Attributes and Claims
- Click Edit to set up the Attributes and Claims.
- Leave the Name ID required claim set to default.
- Click Add a group claim. Here you can add the groups of those you wish to access Cloud One. Select the best option that reflects the group you previously assigned to your application. For more information please reference Azure's documentation.
- Leave the source attribute set to Group ID then click Save. Take note of the claim name, for example:
- Back in Attributes and Claims, click Add new claim, enter the name
localeand for Source attribute select
user.preferredlanguagethen click Save
See the attributes claims guide for more information.
Configure SAML in Cloud One
- From the Cloud One Identity Providers page, click New.
- From the Identity Provider dialog box, in the Alias field, type any name, but we recommend that the name include the identity provider, such as Azure AD or Okta.
- In the Metadata XML File box, click the Browse button, then navigate to the metadata file that you downloaded from the identity provider (not Cloud One).
- For the Mapping section (see explanation in About SAML single sign-on) provide a role and attribute as detailed in the next steps.
- Set Role attribute to:
http://schemas.microsoft.com/ws/2008/06/identity/claims/groups(This is the claim name from the group claim.)
- Set Group to the Group ID or Object ID of the group you assigned earlier then map it to a Cloud One role.
- Set the Name attribute to
- Set the Locale attribute to
- Leave Timezone attribute empty as there is no claim for timezone.
- Click Save.
In the Mapping section, click + to add more than one Group. You can configure multiple groups to have different access privileges.
Test SAML SSO
- From Azure, inside Single sign-on click Test on the bottom to test logging in as the current user.
- To test the normal workflow, navigate to My Apps for Microsoft and select your SAML application to log in to Cloud One.
If you are having difficulties, please reference our troubleshooting SAML guide for assistance.