Set up the test environment

Your rights-enabled application can be tested with different server options.

Important  It is a recommended best practice to test your Rights Management Services SDK 2.1 application first with the AD RMS pre-production environment against an AD RMS Server. Then, should you want your customer to have the ability to use your application with the Azure RMS Service, move to testing with that environment. For more information see, Enable your service application to work with cloud based RMS.

 

Prerequisites

Instructions

Step 1: Set up your test environment

To test your rights-enabled application, you must run it against an RMS server that is configured for pre-production. A pre-production RMS server uses the pre-production/ISV certificate hierarchy to encrypt and decrypt files.

For more information about the AD RMS certificate hierarchy, see Understanding certificate chains.

There are two options available for testing your application against an RMS server:

  • You can run your application on the 1-box AD RMS ISV environment. If you are running Windows Server 2012, Windows Server 2008 R2, or Windows Server 2008 and have Hyper-V installed, you can deploy the 1-box AD RMS ISV environment by building a virtual machine using the AD RMS 1-box VHD. The 1-box AD RMS ISV environment provides an RMS server configured for pre-production and also has the Active Directory Rights Management Services Client 2.1 installed. Registry settings for the RMS server and client are already configured. To test your application, you run it on the virtual machine on which the 1-box environment is deployed.
  • You can run your application against an RMS server that is configured for pre-production and that is deployed on your network. In this case, you must also install and configure the AD RMS Client 2.1 on the computer where your application will be running. For information about how to do this, see Configure client. For information about how to deploy an RMS server and configure it for pre-production, see Install and configure the server.

How-to use

AD RMS SDK Webinar collateral download page

Configure client

Install the SDK

Install and configure the server

Understanding certificate chains