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

Incluez les fichiers de projet.

Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe 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 stratégie.

• Créez un Policy en appelant la méthode InfomodelObjectFactory statique de l’objet createPolicy . Cette méthode renvoie un objet Policy.
• Définissez l’attribut name de la stratégie en appelant la variable Policy de setName et transmission d’une valeur string qui spécifie le nom de la stratégie.
• Définissez la description de la stratégie en appelant la fonction Policy de setDescription et transmission d’une valeur string qui spécifie la description de la stratégie.
• Spécifiez le jeu de stratégies auquel appartient la nouvelle stratégie en appelant la fonction Policy de setPolicySetName et transmission d’une valeur string qui spécifie le nom du jeu de stratégies. (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 stratégie en appelant la variable InfomodelObjectFactory statique de l’objet createValidityPeriod . Cette méthode renvoie un objet ValidityPeriod.
• Définissez le nombre de jours pendant lesquels un document protégé par une stratégie est accessible en appelant la variable ValidityPeriod de setRelativeExpirationDays et transmettre une valeur entière qui spécifie le nombre de jours.
• Définissez la période de validité de la stratégie en appelant la variable Policy de setValidityPeriod et transmission de la méthode ValidityPeriod .

Créez une entrée de politique.

• Créez une entrée de stratégie en appelant la méthode InfomodelObjectFactory statique de l’objet createPolicyEntry . Cette méthode renvoie un objet PolicyEntry.
• Spécifiez les autorisations de la stratégie en appelant la fonction InfomodelObjectFactory statique de l’objet createPermission . 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 stratégie en appelant la méthode PolicyEntry de addPermission et transmission de la méthode Permission . (Répétez cette étape pour chaque objet Permission que vous avez créé).
• Créez l’entité de stratégie en appelant la méthode InfomodelObjectFactory statique de l’objet createSpecialPrincipal . 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 l’entité de sécurité à l’entrée de stratégie en appelant la méthode PolicyEntry de setPrincipalet transmission de la méthode Principal .
• Ajoutez l’entrée de stratégie à la stratégie en appelant la méthode Policy de addPolicyEntry et transmission de la méthode PolicyEntry .

Enregistrez la politique.

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

• Enregistrez la stratégie en appelant la méthode PolicyManager de registerPolicy et transmission des 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 administrateur d’AEM forms dans les paramètres de connexion pour créer la variable DocumentSecurityClient , puis spécifiez le nom du jeu de stratégies lorsque vous appelez la variable 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 stratégie.

• Créez un objet PolicySpec en utilisant son constructeur.
• Définissez le nom de la stratégie en attribuant une valeur de chaîne au PolicySpec de name membre de données.
• Définissez la description de la stratégie en attribuant une valeur de chaîne à la variable PolicySpec de description membre de données.
• Spécifiez le jeu de stratégies auquel appartient la stratégie en attribuant une valeur string à la variable PolicySpec de policySetName membre de données. Spécifiez un nom de jeu de stratégies 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 stratégie en attribuant une valeur entière à la variable PolicySpec de offlineLeasePeriod membre de données.
• Définissez la variable PolicySpec de policyXml membre de données avec une valeur string 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 fonction StreamReader de ReadLine et affecter la valeur renvoyée à une variable string . Effectuez une itération à l’aide de l’objet StreamReader jusqu’à ce que la méthode ReadLine renvoie une valeur nulle. Affectez la variable string à la variable PolicySpec de policyXml membre de données.

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 stratégie en appelant la méthode DocumentSecurityServiceClient de registerPolicy et transmission des 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 administrateur d’AEM forms dans les paramètres de connexion pour créer la variable DocumentSecurityClient , spécifiez le nom du jeu de stratégies lors de l’appel de la variable 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 client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe 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 Policy qui représente la stratégie à mettre à jour en appelant la fonction PolicyManager de getPolicy et transmission des 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 stratégie.

Modifiez les attributs de la stratégie pour répondre aux besoins de votre entreprise. Par exemple, pour modifier la période d’ouverture hors connexion de la stratégie, appelez la variable Policy de setOfflineLeasePeriod .

Mettez à jour la politique.

Mettez à jour la stratégie en appelant PolicyManager de updatePolicy . 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 PolicySpec qui représente la stratégie à modifier en appelant la variable RightsManagementServiceClient de getPolicy et transmission des 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 stratégie.

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

Mettez à jour la politique.

Mettez à jour la stratégie en appelant la méthode RightsManagementServiceClient de updatePolicyFromSDK et transmission de la méthode PolicySpec qui représente la stratégie à mettre à jour.

Incluez les fichiers de projet.

Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe 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.

• Supprimez la stratégie en appelant la méthode PolicyManager de deletePolicy et transmission des 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.

Pour supprimer une stratégie, appelez la méthode RightsManagementServiceClient de deletePolicy et transmission des 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 client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe 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 stratégie au document du PDF en appelant la méthode DocumentManager de protectDocument et transmission des 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.

• Appeler la variable RMSecureDocumentResult de getProtectedDoc pour obtenir le document de PDF protégé par une stratégie. 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.
• Appeler la variable com.adobe.idp.Document de copyToFile pour copier le contenu de la méthode Document dans le fichier (assurez-vous d’utiliser la variable Document qui a été renvoyé par l’objet 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 variable System.IO.FileStream de Length .
• 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 stratégie au document du PDF en appelant la méthode RightsManagementServiceClient de protectDocument et transmission des 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 client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe 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 stratégie du document du PDF en appelant la méthode DocumentManager de removeSecurity et transmission de la méthode com.adobe.idp.Document contenant le document de PDF protégé par une stratégie. 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.
• Appeler la variable Document de copyToFile pour copier le contenu de la méthode Document dans le fichier (assurez-vous d’utiliser la variable Document qui a été renvoyé par l’objet 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 stratégie du document du PDF en appelant la méthode DocumentSecurityServiceClient de removePolicySecurity et transmission de la méthode BLOB contenant le document de PDF protégé par une stratégie. 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 client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe 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 stratégie en appelant la fonction DocumentManager de getLicenseId . 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 stratégie en appelant la fonction LicenseManager de revokeLicense et transmission des valeurs suivantes :

  • Une valeur string qui spécifie la valeur d’identifiant de licence du document protégé par une stratégie (spécifiez la valeur renvoyée par la propriété DocumentManager de getLicenseId ).
  • 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 stratégie en appelant la fonction DocumentSecurityServiceClient de getLicenseID et transmission de la méthode BLOB qui représente le document protégé par une stratégie. Cette méthode renvoie une valeur de chaîne représentant l’identifiant de licence.

• Révoquez le document protégé par une stratégie en appelant la fonction DocumentSecurityServiceClient de revokeLicense et transmission des valeurs suivantes :

  • Une valeur string qui spécifie la valeur d’identifiant de licence du document protégé par une stratégie (spécifiez la valeur renvoyée par la propriété DocumentSecurityServiceService de getLicenseId ).
  • 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 client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe 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 fonction DocumentManager de getLicenseId et transmission de la méthode com.adobe.idp.Document qui représente le document révoqué. Cette méthode renvoie une valeur string qui représente 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 du PDF révoqué en appelant la méthode LicenseManager de unrevokeLicense et transmission de 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 fonction DocumentSecurityServiceClient de getLicenseID et transmission de la méthode 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 du PDF révoqué en appelant la méthode DocumentSecurityServiceClient de unrevokeLicense et transmission d’une valeur string qui spécifie la valeur d’identifiant de licence du document de PDF révoqué (transmettez la valeur de retour de la fonction DocumentSecurityServiceClient de getLicenseId ).

Incluez les fichiers de projet.

Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe 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.
• Inspect du document protégé par une stratégie en appelant la méthode LicenseManager de inspectDocument . 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 stratégie, appelez la méthode RMInspectResult de getPolicyName .

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.

Inspect du document protégé par une stratégie en appelant la méthode RightsManagementServiceClient de inspectDocument . 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 stratégie, obtenez la valeur de la variable RMInspectResult de policyName champ .

Incluez les fichiers de projet.

Inclure les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe 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 Watermark en appelant la méthode InfomodelObjectFactory statique de l’objet createWatermark . Cette méthode renvoie un objet Watermark.
• Définissez l’attribut name du filigrane en appelant la variable Watermark de setName et transmission d’une valeur string qui spécifie le nom de la stratégie.
• Définissez l’attribut d’arrière-plan du filigrane en appelant la fonction Watermark de setBackground méthode et transmission 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 fonction Watermark de setCustomText et transmission d’une valeur string qui représente le texte du filigrane.
• Définissez l’attribut d’opacité du filigrane en appelant la variable Watermark de setOpacity et transmettre 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 indique que le filigrane est complètement transparent.

Enregistrez le filigrane.

• Créez un WatermarkManager en appelant la méthode RightsManagementClient de getWatermarkManager . Cette méthode renvoie un objet WatermarkManager.
• Enregistrez le filigrane en appelant la méthode WatermarkManager de registerWatermark et transmission de la méthode Watermark qui représente le filigrane à enregistrer. Cette méthode renvoie une valeur string 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 à la variable WatermarkSpec de name membre de données.
• Définition du filigrane id en attribuant une valeur de chaîne à la variable WatermarkSpec de id membre de données.
• Pour chaque propriété de filigrane à définir, créez un objet MyMapOf_xsd_string_To_xsd_anyType_Item distinct.
• Définissez la valeur de clé en attribuant une valeur à la variable MyMapOf_xsd_string_To_xsd_anyType_Item de key membre de données (par exemple, WaterBackCmd:OPACITY).
• Définissez la valeur en attribuant une valeur à la variable MyMapOf_xsd_string_To_xsd_anyType_Item de value membre de données (par exemple, .25).
• Créez un objet MyArrayOf_xsd_anyType. Pour chaque MyMapOf_xsd_string_To_xsd_anyType_Item , appelez l’objet MyArrayOf_xsd_anyType de Add . Transmettez l’objet MyMapOf_xsd_string_To_xsd_anyType_Item.
• Attribuez le MyArrayOf_xsd_anyType vers l’objet WatermarkSpec de values membre de données.

Enregistrez le filigrane.

Enregistrez le filigrane en appelant la méthode RightsManagementServiceClient de registerWatermark et transmission de la méthode WatermarkSpec qui représente le filigrane à enregistrer.

Incluez les fichiers de projet.

Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe 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 WatermarkManager en appelant la méthode DocumentSecurityClient de getWatermarkManager et transmettez une valeur string 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 variable Watermark de setOpacity et transmettre 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 indique que le filigrane est complètement transparent.

Mettez à jour le filigrane.

• Mettez à jour le filigrane en appelant la méthode WatermarkManager de updateWatermark et transmettez la méthode 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 fonction DocumentSecurityServiceClient de getWatermarkByName . 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 de clé en attribuant une valeur à la variable MyMapOf_xsd_string_To_xsd_anyType_Item de key membre de données (par exemple, WaterBackCmd:OPACITY).
• Définissez la valeur en attribuant une valeur à la variable MyMapOf_xsd_string_To_xsd_anyType_Item de value membre de données (par exemple, .50).
• Créez un objet MyArrayOf_xsd_anyType. Pour chaque MyMapOf_xsd_string_To_xsd_anyType_Item , appelez l’objet MyArrayOf_xsd_anyType de Add . Transmettez l’objet MyMapOf_xsd_string_To_xsd_anyType_Item.
• Attribuez le MyArrayOf_xsd_anyType vers l’objet WatermarkSpec de values membre de données.

Mettez à jour le filigrane.

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

Inclure les fichiers du projet

Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe 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 EventManager en appelant la méthode DocumentSecurityClient de getEventManager . 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 variable EventSearchFilter de setEventCode et transmission d’un membre de données statique qui appartient à la méthode EventManager qui représente l’événement pour lequel effectuer une recherche. 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 fonction EventManager de searchForEvents et transmission de la méthode 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 la variable EventSpec de firstTime.date membre de données avec DataTime qui représente le début de la période au cours de laquelle l’événement s’est produit.
• Attribuer la valeur true à la fonction EventSpec de firstTime.dateSpecified membre de données.
• Indiquez la fin de la période au cours de laquelle l’événement s’est produit en définissant la variable EventSpec de lastTime.date membre de données avec DataTime qui représente la fin de la période au cours de laquelle l’événement s’est produit.
• Attribuer la valeur true à la fonction EventSpec de lastTime.dateSpecified membre de données.
• Définissez l’événement à rechercher en attribuant une valeur de chaîne à la variable EventSpec de eventCode membre de données. 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 fonction DocumentSecurityServiceClient de searchForEvents et transmission de la méthode EventSpec qui représente 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 client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe 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 stratégie au document Word en appelant la méthode DocumentManager de protectDocument et transmission des 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.

• Appeler la variable RMSecureDocumentResult de getProtectedDoc pour obtenir le document Word protégé par une stratégie. 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.
• Appeler la variable com.adobe.idp.Document de copyToFile pour copier le contenu de la méthode Document dans le fichier (assurez-vous d’utiliser la variable Document qui a été renvoyé par l’objet 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 variable System.IO.FileStream de Length .
• 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 stratégie au document Word en appelant la méthode DocumentSecurityServiceClient de protectDocument et transmission des 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.
• Ecrivez le contenu du tableau d’octets dans un fichier Word en appelant la méthode System.IO.BinaryWriter de Write et transmission du tableau d’octets.

Inclure les fichiers du projet

Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe 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 une stratégie du document Word en appelant la méthode DocumentManager de removeSecurity et transmission de la méthode com.adobe.idp.Document contenant le document Word protégé par une stratégie. 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.
• Appeler la variable Document de copyToFile pour copier le contenu de la méthode Document dans le fichier (assurez-vous d’utiliser la variable Document qui a été renvoyé par l’objet 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 stratégie du document Word en appelant la méthode RightsManagementServiceClient de removePolicySecurity et transmission de la méthode BLOB contenant le document Word protégé par une stratégie. 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.