Protéger des documents à lʼaide de politiques protecting-documents-with-policies

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-rightsmanagement-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créez un objet API client Document Security.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet DocumentSecurityClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Définissez les attributs de la politique.

• Créez un objet Policy en appelant la méthode statique createPolicy de l’objet InfomodelObjectFactory. Cette méthode renvoie un objet Policy.
• Définissez l’attribut du nom de la politique en appelant la méthode setName de l’objet Policy et en transmettant une valeur de chaîne qui spécifie le nom de la politique.
• Définissez la description de la politique en appelant la méthode setDescription de l’objet Policy et en transmettant une valeur de chaîne qui spécifie la description de la politique.
• Définissez le jeu de politiques auquel appartient la nouvelle politique en appelant la méthode setPolicySetName de l’objet Policy et en transmettant une valeur de chaîne qui spécifie le nom du jeu de politiques. (Vous pouvez spécifier null pour cette valeur de paramètre qui entraîne l’ajout de la politique au jeu de politiques Mes politiques.)
• Créez la période de validité de la politique en appelant la méthode statique createValidityPeriod de l’objet InfomodelObjectFactory. Cette méthode renvoie un objet ValidityPeriod.
• Définissez le nombre de jours pendant lesquels un document protégé par une politique est accessible en appelant la méthode setRelativeExpirationDays de l’objet ValidityPeriod et en transmettant une valeur entière qui spécifie le nombre de jours.
• Définissez la période de validité de la politique en appelant la méthode setValidityPeriod de l’objet Policy et en transmettant l’objet ValidityPeriod.

Créez une entrée de politique.

• Créez une entrée de politique en appelant la méthode statique createPolicyEntry de l’objet InfomodelObjectFactory. Cette méthode renvoie un objet PolicyEntry.
• Spécifiez les autorisations de la politique en appelant la méthode statique createPermission de l’objet InfomodelObjectFactory. Transmettez un membre de données statique qui appartient à l’interface Permission qui représente l’autorisation. Cette méthode renvoie un objet Permission. Par exemple, pour ajouter l’autorisation qui permet aux utilisateurs de copier des données d’un document PDF protégé par une politique, transmettez Permission.COPY. (Répétez cette étape pour chaque autorisation à ajouter).
• Ajoutez l’autorisation à l’entrée de politique en appelant la méthode addPermission de l’objet PolicyEntry et en transmettant l’objet Permission. (Répétez cette étape pour chaque objet Permission que vous avez créé).
• Créez le principal de politique en appelant la méthode statique createSpecialPrincipal de l’objet InfomodelObjectFactory. Transmettez un membre de données qui appartient à l’objet InfomodelObjectFactory qui représente le principal. Cette méthode renvoie un objet Principal. Par exemple, pour ajouter l’éditeur du document en tant qu’entité principale, transmettez InfomodelObjectFactory.PUBLISHER_PRINCIPAL.
• Ajoutez le principal à l’entrée de politique en appelant la méthode setPrincipal de l’objet PolicyEntry et en transmettant l’objet Principal.
• Ajoutez l’entrée de politique à la politique en appelant la méthode addPolicyEntry de l’objet Policy et en transmettant l’objet PolicyEntry.

Enregistrez la politique.

• Créez un objet PolicyManager en appelant la méthode getPolicyManager de l’objet DocumentSecurityClient.

• Enregistrez la politique en appelant la méthode registerPolicy de l’objet PolicyManager et en transmettant les valeurs suivantes :

  • Objet Policy représentant la politique à enregistrer.

• Valeur de chaîne représentant le jeu de politiques auquel appartient la politique.

Si vous utilisez un compte d’administrateur d’AEM Forms dans les paramètres de connexion pour créer l’objet DocumentSecurityClient, alors spécifiez le nom du jeu de politiques lorsque vous appelez la méthode registerPolicy. Si vous transmettez une valeur null pour le jeu de politiques, la politique est créée dans le jeu de politiques Mes politiques au niveau administrateur.

Si vous utilisez un utilisateur Document Security dans les paramètres de connexion, vous pouvez appeler la méthode registerPolicy surchargée qui accepte uniquement la politique. En d’autres termes, vous n’avez pas besoin de spécifier le nom du jeu de politiques. Cependant, la politique est ajoutée au jeu de politiques nommé Mes politiques. Si vous ne souhaitez pas ajouter la nouvelle politique à ce jeu de politiques, indiquez un nom de jeu de politiques lorsque vous appelez la méthode registerPolicy.

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

Créez un objet API client Document Security.

• Créez un objet DocumentSecurityServiceClient en utilisant son constructeur par défaut.

• Créez un objet DocumentSecurityServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/RightsManagementService?WSDL). Vous n’avez pas besoin d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service.)

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ RightsManagementServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ RightsManagementServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Définissez les attributs de la politique.

• Créez un objet PolicySpec en utilisant son constructeur.
• Définissez le nom de la politique en attribuant une valeur de chaîne au membre de données name de l’objet PolicySpec.
• Définissez la description de la politique en attribuant une valeur de chaîne au membre de données description de l’objet PolicySpec.
• Définissez le jeu de politiques auquel la politique appartient en attribuant une valeur de chaîne au membre de données policySetName de l’objet PolicySpec. Indiquez un nom de jeu de politiques existant. (Vous pouvez spécifier null pour cette valeur de paramètre qui entraîne l’ajout de la politique à Mes politiques.)
• Définissez la période d’ouverture hors connexion de la politique en affectant une valeur entière au membre de données offlineLeasePeriod de l’objet PolicySpec.
• Définissez le membre de données policyXml de l’objet PolicySpec avec une valeur de chaîne qui représente les données XML PDRL. Pour effectuer cette tâche, créez un objet StreamReader .NET en utilisant son constructeur. Transmettez l’emplacement d’un fichier XML PDRL qui représente la politique au constructeur StreamReader. Ensuite, appelez la méthode ReadLine de l’objet StreamReader et affectez la valeur renvoyée à une variable chaîne. Effectuez une itération à l’aide de l’objet StreamReader jusqu’à ce que la méthode ReadLine renvoie une valeur nulle. Affectez la variable chaîne au membre de données policyXml de l’objet PolicySpec.

Créez une entrée de politique.

Il n’est pas nécessaire de créer une entrée de politique lors de la création d’une politique à l’aide de l’API Web Service Document Security. L’entrée de politique est définie dans le document PDRL.

Enregistrez la politique.

Enregistrez la politique en appelant la méthode registerPolicy de l’objet DocumentSecurityServiceClient et en transmettant les valeurs suivantes :

• Objet PolicySpec représentant la politique à enregistrer.
• Valeur string représentant le jeu de politiques auquel appartient la politique. Vous pouvez définir une valeur null qui entraîne l’ajout de la politique au jeu de politiques Mes politiques.

Si vous utilisez un compte d’administrateur d’AEM Forms dans les paramètres de connexion pour créer l’objet DocumentSecurityClient, spécifiez le nom du jeu de politiques lors de l’appel de la méthode registerPolicy.

Si vous utilisez un utilisateur Document Security dans les paramètres de connexion, vous pouvez appeler la méthode de surcharge registerPolicy qui accepte uniquement la politique. En d’autres termes, vous n’avez pas besoin de spécifier le nom du jeu de politiques. Cependant, la politique est ajoutée au jeu de politiques nommé Mes politiques. Si vous ne souhaitez pas ajouter la nouvelle politique à ce jeu de politiques, indiquez un nom de jeu de politiques lorsque vous appelez la méthode registerPolicy.

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-rightsmanagement-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créez un objet API client Document Security.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet RightsManagementClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Récupérez une politique existante.

• Créez un objet PolicyManager en appelant la méthode getPolicyManager de l’objet RightsManagementClient.

• Créez un objet Policy qui représente la politique à mettre à jour en appelant la méthode getPolicy de l’objet PolicyManager et en transmettant les valeurs suivantes.

  • Valeur de chaîne représentant le nom du jeu de politiques auquel appartient la politique. Vous pouvez indiquer null, ce qui entraîne l’utilisation du jeu de politiques MyPolicies.
  • Valeur de chaîne représentant le nom de la politique.

Définissez les attributs de la politique.

Modifiez les attributs de la politique pour répondre aux besoins de votre entreprise. Par exemple, pour modifier la période d’ouverture hors connexion de la politique, appelez la méthode setOfflineLeasePeriod de l’objet Policy.

Mettez à jour la politique.

Mettez à jour la politique en appelant la méthode updatePolicy de l’objet PolicyManager. Transmettez l’objet Policy qui représente la politique à mettre à jour.

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

Créez un objet API client Document Security.

• Créez un objet RightsManagementServiceClient en utilisant son constructeur par défaut.

• Créez un objet RightsManagementServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/RightsManagementService?WSDL). Vous n’avez pas besoin d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service.)

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ RightsManagementServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ RightsManagementServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Récupérez une politique existante.

Créez un objet PolicySpec représentant la politique à modifier en appelant la méthode getPolicy de l’objet RightsManagementServiceClient et en transmettant les valeurs suivantes :

• Une valeur de chaîne qui spécifie le nom du jeu de politiques auquel appartient la politique. Vous pouvez indiquer null qui entraîne l’utilisation du jeu de politiques MyPolicies.
• Une valeur de chaîne qui spécifie le nom de la politique.

Définissez les attributs de la politique.

Modifiez les attributs de la politique pour répondre aux besoins de votre entreprise.

Mettez à jour la politique.

Mettez à jour la politique en appelant la méthode updatePolicyFromSDK de l’objet RightsManagementServiceClient et en transmettant l’objet PolicySpec qui représente la politique à mettre à jour.

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-rightsmanagement-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créez un objet API client Document Security.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet RightsManagementClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Supprimez la politique.

• Créez un objet PolicyManager en appelant la méthode getPolicyManager de l’objet RightsManagementClient.

• Créez une politique en appelant la méthode deletePolicy de l’objet PolicyManager et en transmettant les valeurs suivantes :

  • Une valeur de chaîne qui spécifie le nom du jeu de politiques auquel appartient la politique. Vous pouvez indiquer null qui entraîne le jeu de politiques MyPolicies utilisé.
  • Une valeur de chaîne qui indique le nom de la politique à supprimer.

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

Créez un objet API client Document Security.

• Créez un objet RightsManagementServiceClient en utilisant son constructeur par défaut.

• Créez un objet RightsManagementServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/RightsManagementService?WSDL). Vous n’avez pas besoin d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service.)

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ RightsManagementServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ RightsManagementServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Supprimez la politique.

Créez une politique en appelant la méthode deletePolicy de l’objet RightsManagementServiceClient et en transmettant les valeurs suivantes :

• Une valeur de chaîne qui spécifie le nom du jeu de politiques auquel appartient la politique. Vous pouvez indiquer null qui entraîne le jeu de politiques MyPolicies utilisé.
• Une valeur de chaîne qui indique le nom de la politique à supprimer.

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-rightsmanagement-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créez un objet API client Document Security.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet RightsManagementClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Récupérez un document PDF.

• Créez un objet java.io.FileInputStream représentant le document PDF à l’aide de son constructeur. Transmettez une valeur de chaîne qui spécifie l’emplacement du document PDF.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Appliquez une politique existante au document PDF.

• Créez un objet DocumentManager en appelant la méthode getDocumentManager de l’objet RightsManagementClient.

• Appliquez une politique au document PDF en appelant la méthode protectDocument de l’objet DocumentManager et en transmettant les valeurs suivantes :

  • L’objet com.adobe.idp.Document contenant le document PDF auquel la politique est appliquée.
  • Une valeur de chaîne indiquant le nom du document.
  • Une valeur de chaîne représentant le nom du jeu de politiques auquel la politique appartient. Vous pouvez définir une valeur null qui entraîne le jeu de politiques MyPolicies utilisé.
  • Une valeur de chaîne qui spécifie le nom de la politique.
  • Une valeur de chaîne représentant le nom du domaine User Manager de l’utilisateur qui est l’éditeur du document. Cette valeur de paramètre est facultative et peut être une valeur null (si ce paramètre est null, la valeur de paramètre suivante doit être null).
  • Une valeur de chaîne représentant le nom canonique de l’utilisateur User Manager qui est l’éditeur du document. Cette valeur de paramètre est facultative et peut être null (si ce paramètre est null, la valeur du paramètre précédent doit être null).
  • Une valeur com.adobe.livecycle.rightsmanagement.Locale représentant le paramètre régional utilisé pour sélectionner le modèle MS Office. Cette valeur de paramètre est facultative et n’est pas utilisée pour les documents PDF. Pour protéger un document PDF, indiquez null.

  La méthode protectDocument renvoie un objet RMSecureDocumentResult contenant le document PDF protégé par une politique.

Enregistrez le formulaire PDF.

• Appelez la méthode getProtectedDoc de l’objet RMSecureDocumentResult pour obtenir le document PDF protégé par une politique. Cette méthode renvoie un objet com.adobe.idp.Document.
• Créez un objet java.io.File et s’assure que l’extension du fichier est PDF.
• Appelez la méthode copyToFile de l’objet com.adobe.idp.Document afin de copier le contenu de l’objet Document dans le fichier (veillez à utiliser l’objet Document renvoyé par la méthode getProtectedDoc).

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

Créez un objet API client Document Security.

• Créez un objet RightsManagementServiceClient en utilisant son constructeur par défaut.

• Créez un objet RightsManagementServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur de chaîne indiquant le WSDL au service Forms (par exemple, http://localhost:8080/soap/services/RightsManagementService?WSDL). Il n’est pas nécessaire d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service.)

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ RightsManagementServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ RightsManagementServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Récupérez un document PDF.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB sert à stocker un document PDF auquel une politique est appliquée.
• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du document PDF et son mode d’ouverture.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Déterminez la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream. Transmettez le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en attribuant à son champ MTOM le contenu du tableau d’octets.

Appliquez une politique existante au document PDF.

Appliquez une politique au document PDF en appelant la méthode protectDocument de l’objet RightsManagementServiceClient et en transmettant les valeurs suivantes :

• L’objet BLOB contenant le document PDF auquel la politique est appliquée.
• Une valeur de chaîne indiquant le nom du document.
• Une valeur de chaîne représentant le nom du jeu de politiques auquel la politique appartient. Vous pouvez définir une valeur null qui entraîne le jeu de politiques MyPolicies utilisé.
• Une valeur de chaîne qui spécifie le nom de la politique.
• Une valeur de chaîne représentant le nom du domaine User Manager de l’utilisateur qui est l’éditeur du document. Cette valeur de paramètre est facultative et peut être définie sur null (si ce paramètre est défini sur null, la valeur du paramètre suivant doit être null).
• Une valeur de chaîne représentant le nom canonique de l’utilisateur User Manager qui est l’éditeur du document. Cette valeur de paramètre est facultative et peut être définie sur null (si ce paramètre est défini sur null, la valeur du paramètre précédent doit être null).
• Une valeur RMLocale spécifiant la valeur du paramètre régional (par exemple, RMLocale.en).
• Un paramètre de sortie de chaîne utilisé pour stocker la valeur de l’identifiant de politique.
• Un paramètre de sortie de chaîne utilisé pour stocker la valeur de l’identifiant protégée par une politique.
• Un paramètre de sortie de chaîne utilisé pour stocker le type MIME (par exemple, application/pdf).

La méthode protectDocument renvoie un objet BLOB contenant le document PDF protégé par une politique.

Enregistrez le formulaire PDF.

• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du document PDF protégé par une politique.
• Créez un tableau d’octets qui stocke le contenu des données de l’objet BLOB renvoyé par la méthode protectDocument. Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM de l’objet BLOB.
• Créez un objet System.IO.BinaryWriter en utilisant son constructeur et en transmettant l’objet System.IO.FileStream.
• Écrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode Write de l’objet System.IO.BinaryWriter et en transmettant le tableau d’octets.

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-rightsmanagement-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créez un objet API client Document Security.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet DocumentSecurityClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Récupérez un document PDF protégé par une politique.

• Créez un objet java.io.FileInputStream représentant le document PDF protégé par une politique en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du document PDF.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Supprimez la politique du document PDF.

• Créez un objet DocumentManager en appelant la méthode getDocumentManager de l’objet DocumentSecurityClient.
• Supprimez une politique du document PDF en appelant la méthode removeSecurity de l’objet DocumentManager et en transmettant lʼobjet com.adobe.idp.Document contenant le document PDF protégé par une politique. Cette méthode renvoie un objet com.adobe.idp.Document contenant un document PDF non sécurisé.

Enregistrez le document PDF non sécurisé.

• Créez un objet java.io.File et assurez-vous que l’extension du fichier est PDF.
• Appelez la méthode copyToFile de l’objet Document afin de copier le contenu de l’objet Document dans le fichier (veillez à utiliser l’objet Document renvoyé par la méthode removeSecurity).

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

Créez un objet API client Document Security.

• Créez un objet DocumentSecurityServiceClient en utilisant son constructeur par défaut.

• Créez un objet DocumentSecurityServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/RightsManagementService?WSDL). Vous n’avez pas besoin d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service.)

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ DocumentSecurityServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Récupérez un document PDF protégé par une politique.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB sert à stocker le document PDF protégé par une politique à partir duquel la politique est supprimée.
• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du document PDF et le mode d’ouverture du fichier.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de flux en appelant la méthode Read de l’objet System.IO.FileStream et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en attribuant à son champ MTOM le contenu du tableau d’octets.

Supprimez la politique du document PDF.

Supprimez la politique du document PDF en appelant la méthode removePolicySecurity de l’objet DocumentSecurityServiceClient et en transmettant l’objet BLOB qui contient le document PDF protégé par la politique. Cette méthode renvoie un objet BLOB contenant un document PDF non sécurisé.

Enregistrez le document PDF non sécurisé.

• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du document PDF non sécurisé.
• Créez un tableau d’octets qui stocke le contenu des données de l’objet BLOB renvoyé par la méthode removePolicySecurity. Renseignez le tableau d’octets en obtenant la valeur du champ MTOM de l’objet BLOB.
• Créez un objet System.IO.BinaryWriter en utilisant son constructeur et en transmettant l’objet System.IO.FileStream.

Inclure les fichiers du projet

Incluez les fichiers JAR du client, tels qu’adobe-rightsmanagement-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créer un objet API client Document Security

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet DocumentSecurityClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Récupérer un document PDF protégé par une politique

• Créez un objet java.io.FileInputStream représentant le document PDF protégé par une politique en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du document PDF.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Révoquer le document protégé par une politique

• Créez un objet DocumentManager en appelant la méthode getDocumentManager de l’objet DocumentSecurityClient.

• Récupérez la valeur de l’identifiant de licence du document protégé par une politique en appelant la méthode getLicenseId de l’objet DocumentManager. Transmettez l’objet com.adobe.idp.Document représentant le document protégé par une politique. Cette méthode renvoie une valeur string qui représente la valeur de l’identifiant de licence.

• Créez un objet LicenseManager en appelant la méthode getLicenseManager de l’objet DocumentSecurityClient.

• Révoquez le document protégé par une politique en appelant la méthode revokeLicense de l’objet LicenseManager et en transmettant les valeurs suivantes :

  • Valeur de chaîne spécifiant la valeur de l’identifiant de licence du document protégé par une politique (spécifiez la valeur renvoyée de la méthode getLicenseId de l’objet DocumentManager).
  • Membre de données statique de l’interface License spécifiant le motif de révocation du document. Par exemple, vous pouvez spécifier License.DOCUMENT_REVISED.
  • Valeur java.net.URL spécifiant l’emplacement vers lequel se trouve un document modifié. Si vous ne souhaitez pas rediriger un utilisateur vers une autre URL, vous pouvez transmettre null.

Inclure les fichiers du projet

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

Créer un objet API client Document Security

• Créez un objet DocumentSecurityServiceClient en utilisant son constructeur par défaut.

• Créez un objet DocumentSecurityServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/RightsManagementService?WSDL). Vous n’avez pas besoin d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service.)

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ DocumentSecurityServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Récupérer un document PDF protégé par une politique

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB sert à stocker un document PDF protégé par une politique révoqué.
• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du document PDF protégé par une politique à révoquer et le mode d’ouverture du fichier.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de flux en appelant la méthode Read de l’objet System.IO.FileStream et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en attribuant à son champ MTOM le contenu du tableau d’octets.

Révoquer le document protégé par une politique

• Récupérez la valeur de l’identifiant de licence du document protégé par une politique en appelant la méthode getLicenseID de l’objet DocumentSecurityServiceClient et en transmettant l’objet BLOB représentant le document protégé par une politique. Cette méthode renvoie une valeur de chaîne représentant l’identifiant de licence.

• Révoquez le document protégé par une politique en appelant la méthode revokeLicense de l’objet DocumentSecurityServiceClient et en transmettant les valeurs suivantes :

  • Valeur de chaîne qui spécifie la valeur d’identifiant de licence du document protégé par une politique (spécifiez la valeur renvoyée par la méthode getLicenseId de l’objet DocumentSecurityServiceService).
  • Membre de données statique de l’énumération Reason indiquant le motif de révocation du document. Par exemple, vous pouvez spécifier Reason.DOCUMENT_REVISED.
  • Valeur string indiquant l’emplacement URL vers lequel se trouve un document modifié. Si vous ne souhaitez pas rediriger un utilisateur vers une autre URL, vous pouvez transmettre null.

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-rightsmanagement-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créez un objet API client Document Security.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet DocumentSecurityClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Récupérez l’identifiant de licence du document PDF révoqué.

• Créez un objet java.io.FileInputStream qui représente le document PDF révoqué en utilisant son constructeur et en transmettant une valeur string spécifiant l’emplacement du document PDF.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.
• Créez un objet DocumentManager en appelant la méthode getDocumentManager de l’objet DocumentSecurityClient.
• Récupérez la valeur de l’identifiant de licence du document révoqué en appelant la méthode getLicenseId de l’objet DocumentManager et en transmettant l’objet com.adobe.idp.Document qui représente le document révoqué. Cette méthode renvoie une valeur de chaîne représentant l’identifiant de licence.

Rétablissez l’accès au document PDF révoqué.

• Créez un objet LicenseManager en appelant la méthode getLicenseManager de l’objet DocumentSecurityClient.
• Rétablissez l’accès au document PDF révoqué en appelant la méthode unrevokeLicense de l’objet LicenseManager et en transmettant la valeur d’identifiant de licence du document révoqué.

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

Créez un objet API client Document Security.

• Créez un objet DocumentSecurityServiceClient en utilisant son constructeur par défaut.

• Créez un objet DocumentSecurityServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/RightsManagementService?WSDL). Vous n’avez pas besoin d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service.)

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ DocumentSecurityServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Récupérez l’identifiant de licence du document PDF révoqué.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB sert à stocker un document PDF révoqué auquel l’accès est rétabli.
• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du document PDF révoqué et le mode d’ouverture du fichier.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de flux en appelant la méthode Read de l’objet System.IO.FileStream et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en attribuant à son champ MTOM le contenu du tableau d’octets.

Rétablissez l’accès au document PDF révoqué.

• Récupérez la valeur de l’identifiant de licence du document révoqué en appelant la méthode getLicenseID de l’objet DocumentSecurityServiceClient et en transmettant l’objet BLOB qui représente le document révoqué. Cette méthode renvoie une valeur de chaîne représentant l’identifiant de licence.
• Rétablissez l’accès au document PDF révoqué en appelant la méthode unrevokeLicense de l’objet DocumentSecurityServiceClient et en transmettant une valeur de chaîne qui spécifie la valeur d’identifiant de licence du document PDF révoqué (transmettez la valeur de retour de la méthode getLicenseId de l’objet DocumentSecurityServiceClient).

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-rightsmanagement-client.jar, dans le chemin d’accès aux classes de votre projet Java. Pour plus d’informations sur l’emplacement de ces fichiers, voir Inclusion des fichiers de bibliothèque Java AEM Forms.

Créez un objet API client Document Security.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion. (Voir Réglage des propriétés de la connexion.)
• Créez un objet RightsManagementClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Récupérez un document protégé par une politique à inspecter.

• Créez un objet java.io.FileInputStream qui représente le document PDF protégé par une politique à l’aide de son constructeur. Transmettez une valeur de chaîne qui spécifie l’emplacement du document PDF.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Inspectez le document.

• Créez un objet DocumentManager en appelant la méthode getDocumentManager de l’objet RightsManagementClient.
• Inspectez le document protégé par une politique en appelant la méthode inspectDocument de l’objet LicenseManager. Transmettez l’objet com.adobe.idp.Document contenant le document PDF protégé par une politique. Cette méthode renvoie un objet RMInspectResult contenant des informations sur le document protégé par une politique.

Obtenez des informations sur le document protégé par une politique.

Pour obtenir des informations sur le document protégé par une politique, appelez la méthode appropriée appartenant à l’objet RMInspectResult. Par exemple, pour récupérer le nom de la politique, appelez la méthode getPolicyName de l’objet RMInspectResult.

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

Créez un objet API client Document Security.

• Créez un objet RightsManagementServiceClient en utilisant son constructeur par défaut.

• Créez un objet RightsManagementServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/RightsManagementService?WSDL). Vous n’avez pas besoin d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service.)

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ RightsManagementServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ RightsManagementServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Récupérez un document protégé par une politique à inspecter.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB sert à stocker un document PDF à inspecter.
• Créez un objet System.IO.FileStream en appelant son constructeur. Transmettez une valeur de chaîne qui représente l’emplacement du document PDF et son mode d’ouverture.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream. Transmettez le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en attribuant à son champ MTOM le contenu du tableau d’octets.

Inspectez le document.

Inspectez le document protégé par une politique en appelant la méthode inspectDocument de l’objet RightsManagementServiceClient. Transmettez l’objet BLOB contenant le document PDF protégé par une politique. Cette méthode renvoie un objet RMInspectResult contenant des informations sur le document protégé par une politique.

Obtenez des informations sur le document protégé par une politique.

Pour obtenir des informations sur le document protégé par une politique, obtenez la valeur du champ approprié qui appartient à l’objet RMInspectResult. Par exemple, pour récupérer le nom de la politique, obtenez la valeur du champ policyName de l’objet RMInspectResult.

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels que adobe-rightsmanagement-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créez un objet API client Document Security.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet RightsManagementClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Définir les attributs du filigrane

• Créez un objet Watermark en appelant la méthode statique createWatermark de l’objet InfomodelObjectFactory. Cette méthode renvoie un objet Watermark.
• Définissez l’attribut du nom du filigrane en appelant la méthode setName de l’objet Watermark et en transmettant une valeur de chaîne qui spécifie le nom de la politique.
• Définissez l’attribut d’arrière-plan du filigrane en appelant la méthode setBackground de l’objet Watermark et en transmettant true. En définissant cet attribut, le filigrane apparaît à l’arrière-plan du document.
• Définissez l’attribut de texte personnalisé du filigrane en appelant la méthode setCustomText de l’objet Watermark et en transmettant une valeur de chaîne représentant le texte du filigrane.
• Définissez l’attribut d’opacité du filigrane en appelant la méthode setOpacity de l’objet Watermark et en transmettant une valeur entière qui spécifie le niveau d’opacité. Une valeur de 100 indique que le filigrane est complètement opaque et une valeur de 0 signifie quʼil est complètement transparent.

Enregistrez le filigrane.

• Créez un objet WatermarkManager en appelant la méthode getWatermarkManager de l’objet RightsManagementClient. Cette méthode renvoie un objet WatermarkManager.
• Enregistrez le filigrane en appelant la méthode registerWatermark de l’objet WatermarkManager et en transmettant l’objet Watermark qui représente le filigrane à enregistrer. Cette méthode renvoie une valeur de chaîne qui représente la valeur d’identification du filigrane.

Créez un objet API client Document Security.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

Créez un objet API client Document Security.

• Créez un objet RightsManagementServiceClient en utilisant son constructeur par défaut.

• Créez un objet RightsManagementServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/RightsManagementService?WSDL). Vous n’avez pas besoin d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service.)

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ RightsManagementServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ RightsManagementServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Définissez les attributs du filigrane.

• Créez un objet WatermarkSpec en appelant le constructeur WatermarkSpec.
• Définissez le nom du filigrane en attribuant une valeur de chaîne au membre de données name de l’objet WatermarkSpec.
• Définissez l’attribut id du filigrane en attribuant une valeur de chaîne au membre de données id de l’objet WatermarkSpec.
• Pour chaque propriété de filigrane à définir, créez un objet MyMapOf_xsd_string_To_xsd_anyType_Item distinct.
• Définissez la valeur clé en attribuant une valeur au membre de données key de l’objet MyMapOf_xsd_string_To_xsd_anyType_Item (par exemple WaterBackCmd:OPACITY)).
• Définissez la valeur en attribuant une valeur au membre de données value de l’objet MyMapOf_xsd_string_To_xsd_anyType_Item (par exemple .25).
• Créez un objet MyArrayOf_xsd_anyType. Pour chaque objet MyMapOf_xsd_string_To_xsd_anyType_Item, appelez la méthode Add de l’objet MyArrayOf_xsd_anyType. Transmettez l’objet MyMapOf_xsd_string_To_xsd_anyType_Item.
• Attribuez l’objet MyArrayOf_xsd_anyType au membre de données values de l’objet WatermarkSpec.

Enregistrez le filigrane.

Enregistrez le filigrane en appelant la méthode registerWatermark de l’objet RightsManagementServiceClient et en transmettant l’objet WatermarkSpec représentant le filigrane à enregistrer.

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-rightsmanagement-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créez un objet API client Document Security.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet DocumentSecurityClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Récupérez le filigrane à modifier.

Créez un objet WatermarkManager en appelant la méthode getWatermarkManager de l’objet DocumentSecurityClient et en transmettant une valeur de chaîne qui spécifie le nom du filigrane. Cette méthode renvoie un objet Watermark qui représente le filigrane à modifier.

Définissez les attributs du filigrane.

Définissez l’attribut d’opacité du filigrane en appelant la méthode setOpacity de l’objet Watermark et en transmettant une valeur entière qui spécifie le niveau d’opacité. Une valeur de 100 indique que le filigrane est complètement opaque et une valeur de 0 signifie quʼil est complètement transparent.

Mettez à jour le filigrane.

• Mettez à jour le filigrane en appelant la méthode updateWatermark de l’objet WatermarkManager et en transmettant l’objet Watermark dont l’attribut a été modifié.

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

Créez un objet API client Document Security.

• Créez un objet DocumentSecurityServiceClient en utilisant son constructeur par défaut.

• Créez un objet RightsManagementServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/DocumentSecurityService?WSDL). Vous n’avez pas besoin d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service.)

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ DocumentSecurityServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Récupérez le filigrane à modifier.

Récupérez le filigrane à modifier en appelant la méthode getWatermarkByName de l’objet DocumentSecurityServiceClient. Transmettez une valeur string qui spécifie le nom du filigrane. Cette méthode renvoie un objet WatermarkSpec qui représente le filigrane à modifier.

Définissez les attributs du filigrane.

• Pour chaque propriété de filigrane à mettre à jour, créez un objet MyMapOf_xsd_string_To_xsd_anyType_Item à part.
• Définissez la valeur clé en attribuant une valeur au membre de données key de l’objet MyMapOf_xsd_string_To_xsd_anyType_Item (par exemple WaterBackCmd:OPACITY)).
• Définissez la valeur en attribuant une valeur au membre de données value de l’objet MyMapOf_xsd_string_To_xsd_anyType_Item (par exemple .50).
• Créez un objet MyArrayOf_xsd_anyType. Pour chaque objet MyMapOf_xsd_string_To_xsd_anyType_Item, appelez la méthode Add de l’objet MyArrayOf_xsd_anyType. Transmettez l’objet MyMapOf_xsd_string_To_xsd_anyType_Item.
• Attribuez l’objet MyArrayOf_xsd_anyType au membre de données values de l’objet WatermarkSpec.

Mettez à jour le filigrane.

Mettez à jour le filigrane en appelant la méthode updateWatermark de l’objet DocumentSecurityServiceClient et en transmettant l’objet WatermarkSpec qui représente le filigrane à modifier.

Inclure les fichiers du projet

Incluez les fichiers JAR du client, tels qu’adobe-rightsmanagement-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créer un objet API client Rights Management

Créez un objet DocumentSecurityClient en utilisant son constructeur et en transmettant un objet ServiceClientFactory contenant des propriétés de connexion.

Définir les événements à rechercher

• Créez un objet EventManager en appelant la méthode getEventManager de l’objet DocumentSecurityClient. Cette méthode renvoie un objet EventManager.
• Créez un objet EventSearchFilter en appelant son constructeur.
• Indiquez l’événement pour lequel effectuer une recherche en appelant la méthode setEventCode de l’objet EventSearchFilter et en transmettant un membre de données statique qui appartient à la classe EventManager représentant l’événement à rechercher. Par exemple, pour rechercher l’événement de création de politique, transmettez EventManager.POLICY_CREATE_EVENT.

Rechercher l’événement

Recherchez l’événement en appelant la méthode searchForEvents de l’objet EventManager et en transmettant l’objet EventSearchFilter qui définit les critères de recherche d’événement. Cette méthode renvoie un tableau d’objets Event.

Inclure les fichiers du projet

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

Créer un objet API client Rights Management

• Créez un objet DocumentSecurityServiceClient en utilisant son constructeur par défaut.

• Créez un objet DocumentSecurityServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/RightsManagementService?WSDL). Vous n’avez pas besoin d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service.)

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ DocumentSecurityServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Définir les événements à rechercher

• Créez un objet EventSpec en utilisant son constructeur.
• Spécifiez le début de la période au cours de laquelle l’événement s’est produit en définissant le membre de données firstTime.date de l’objet EventSpec avec l’instance DataTime représentant le début de la période au cours de laquelle l’événement s’est produit.
• Attribuez la valeur true au membre de données firstTime.dateSpecified de l’objet EventSpec.
• Indiquez la fin de la période au cours de laquelle l’événement s’est produit en définissant le membre de données lastTime.date de l’objet EventSpec avec l’instance DataTime qui représente la fin de la période au cours de laquelle l’événement s’est produit.
• Attribuez la valeur true au membre de données lastTime.dateSpecified de l’objet EventSpec.
• Définissez l’événement à rechercher en attribuant une valeur de chaîne au membre de données eventCode de l’objet EventSpec. Le tableau suivant répertorie les valeurs numériques que vous pouvez attribuer à cette propriété :

Rechercher l’événement

Recherchez l’événement en appelant la méthode searchForEvents de l’objet DocumentSecurityServiceClient et en transmettant l’objet EventSpec représentant l’événement pour lequel effectuer une recherche et le nombre maximal de résultats. Cette méthode renvoie une collection MyArrayOf_xsd_anyType où chaque élément est une instance AuditSpec. En utilisant une instance AuditSpec, vous pouvez obtenir des informations sur l’événement, telles que l’heure à laquelle il s’est produit. L’instance AuditSpec contient un membre de données timestamp qui spécifie ces informations.

Incluez les fichiers de projet.

Incluez les fichiers JAR du client, tels qu’adobe-rightsmanagement-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créez un objet API client Document Security.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet DocumentSecurityClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Récupérez un document Word.

• Créez un objet java.io.FileInputStream qui représente le document Word en utilisant son constructeur et en transmettant une valeur string qui spécifie l’emplacement du document Word.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Appliquez une politique existante au document Word.

• Créez un objet DocumentManager en appelant la méthode getDocumentManager de l’objet DocumentSecurityClient.

• Appliquez une politique au document Word en appelant la méthode protectDocument de l’objet DocumentManager et en transmettant les valeurs suivantes :

  • Objet com.adobe.idp.Document contenant le document Word auquel s’applique la politique.
  • Une valeur de chaîne indiquant le nom du document.
  • Une valeur de chaîne représentant le nom du jeu de politiques auquel la politique appartient. Vous pouvez définir une valeur null qui entraîne le jeu de politiques MyPolicies utilisé.
  • Une valeur de chaîne qui spécifie le nom de la politique.
  • Une valeur de chaîne représentant le nom du domaine User Manager de l’utilisateur qui est l’éditeur du document. Cette valeur de paramètre est facultative et peut être une valeur null (si ce paramètre est null, la valeur de paramètre suivante doit être null).
  • Une valeur de chaîne représentant le nom canonique de l’utilisateur User Manager qui est l’éditeur du document. Cette valeur de paramètre est facultative et peut être null (si ce paramètre est null, alors la valeur du paramètre précédent doit être null).
  • com.adobe.livecycle.rightsmanagement.Locale représentant le paramètre régional utilisé pour sélectionner le modèle MS Office. Cette valeur de paramètre est facultative et vous pouvez spécifier null.

  La méthode protectDocument renvoie un objet RMSecureDocumentResult contenant le document Word protégé par une politique.

Enregistrez le document Word.

• Appelez la méthode getProtectedDoc de l’objet RMSecureDocumentResult pour obtenir le document Word protégé par une politique. Cette méthode renvoie un objet com.adobe.idp.Document.
• Créez un objet java.io.File et assurez-vous que l’extension du fichier est DOC.
• Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour copier le contenu de l’objet Document dans le fichier (assurez-vous d’utiliser l’objet Document renvoyé par la méthode getProtectedDoc).

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1.

Créez un objet API client Document Security.

• Créez un objet DocumentSecurityServiceClient en utilisant son constructeur par défaut.

• Créez un objet DocumentSecurityServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/DocumentSecurityService?WSDL). Vous n’avez pas besoin d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service.)

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ DocumentSecurityServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Récupérez un document Word.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB sert à stocker un document Word auquel une politique est appliquée.
• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du document Word et le mode d’ouverture du fichier.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Déterminez la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream. Transmettez le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en attribuant à son champ MTOM le contenu du tableau d’octets.

Appliquez une politique existante au document Word.

Appliquez une politique au document Word en appelant la méthode protectDocument de l’objet DocumentSecurityServiceClient et en transmettant les valeurs suivantes :

• Objet BLOB contenant le document Word auquel s’applique la politique.
• Une valeur de chaîne indiquant le nom du document.
• Une valeur de chaîne représentant le nom du jeu de politiques auquel la politique appartient. Vous pouvez définir une valeur null qui entraîne le jeu de politiques MyPolicies utilisé.
• Une valeur de chaîne qui spécifie le nom de la politique.
• Une valeur de chaîne représentant le nom du domaine User Manager de l’utilisateur qui est l’éditeur du document. Cette valeur de paramètre est facultative et peut être définie sur null (si ce paramètre est défini sur null, la valeur du paramètre suivant doit être null).
• Une valeur de chaîne représentant le nom canonique de l’utilisateur User Manager qui est l’éditeur du document. Cette valeur de paramètre est facultative et peut être définie sur null (si ce paramètre est défini sur null, la valeur du paramètre précédent doit être null).
• Une valeur RMLocale spécifiant la valeur du paramètre régional (par exemple, RMLocale.en).
• Un paramètre de sortie de chaîne utilisé pour stocker la valeur de l’identifiant de politique.
• Un paramètre de sortie de chaîne utilisé pour stocker la valeur de l’identifiant protégée par une politique.
• Paramètre de sortie de chaîne utilisé pour stocker le type MIME (par exemple application/doc).

La méthode protectDocument renvoie un objet BLOB contenant le document Word protégé par une politique.

Enregistrez le document Word.

• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du document Word protégé par une politique.
• Créez un tableau d’octets qui stocke le contenu des données de l’objet BLOB renvoyé par la méthode protectDocument. Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM de l’objet BLOB.
• Créez un objet System.IO.BinaryWriter en utilisant son constructeur et en transmettant l’objet System.IO.FileStream.
• Écrivez le contenu du tableau d’octets dans un fichier Word en appelant la méthode Write de l’objet System.IO.BinaryWriter et en transmettant le tableau d’octets.

Inclure les fichiers du projet

Incluez les fichiers JAR du client, tels qu’adobe-rightsmanagement-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créer un objet API client Document Security

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet RightsManagementClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Récupérer un document Word protégé par une politique

• Créez un objet java.io.FileInputStream qui représente le document Word protégé par une politique en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du document Word.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Supprimer la politique du document Word

• Créez un objet DocumentManager en appelant la méthode getDocumentManager de l’objet RightsManagementClient.
• Supprimez la politique du document Word en appelant la méthode removeSecurity de l’objet DocumentManager et en transmettant l’objet com.adobe.idp.Document qui contient le document Word protégé par la politique. Cette méthode renvoie un objet com.adobe.idp.Document qui contient un document Word non sécurisé.

Enregistrer le document Word non sécurisé

• Créez un objet java.io.File et assurez-vous que l’extension du fichier est DOC.
• Appelez la méthode copyToFile de l’objet Document pour copier le contenu de l’objet Document dans le fichier (assurez-vous d’utiliser l’objet Document renvoyé par la méthode removeSecurity).

Inclure les fichiers du projet

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

Créer un objet API client Document Security

• Créez un objet RightsManagementServiceClient en utilisant son constructeur par défaut.

• Créez un objet RightsManagementServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/RightsManagementService?WSDL). Vous n’avez pas besoin d’utiliser l’attribut lc_version. Cet attribut est utilisé lorsque vous créez une référence de service.)

• Créez un objet System.ServiceModel.BasicHttpBinding en obtenant la valeur du champ RightsManagementServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ RightsManagementServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ RightsManagementServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Récupérer un document Word protégé par une politique

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour enregistrer le document Word protégé par une politique et dont la politique est supprimée.
• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du fichier Word et son mode d’ouverture.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de flux en appelant la méthode Read de l’objet System.IO.FileStream et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en attribuant le contenu du tableau d’octets à son champ MTOM.

Supprimer la politique du document Word

Supprimez la politique du document Word en appelant la méthode removePolicySecurity de l’objet RightsManagementServiceClient et en transmettant l’objet BLOB qui contient le document Word protégé par la politique. Cette méthode renvoie un objet BLOB qui contient un document Word non sécurisé.

Enregistrer le document Word non sécurisé

• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier Word non protégé.
• Créez un tableau d’octets qui stocke le contenu des données de l’objet BLOB renvoyé par la méthode removePolicySecurity. Renseignez le tableau d’octets en obtenant la valeur du champ MTOM de l’objet BLOB.
• Créez un objet System.IO.BinaryWriter en utilisant son constructeur et en transmettant l’objet System.IO.FileStream.