EditIssuanceLicense method

Article
05/31/2018

[The AD RMS SDK leveraging functionality exposed by the client in Msdrm.dll is available for use in Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012, and Windows 8. It may be altered or unavailable in subsequent versions. Instead, use Active Directory Rights Management Services SDK 2.1, which leverages functionality exposed by the client in Msipc.dll.]

The EditIssuanceLicense SOAP web method creates a new signed issuance license. This method accomplishes this by performing the following steps:

Put the content key from the supplied signed issuance license into the new issuance license.
Sign the new issuance license.
Return the new, signed issuance license.

[!Important]
When you use this method to enable license republishing, keep in mind that the content key for the file does not change. An implication of this is that it may be possible for users who have been added to the license to continue to access the content, even after they have been subsequently removed from the license.

[!Important]
The EditIssuanceLicense method on AD RMS has its access control list (ACL) set to "System" by default. To use this method, you must change the ACL for EditIssuanceLicense.asmx to a value that will allow this function to be used. It is very important to understand that only approved computers or (occasionally) users should have access to this function because anyone with access to this function can gain full rights to any license with the "Allow_Server_Editing"/"True" pair issued by this service.

Note

This SOAP web method is documented as if it were used in a .NET Framework XML web service client. For more information about creating an XML web service client, see Building XML Web Service Clients and Accessing XML Web Services in Managed Code.

Syntax

public EditIssuanceLicenseResponse[] EditIssuanceLicense(
  EditIssuanceLicenseParams[] RequestParams
);

VB
`Public Function EditIssuanceLicense( _ ByVal RequestParams() As EditIssuanceLicenseParams _ ) As EditIssuanceLicenseResponse()`

Parameters

RequestParams: An array of EditIssuanceLicenseParams objects that contains the signed issuance license and the new issuance license with the new rights to incorporate.

Note

Servers will only accept requests that consist of arrays that contain a single element. All other requests will fail.

Return value

An array of EditIssuanceLicenseResponse objects that contains the new signed issuance license chain. The new issuance license contains the content key from the old issuance license.

Web Service URL

ServerURL/_wmcs/Licensing/EditIssuanceLicense.asmx

Remarks

The VersionDataValue and Credentials properties of the SOAP proxy object must be set before calling this method.

For this request to succeed, a requesting party must be on a list of allowed editors created by the AD RMS administrator, the license to republish must be a valid signed issuance license from this deployment, and the issuance license must include the application-specific tag "Allow_Server_Editing", with the (string) value "True". This value is added during issuance license creation by using the DRMSetApplicationSpecificData method.

This function validates the received signed issuance license before processing any further.

Requirements


Product	Rights Management Services 1.0 SP2 or later