Azure Information Protection unified labeling client administrator guide

Applies to: Active Directory Rights Management Services, Azure Information Protection, Windows 10, Windows 8.1, Windows 8, Windows 7 with SP1, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2

Instructions for: Azure Information Protection unified labeling client for Windows

Use the information in this guide if you are responsible for the Azure Information Protection unified labeling client on an enterprise network, or if you want more technical information than is in the Azure Information Protection unified labeling client user guide.

For example:

  • Understand the different components of this client and whether you should install it

  • How to install the client for users, with information about prerequisites, installation options and parameters, and verification checks

  • Locate the client files and usage logs

  • Identify the file types supported by the client

  • Use the client with PowerShell for command-line control

Have a question that's not addressed by this documentation? Visit our Azure Information Protection Yammer site.

Technical overview of the Azure Information Protection unified labeling client

The Azure Information Protection unified labeling client includes the following:

  • An Office add-in, that installs a Sensitivity button on the ribbon for users to select sensitivity labels, and an option to display the Azure Information Protection bar for better label visibility.

  • Windows File Explorer, right-click options for users to apply classification labels and protection to files.

  • A viewer to display protected files when a native application cannot open it.

  • A PowerShell module to apply and remove classification labels and protection from files.

  • The Rights Management client that communicates with the Azure Rights Management (Azure RMS) service to encrypt and protect files.

With the exception of the viewer, the Azure Information Protection unified labeling client cannot be used with applications and services that communicate directly with the Azure Rights Management service or Active Directory Rights Management Services.

If you have AD RMS and want to migrate to Azure Information Protection, see Migrating from AD RMS to Azure Information Protection.

Should you deploy the Azure Information Protection unified labeling client?

Deploy the Azure Information Protection unified labeling client if you are using sensitivity labels in the Office 365 Security & Compliance Center, and any of the following applies:

  • You want to classify (and optionally, protect) documents and email messages by selecting labels from within your Office apps (Word, Excel, PowerPoint, Outlook) on Windows computers.

  • You want to classify (and optionally, protect) files by using File Explorer, supporting additional file types than those supported by Office, multi-select, and folders.

  • You want to run scripts that classify (and optionally, protect) documents by using PowerShell commands.

  • You want to view protected documents when a native application to display the file is not installed or cannot open these documents.

Example showing the Office add-in for the Azure Information Protection unified labeling client, displaying the new Sensitivity button on the ribbon and the optional Azure Information Protection bar:

Azure Information Protection bar with default policy

Installing and supporting the Azure Information Protection unified labeling client

You can install the Azure Information Protection unified labeling client by using an executable or a Windows installer file. For more information about each choice, and instructions, see Install the Azure Information Protection unified labeling client for users.

Use the following sections for supporting information about installing the client.

Installation checks and troubleshooting

When the client is installed, use the Help and Feedback option to open the Microsoft Azure Information Protection dialog box:

  • From an Office application: On the Home tab, in the Sensitivity group, select Sensitivity, and then select Help and Feedback.

  • From File Explorer: Right-select a file, files, or folder, select Classify and protect, and then select Help and Feedback.

Help and Feedback section

The Tell me more link by default, goes to the Azure Information Protection website. You can configure your own URL link that goes to a custom help page as one of the policy settings in the Office 365 Security & Compliance Center.

The Export Logs automatically collects and attaches log files for the Azure Information Protection unified labeling client if you have been asked to send these to Microsoft Support. This option can also be used by end users to send these log files to your help desk.

The Reset Settings signs out the user, deletes the currently downloaded sensitivity labels and policies, and resets the user settings for the Azure Rights Management service.

More information about the Reset Settings option
  • You do not have to be a local administrator to use this option and this action is not logged in the Event Viewer.

  • Unless files are locked, this action deletes all the files in the following locations. These files include client certificates, Rights Management templates, sensitivity labels and policies from the Office 365 Security & Compliance Center, and the cached user credentials. The client log files are not deleted.

    • %LocalAppData%\Microsoft\DRM

    • %LocalAppData%\Microsoft\MSIPC

    • %LocalAppData%\Microsoft\MSIP\Policy.msip

    • %LocalAppData%\Microsoft\MSIP\TokenCache

  • The following registry keys and settings are deleted. If the settings for any of these registry keys have custom values, these must be reconfigured after you reset the client.

    Typically for enterprise networks, these settings are configured by using group policy, in which case they are automatically reapplied when group policy is refreshed on the computer. However, there might be some settings that are configured one time with a script, or manually configured. In these cases, you must take additional steps to reconfigure these settings. As an example, computers might run a script one time to configure settings for redirection to Azure Information Protection because you are migrating from AD RMS and still have a Service Connection Point on your network. After resetting the client, the computer must run this script again.

    • HKEY_CURRENT-USER\SOFTWARE\Microsoft\Office\15.0\Common\Identity

    • HKEY_CURRENT-USER\SOFTWARE\Microsoft\Office\14.0\Common\DRM

    • HKEY_CURRENT-USER\SOFTWARE\Microsoft\Office\15.0\Common\DRM

    • HKEY_CURRENT-USER\SOFTWARE\Microsoft\Office\16.0\Common\DRM

    • HKEY_CURRENT-USER\SOFTWARE\Classes\Local Settings\Software\Microsoft\MSIPC

  • The currently signed in user is signed out.

Client status section

Use the Connected as value to confirm that the displayed user name identifies the account to be used for Azure Information Protection authentication. This user name must match an account used for Office 365 or Azure Active Directory. The account must also belong to an Office 365 tenant that is configured for sensitivity labels in the Office 365 Security & Compliance Center.

If you need to sign in as a different user to the one displayed, see the Sign in as a different user instructions.

Use the Version information to confirm which version of the client is installed. You can check whether this is the latest release version and the corresponding fixes and new features by reading the Version release information for the client.

Support for multiple languages

The Azure Information Protection unified labeling client supports the same languages that Office 365 supports. For a list of these languages, see the Office 365, Exchange Online Protection, and Power BI section from the International availability page from Office.

For these languages, menu options, dialog boxes, and messages from the Azure Information Protection unified labeling client display in the user's language. There is a single installer that detects the language, so no additional configuration is required to install the Azure Information Protection unified labeling client for different languages.

However, the Azure Information Protection unified labeling client does not currently support different languages for the labels. In addition, visual markings are not translated and do not support more than one language.

Post installation tasks

After you have installed the Azure Information Protection unified labeling client, make sure that you give users instructions for how to label their documents and emails, and guidance for which labels to choose for specific scenarios. For example:

Upgrading and maintaining the Azure Information Protection unified labeling client

Note

The Azure Information Protection unified labeling client supports upgrading the Azure Information Protection client, as well as upgrading from previous versions of the Azure Information Protection unified labeling client.

The Azure Information Protection team regularly updates the Azure Information Protection unified labeling client for new functionality and fixes. Announcements are posted to the team's Yammer site.

If you are using Windows Update, the Azure Information Protection unified labeling client automatically upgrades the general availability version of this client, irrespective of how the client was installed. New client releases are published to the catalog a few weeks after the release.

Alternatively, you can manually upgrade the client by downloading the new release from the Microsoft Download Center. Then install the new version to upgrade the client. You must use this method to upgrade preview versions and if you are upgrading from the Azure Information Protection client.

If you are upgrading from the Azure Information Protection client on Windows 7, any Office applications will automatically restart during the client upgrade. This automatic restart does not apply to later operating systems, or if you are upgrading from an older version of the unified labeling client.

When you manually upgrade, uninstall the previous version first only if you're changing the installation method. For example, you change from the executable (.exe) version of the client to the Windows installer (.msi) version of the client. Or, if you need to install a previous version of the client. For example, you have the current preview version installed for testing and now need to revert to the current general availability version.

Use the Version release history and support policy to understand the support policy for the Azure Information Protection unified labeling client, which versions are currently supported, and what's new and changed for the supported releases.

Uninstalling the Azure Information Protection unified labeling client

You can use any of the following options to uninstall the client:

  • Use Control Panel to uninstall a program: Click Microsoft Azure Information Protection > Uninstall

  • Rerun the executable (for example, AzInfoProtection_UL.exe), and from the Modify Setup page, click Uninstall.

  • Run the executable with /uninstall. For example: AzInfoProtection.exe /uninstall

Next steps

To install the client, see Install the Azure Information Protection unified labeling client for users.

If you've already installed the client, see the following for additional information that you might need to support this client: