How to run your application
This topic describes the steps you need to complete to build and run your first Active Directory Rights Management Services SDK 2.1 rights-enabled application.
- AD RMS development environment setup. For more information, see How to set up your development environment.
- For an example application, see How to build your application.
Create and build a rights-enabled application. See the above Prerequisites section for options.
You must generate a manifest for your application before running it. This process is also known as signing your application. You can generate the manifest using either a production certificate chain or the pre-production certificate chain that is installed with the SDK. We recommend that you use the pre-production certificate chain during development. For more information about keys and certificate chains, see Understanding certificate chains. For information about how to sign an application with a production certificate chain, see How to release a rights-enabled application.
To generate the application manifest using the pre-production certificate chain, perform these steps on your development computer:
- Copy the following files from their installation directories to the same folder as your application.
- In your application folder, rename the manifest configuration file, YourAppName.isv.mcf, to the name of your application with the .mcf file name extension appended. For example if your application is named MyApp.exe, rename YourAppName.isv.mcf to MyApp.exe.mcf.
- Use a text editor to add your application to the manifest configuration file. To do this, replace the <YourAppName>.exe place holder text in the module list inside your .mcf file with the name of your application; for example, MyApp.exe.
The signing process will generate an error if the .mcf file is used without modification.
- Run Genmanifest.exe to generate the application manifest. This is also known as signing your application. The output of this operation should be a .man file. For example, if your application is named MyApp.exe and your manifest configuration file is named MyApp.exe.mcf, run the following command:
genmanifest.exe -chain isvtier5appsignsdk_client.xml MyApp.exe.mcf MyApp.exe.man
You can run your application from any directory, but the application manifest (MyApp.exe.man) must be in the same directory as the executable (MyApp.exe).
If you are using the AD RMS 1-box environment to test your application, copy your application executable and the application manifest to any directory on the 1-box environment and then run your application. For information about the AD RMS 1-box environment, see How to set up your development environment.
If you are testing your application against an RMS server that is configured for pre-production, make sure that you have configured the Active Directory Rights Management Services Client 2.1 on the computer where the application will be running; for example, on your development computer. Then make sure that both the application executable and the application manifest are located in the same directory on that computer and run your application.
For information about how to configure the client on your computer, see How to configure the AD RMS Client 2.1. For information about installing an RMS server, see How to install and configure an RMS Server.
- Understanding certificate chains
- How to set up your development environment
- How to release a rights-enabled application
- How to install and configure an RMS Server
- How to configure the AD RMS Client 2.1
Build date: 9/27/2013