Protection des documents avec des stratégies

Les exemples et les exemples de ce document sont réservés à l’environnement AEM Forms on JEE.

À propos du service Document Security

Le service Document Security permet aux utilisateurs d’appliquer de manière dynamique des paramètres de confidentialité aux documents Adobe PDF et de contrôler la diffusion des documents, quelle que soit leur taille.

Le service Document Security empêche la diffusion des informations au-delà de la portée de l’utilisateur en permettant aux utilisateurs de garder un contrôle sur la manière dont les destinataires utilisent le document PDF protégé par une stratégie. Un utilisateur peut spécifier qui peut ouvrir un document, limiter son utilisation et contrôler le document après sa distribution. Un utilisateur peut également contrôler de manière dynamique l’accès à un document protégé par une stratégie et même révoquer dynamiquement l’accès au document.

Le service Document Security protège également d’autres types de fichiers tels que les fichiers Microsoft Word (DOC). Vous pouvez utiliser l’API Client de Document Security pour utiliser ces types de fichiers. Les versions suivantes sont prises en charge :

  • Fichiers Microsoft Office 2003 (DOC, XLS, fichiers PPT)
  • Fichiers Microsoft Office 2007 (fichiers DOCX, XLSX, PPTX)
  • Fichiers PTC Pro/E

Pour plus de clarté, les deux sections suivantes expliquent comment utiliser les documents Word :

Vous pouvez accomplir ces tâches à l’aide du service Document Security :

REMARQUE

Pour plus d’informations sur le service Document Security, voir Référence des services pour AEM Forms.

Création de stratégies

Vous pouvez créer des stratégies par programmation à l’aide de l’API Java Document Security ou de l’API de service Web. Une stratégie est un ensemble d’informations qui comprend les paramètres de Document Security, les utilisateurs autorisés et les droits d’utilisation. Vous pouvez créer et enregistrer un nombre indéfini de stratégies à l’aide des paramètres de sécurité appropriés pour différents utilisateurs et situations.

Les stratégies vous permettent d’effectuer les tâches suivantes :

  • Indiquez les personnes qui peuvent ouvrir le document. Les destinataires peuvent appartenir à votre organisation ou être externes à celle-ci.
  • Indiquez comment les destinataires peuvent utiliser le document. Vous pouvez restreindre l’accès à différentes fonctionnalités d’Acrobat et d’Adobe Reader. Ces fonctionnalités permettent d’imprimer et de copier du texte, d’ajouter des signatures et d’ajouter des commentaires à un document.
  • Modifiez à tout moment les paramètres d’accès et de sécurité, même après la distribution du document protégé par une stratégie.
  • Surveillez l’utilisation du document après sa distribution. Vous pouvez voir comment le document est utilisé et qui l’utilise. Par exemple, vous pouvez savoir quand quelqu’un a ouvert le document.

Création d’une stratégie à l’aide des services web

Lors de la création d’une stratégie à l’aide de l’API de service Web, référencez un fichier XML PDRL (Portable Document Rights Language) existant qui décrit la stratégie. Les autorisations de stratégie et l’entité principale sont définies dans le document PDRL. Le document XML suivant est un exemple de document PDRL.

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Policy PolicyInstanceVersion="1" PolicyID="5DA3F847-DE76-F9CC-63EA-49A8D59154DE" PolicyCreationTime="2004-08-30T00:02:28.294+00:00" PolicyType="1" PolicySchemaVersion="1.0" PolicyName="SDK Test Policy -4344050357301573237" PolicyDescription="An SDK Test policy" xmlns="https://www.adobe.com/schema/1.0/pdrl">
       <PolicyEntry>
          <ns1:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns1="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns2:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns2="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns3:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns3="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns4:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns4="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
          <Principal PrincipalNameType="SYSTEM">
             <PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
 
             <PrincipalName>all_internal_users</PrincipalName>
          </Principal>
       </PolicyEntry>
       <PolicyEntry>
          <ns5:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns5="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns6:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns6="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns7:Permission PermissionName="com.adobe.aps.pdf.copy" Access="ALLOW" xmlns:ns7="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns8:Permission PermissionName="com.adobe.aps.pdf.printLow" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns8="https://www.adobe.com/schema/1.0/pdrl" />
 
          <ns9:Permission PermissionName="com.adobe.aps.policySwitch" Access="ALLOW" xmlns:ns9="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns10:Permission PermissionName="com.adobe.aps.revoke" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns10="https://www.adobe.com/schema/1.0/pdrl" />
 
          <ns11:Permission PermissionName="com.adobe.aps.pdf.edit" Access="ALLOW" xmlns:ns11="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns12:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns12="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns13:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns13="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns14:Permission PermissionName="com.adobe.aps.pdf.printHigh" Access="ALLOW" xmlns:ns14="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <Principal PrincipalNameType="SYSTEM">
             <PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
 
             <PrincipalName>publisher</PrincipalName>
          </Principal>
       </PolicyEntry>
 
       <OfflineLeasePeriod>
          <Duration>P31D</Duration>
       </OfflineLeasePeriod>
 
       <AuditSettings isTracked="true" />
 
       <PolicyValidityPeriod isAbsoluteTime="false">
          <ValidityPeriodRelative>
             <NotBeforeRelative>PT0S</NotBeforeRelative>
 
             <NotAfterRelative>P20D</NotAfterRelative>
          </ValidityPeriodRelative>
       </PolicyValidityPeriod>
 </Policy>
 
REMARQUE

Pour plus d’informations sur le service Document Security, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour créer une stratégie, procédez comme suit :

  1. Inclure les fichiers de projet.
  2. Créez un objet API Client Document Security.
  3. Définissez les attributs de la stratégie.
  4. Créez une entrée de stratégie.
  5. Enregistrez la stratégie.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, veillez à inclure les fichiers proxy.

Les fichiers JAR suivants doivent être ajoutés au chemin d’accès aux classes de votre projet :

  • adobe-rightsmanagement-client.jar
  • namespace.jar (si AEM Forms est déployé sur JBoss)
  • jaxb-api.jar (si AEM Forms est déployé sur JBoss)
  • jaxb-impl.jar (si AEM Forms est déployé sur JBoss)
  • jaxb-libs.jar (si AEM Forms est déployé sur JBoss)
  • jaxb-xjc.jar (si AEM Forms est déployé sur JBoss)
  • relaxngDatatype.jar (si AEM Forms est déployé sur JBoss)
  • xsdlib.jar (si AEM Forms est déployé sur JBoss)
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar
  • jbossall-client.jar (utilisez un fichier JAR différent si AEM Forms n’est pas déployé sur JBoss)

Pour plus d’informations sur l’emplacement de ces fichiers JAR, voir Inclusion des fichiers de bibliothèque Java AEM Forms.

Création d’un objet API client Document Security

Avant d’effectuer par programmation une opération de service Document Security, créez un objet client de service Document Security.

Définition des attributs de la stratégie

Pour créer une stratégie, définissez des attributs de stratégie. Un attribut obligatoire est le nom de la stratégie. Les noms des stratégies doivent être uniques pour chaque jeu de stratégies. Un jeu de stratégies est simplement un ensemble de stratégies. Deux stratégies peuvent porter le même nom si elles appartiennent à des jeux de stratégies distincts. Toutefois, deux stratégies d’un seul jeu ne peuvent pas avoir le même nom de stratégie.

La période de validité est un autre attribut utile à définir. Une période de validité est la période pendant laquelle un document protégé par une stratégie est accessible aux destinataires autorisés. Si vous ne définissez pas cet attribut, la stratégie est toujours valide.

Une période de validité peut être définie sur l’une des options suivantes :

  • Nombre défini de jours pendant lesquels le document est accessible à partir de l’heure de publication du document.
  • Date de fin à laquelle le document n’est pas accessible
  • Une période spécifique pour laquelle le document est accessible
  • Toujours valide

Vous pouvez spécifier uniquement une date de début, ce qui entraîne la validité de la stratégie après la date de début. Si vous indiquez uniquement une date de fin, la stratégie est valide jusqu’à la date de fin. Cependant, une exception est générée si aucune date de début et date de fin n’est définie.

Lors de la définition d’attributs appartenant à une stratégie, vous pouvez également définir des paramètres de chiffrement. Ces paramètres de chiffrement prennent effet lorsque la stratégie est appliquée à un document. Vous pouvez spécifier les valeurs de chiffrement suivantes :

  • AES256 : Représente l’algorithme de chiffrement AES avec une clé de 256 bits.
  • AES128 : Représente l’algorithme de chiffrement AES avec une clé de 128 bits.
  • NoEncryption : ne représente aucun chiffrement.

Lors de la spécification de l’option NoEncryption, vous ne pouvez pas définir l’option PlaintextMetadata sur false. Si vous tentez de le faire, une exception est générée.

REMARQUE

Pour plus d’informations sur les autres attributs que vous pouvez définir, voir la description de l’interface Policy dans la Référence de l’API AEM Forms.

Création d’une entrée de stratégie

Une entrée de stratégie associe des entités, qui sont des groupes et des utilisateurs, ainsi que des autorisations à une stratégie. Une stratégie doit comporter au moins une entrée de stratégie. Supposons, par exemple, que vous effectuiez les tâches suivantes :

  • Créez et enregistrez une entrée de stratégie qui permet à un groupe d’afficher uniquement un document en ligne et interdit aux destinataires de le copier.
  • Associez l’entrée de stratégie à la stratégie.
  • Sécurisez un document avec la stratégie à l’aide d’Acrobat.

Grâce à ces actions, les destinataires ne peuvent afficher que le document en ligne et ne peuvent pas le copier. Le document reste sécurisé jusqu’à ce que la sécurité soit supprimée.

Enregistrement de la stratégie

Une nouvelle stratégie doit être enregistrée avant de pouvoir être utilisée. Après avoir enregistré une stratégie, vous pouvez l’utiliser pour protéger les documents.

Créez une stratégie à l’aide de l’API Java

Créez une stratégie à l’aide de l’API Document Security (Java) :

  1. Inclure les fichiers de projet.

    Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.

  2. 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.
  3. Définissez les attributs de la stratégie.

    • Créez un objet 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 méthode setName de l’objet Policy et en transmettant une valeur string qui spécifie le nom de la stratégie.
    • Définissez la description de la stratégie en appelant la méthode Policy de l’objet setDescription et en transmettant une valeur string qui spécifie la description de la stratégie.
    • Définissez le jeu de stratégies auquel appartient la nouvelle stratégie en appelant la méthode setPolicySetName de l’objet Policy et en transmettant une valeur string qui spécifie le nom du jeu de stratégies. (Vous pouvez spécifier null pour cette valeur de paramètre, ce qui entraîne l’ajout de la stratégie au jeu de stratégies Mes stratégies.)
    • Créez la période de validité de la stratégie en appelant la méthode 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 méthode ValidityPeriod de l’objet setRelativeExpirationDays et en transmettant 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 méthode setValidityPeriod de l’objet Policy et en transmettant l’objet ValidityPeriod.
  4. Créez une entrée de stratégie.

    • 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 méthode 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 stratégie, 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 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 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 l’entité. 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 setPrincipal de l’objet PolicyEntry et en transmettant l’objet Principal.
    • Ajoutez l’entrée de stratégie à la stratégie en appelant la méthode addPolicyEntry de l’objet Policy et en transmettant l’objet PolicyEntry.
  5. Enregistrez la stratégie.

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

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

      • Objet Policy représentant la stratégie à enregistrer.
    • Une valeur string qui représente le jeu de stratégies auquel appartient la stratégie.

    Si vous utilisez un compte administrateur d’AEM forms dans les paramètres de connexion pour créer l’objet DocumentSecurityClient, indiquez le nom du jeu de stratégies lorsque vous appelez la méthode registerPolicy . Si vous transmettez une valeur null pour le jeu de stratégies, la stratégie est créée dans le jeu de stratégies Mes stratégies des administrateurs.

    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 stratégie. En d’autres termes, vous n’avez pas besoin de spécifier le nom du jeu de stratégies. Cependant, la stratégie est ajoutée au jeu de stratégies nommé Mes stratégies. Si vous ne souhaitez pas ajouter la nouvelle stratégie à ce jeu de stratégies, spécifiez un nom de jeu de stratégies lorsque vous appelez la méthode registerPolicy.

    REMARQUE

    Lors de la création d’une stratégie, référencez un jeu de stratégies existant. Si vous spécifiez un jeu de stratégies qui n’existe pas, une exception est générée.

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux sections suivantes :

  • "Démarrage rapide (mode SOAP) : Création d’une stratégie à l’aide de l’API Java"

Créez une stratégie à l’aide de l’API de service Web

Créez une stratégie à l’aide de l’API Document Security (service Web) :

  1. Inclure les fichiers de projet.

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Créez un objet API Client Document Security.

    • Créez un objet DocumentSecurityServiceClient à l’aide de son constructeur par défaut.

    • Créez un objet DocumentSecurityServiceClient.Endpoint.Address à l’aide du 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.

  3. 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 membre de données name de l’objet PolicySpec.
    • Définissez la description de la stratégie en attribuant une valeur de chaîne au membre de données description de l’objet PolicySpec.
    • Définissez le jeu de stratégies auquel la stratégie doit appartenir en attribuant une valeur string au membre de données policySetName de l’objet PolicySpec. Vous devez spécifier un nom de jeu de stratégies existant. (Vous pouvez spécifier null pour cette valeur de paramètre, ce qui entraîne l’ajout de la stratégie à Mes stratégies.)
    • Définissez la période d’ouverture hors connexion de la stratégie en attribuant 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 string qui représente les données XML PDRL. Pour effectuer cette tâche, créez un objet .NET StreamReader à l’aide de son constructeur. Transmettez l’emplacement d’un fichier XML PDRL qui représente la stratégie au constructeur StreamReader. Ensuite, appelez la méthode ReadLine de l’objet StreamReader et affectez la valeur renvoyée à une variable string . Effectuez une itération sur l’objet StreamReader jusqu’à ce que la méthode ReadLine renvoie null. Affectez la variable string au membre de données policyXml de l’objet PolicySpec.
  4. Créez une entrée de stratégie.

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

  5. Enregistrez la stratégie.

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

    • Objet PolicySpec représentant la stratégie à enregistrer.
    • Une valeur string qui représente le jeu de stratégies auquel appartient la stratégie. Vous pouvez spécifier une valeur null qui entraîne l’ajout de la stratégie au jeu de stratégies MyPolicy.

    Si vous utilisez un compte administrateur d’AEM forms dans les paramètres de connexion pour créer l’objet DocumentSecurityClient, indiquez le nom du jeu de stratégies lorsque vous appelez la méthode registerPolicy .

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

    REMARQUE

    Lors de la création d’une stratégie et de la définition d’un jeu de stratégies, assurez-vous de spécifier un jeu de stratégies existant. Si vous spécifiez un jeu de stratégies qui n’existe pas, une exception est générée.

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (MTOM) : Création d’une stratégie à l’aide de l’API de service Web"
  • "Démarrage rapide (SwaRef) : Création d’une stratégie à l’aide de l’API de service Web"

Modification de stratégies

Vous pouvez modifier une stratégie existante à l’aide de l’API Java Document Security ou de l’API de service Web. Pour apporter des modifications à une stratégie existante, vous devez la récupérer, la modifier, puis la mettre à jour sur le serveur. Supposons, par exemple, que vous récupériez une stratégie existante et que vous étendiez sa période de validité. Avant que la modification ne prenne effet, vous devez mettre à jour la stratégie.

Vous pouvez modifier une stratégie lorsque les besoins de l’entreprise changent et que la stratégie ne reflète plus ces besoins. Au lieu de créer une nouvelle stratégie, vous pouvez simplement mettre à jour une stratégie existante.

Pour modifier les attributs de stratégie à l’aide d’un service Web (par exemple, à l’aide de classes proxy Java créées avec JAX-WS), vous devez vous assurer que la stratégie est enregistrée auprès du service Document Security. Vous pouvez ensuite référencer la stratégie existante à l’aide de la méthode PolicySpec.getPolicyXml et modifier les attributs de la stratégie à l’aide des méthodes applicables. Par exemple, vous pouvez modifier la période d’ouverture hors connexion en appelant la méthode PolicySpec.setOfflineLeasePeriod.

REMARQUE

Pour plus d’informations sur le service Document Security, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour modifier une stratégie existante, procédez comme suit :

  1. Inclure les fichiers de projet.
  2. Créez un objet API Client Document Security.
  3. Récupérez une stratégie existante.
  4. Modification des attributs de stratégie.
  5. Mettez à jour la stratégie.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, veillez à inclure les fichiers proxy.

Création d’un objet API client Document Security

Avant d’effectuer une opération de service Document Security par programmation, vous devez créer un objet client de service Document Security. Si vous utilisez l’API Java, créez un objet RightsManagementClient . Si vous utilisez l’API du service Web Document Security, créez un objet RightsManagementServiceService.

Récupération d’une stratégie existante

Vous devez récupérer une stratégie existante pour la modifier. Pour récupérer une stratégie, spécifiez le nom de la stratégie et le jeu de stratégies auquel appartient la stratégie. Si vous spécifiez une valeur null pour le nom du jeu de stratégies, la stratégie est récupérée à partir du jeu de stratégies Mes stratégies.

Définition des attributs de la stratégie

Pour modifier une stratégie, vous modifiez la valeur des attributs de stratégie. Le seul attribut de stratégie que vous ne pouvez pas modifier est l’attribut name. Par exemple, pour modifier la période d’ouverture hors connexion de la stratégie, vous pouvez modifier la valeur de l’attribut de période d’ouverture hors connexion de la stratégie.

Lors de la modification de la période d’ouverture hors connexion d’une stratégie à l’aide d’un service Web, le champ offlineLeasePeriod de l’interface PolicySpec est ignoré. Pour mettre à jour la période d’ouverture hors connexion, modifiez l’élément OfflineLeasePeriod dans le document XML PDRL. Référencez ensuite le document XML PDRL mis à jour à l’aide du PolicySpec membre de données de l’interface policyXML.

REMARQUE

Pour plus d’informations sur les autres attributs que vous pouvez définir, voir la description de l’interface Policy dans la Référence de l’API AEM Forms.

Mise à jour de la stratégie

Avant que les modifications apportées à une stratégie ne prennent effet, vous devez mettre à jour la stratégie avec le service Document Security. Les modifications apportées aux stratégies qui protègent des documents sont mises à jour la prochaine fois que le document protégé par une stratégie sera synchronisé avec le service Document Security.

Modification des stratégies existantes à l’aide de l’API Java

Modifiez une stratégie existante à l’aide de l’API Document Security (Java) :

  1. Inclure les fichiers de projet.

    Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.

  2. 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.
  3. Récupérez une stratégie 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 stratégie à mettre à jour en appelant la méthode getPolicy de l’objet PolicyManager et en transmettant les valeurs suivantes."

      • Une valeur string qui représente le nom du jeu de stratégies auquel appartient la stratégie. Vous pouvez spécifier null pour que le jeu de stratégies MyPolicies soit utilisé.
      • Une valeur string qui représente le nom de la stratégie.
  4. 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 méthode Policy de l’objet setOfflineLeasePeriod .

  5. Mettez à jour la stratégie.

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

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous à la section Démarrage rapide (mode SOAP) : Modification d’une stratégie à l’aide de la section API Java .

Modifier des stratégies existantes à l’aide de l’API de service Web

Modifiez une stratégie existante à l’aide de l’API Document Security (service Web) :

  1. Inclure les fichiers de projet.

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Créez un objet API Client Document Security.

    • Créez un objet RightsManagementServiceClient à l’aide de son constructeur par défaut.

    • Créez un objet RightsManagementServiceClient.Endpoint.Address à l’aide du 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.

  3. Récupérez une stratégie existante.

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

    • Une valeur string qui spécifie le nom du jeu de stratégies auquel appartient la stratégie. Vous pouvez spécifier null pour que le jeu de stratégies MyPolicies soit utilisé.
    • Une valeur string qui spécifie le nom de la stratégie.
  4. Définissez les attributs de la stratégie.

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

  5. Mettez à jour la stratégie.

    Mettez à jour la stratégie en appelant la méthode RightsManagementServiceClient de l’objet updatePolicyFromSDK et en transmettant l’objet PolicySpec représentant la stratégie à mettre à jour.

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (MTOM) : Modification d’une stratégie à l’aide de l’API de service Web"
  • "Démarrage rapide (SwaRef) : Modification d’une stratégie à l’aide de l’API de service Web"

Suppression de stratégies

Vous pouvez supprimer une stratégie existante à l’aide de l’API Java Document Security ou de l’API de service Web. Une fois une stratégie supprimée, elle ne peut plus être utilisée pour protéger les documents. Toutefois, les documents existants protégés par une stratégie qui utilisent la stratégie sont toujours protégés. Vous pouvez supprimer une stratégie lorsqu’une nouvelle stratégie est disponible.

REMARQUE

Pour plus d’informations sur le service Document Security, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour supprimer une stratégie existante, procédez comme suit :

  1. Inclure les fichiers de projet
  2. Créez un objet API Client Document Security.
  3. Supprimez la stratégie.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, veillez à inclure les fichiers proxy.

Création d’un objet API client Document Security

Avant d’effectuer par programmation une opération de service Document Security, vous devez créer un objet client de service Document Security. Si vous utilisez l’API Java, créez un objet RightsManagementClient . Si vous utilisez l’API du service Web Document Security, créez un objet RightsManagementServiceService.

Suppression de la stratégie

Pour supprimer une stratégie, vous spécifiez la stratégie à supprimer et le jeu de stratégies auquel appartient la stratégie. L’utilisateur dont les paramètres sont utilisés pour appeler AEM Forms doit disposer des autorisations nécessaires pour supprimer la stratégie ; dans le cas contraire, une exception se produit. De même, si vous tentez de supprimer une stratégie qui n’existe pas, une exception se produit.

Supprimer des stratégies à l’aide de l’API Java

Supprimez une stratégie à l’aide de l’API Document Security (Java) :

  1. Inclure les fichiers de projet.

    Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.

  2. 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.
  3. Supprimez la stratégie.

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

    • Supprimez la stratégie en appelant la méthode deletePolicy de l’objet PolicyManager et en transmettant les valeurs suivantes :

      • Une valeur string qui spécifie le nom du jeu de stratégies auquel appartient la stratégie. Vous pouvez spécifier null pour que le jeu de stratégies MyPolicies soit utilisé.
      • Une valeur string qui spécifie le nom de la stratégie à supprimer.

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (mode SOAP) : Suppression d’une stratégie à l’aide de l’API Java"

Supprimer des stratégies à l’aide de l’API de service Web

Supprimez une stratégie à l’aide de l’API Document Security (service Web) :

  1. Inclure les fichiers de projet.

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Créez un objet API Client Document Security.

    • Créez un objet RightsManagementServiceClient à l’aide de son constructeur par défaut.

    • Créez un objet RightsManagementServiceClient.Endpoint.Address à l’aide du 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.

  3. Supprimez la stratégie.

    Supprimez une stratégie en appelant la méthode deletePolicy de l’objet RightsManagementServiceClient et en transmettant les valeurs suivantes :

    • Une valeur string qui spécifie le nom du jeu de stratégies auquel appartient la stratégie. Vous pouvez spécifier null pour que le jeu de stratégies MyPolicies soit utilisé.
    • Une valeur string qui spécifie le nom de la stratégie à supprimer.

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (MTOM) : Suppression d’une stratégie à l’aide de l’API de service Web"
  • "Démarrage rapide (SwaRef) : Suppression d’une stratégie à l’aide de l’API de service Web"

Application de stratégies à des documents PDF

Vous pouvez appliquer une stratégie à un document PDF afin de protéger le document. En appliquant une stratégie à un document PDF, vous limitez l’accès au document. Vous ne pouvez pas appliquer de stratégie à un document si celui-ci est déjà protégé par une stratégie.

Lorsque le document est ouvert, vous pouvez également restreindre l’accès aux fonctionnalités d’Acrobat et d’Adobe Reader, notamment la possibilité d’imprimer et de copier du texte, d’apporter des modifications et d’ajouter des signatures et des commentaires à un document. En outre, vous pouvez révoquer un document PDF protégé par une stratégie lorsque vous ne souhaitez plus que les utilisateurs accèdent au document.

Vous pouvez contrôler l’utilisation d’un document protégé par une stratégie après sa distribution. C’est-à-dire, vous pouvez voir comment le document est utilisé et qui l’utilise. Par exemple, vous pouvez savoir quand un utilisateur a ouvert le document.

REMARQUE

Pour plus d’informations sur le service Document Security, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour appliquer une stratégie à un document PDF, procédez comme suit :

  1. Inclure les fichiers de projet.
  2. Créez un objet API Client Document Security.
  3. Récupérez un document PDF auquel une stratégie est appliquée.
  4. Appliquez une stratégie existante au document PDF.
  5. Enregistrez le document PDF protégé par une stratégie.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, veillez à inclure les fichiers proxy.

Création d’un objet API client Document Security

Avant d’effectuer par programmation une opération de service Document Security, créez un objet client de service Document Security. Si vous utilisez l’API Java, créez un objet DocumentSecurityClient . Si vous utilisez l’API du service Web Document Security, créez un objet DocumentSecurityServiceService.

Récupération d’un document PDF

Vous pouvez récupérer un document PDF pour appliquer une stratégie. Une fois que vous avez appliqué une stratégie au document PDF, les utilisateurs sont restreints lors de l’utilisation du document. Par exemple, si la stratégie ne permet pas l’ouverture du document hors ligne, les utilisateurs doivent être en ligne pour ouvrir le document.

Application d’une stratégie existante au document PDF

Pour appliquer une stratégie à un document PDF, référencez une stratégie existante et indiquez à quel jeu de stratégies elle appartient. L’utilisateur qui définit les propriétés de connexion doit avoir accès à la stratégie spécifiée. Dans le cas contraire, une exception se produit.

Enregistrement du document PDF

Une fois que le service Document Security a appliqué une stratégie à un document PDF, vous pouvez enregistrer le document PDF protégé par une stratégie en tant que fichier PDF.

Voir également

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Révocation de l’accès aux documents

Application d’une stratégie à un document PDF à l’aide de l’API Java

Application d’une stratégie à un document PDF à l’aide de l’API Document Security (Java) :

  1. Inclure les fichiers de projet.

    Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.

  2. 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.
  3. Récupérez un document PDF.

    • Créez un objet java.io.FileInputStream qui représente le document PDF à l’aide de son constructeur. Transmettez une valeur string 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.
  4. Appliquez une stratégie 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 PDF en appelant la méthode protectDocument de l’objet DocumentManager et en transmettant les valeurs suivantes :

      • Objet com.adobe.idp.Document contenant le document PDF auquel la stratégie est appliquée.
      • Une valeur string qui spécifie le nom du document.
      • Une valeur string qui spécifie le nom du jeu de stratégies auquel appartient la stratégie. Vous pouvez spécifier une valeur null qui entraîne l’utilisation du jeu de stratégies MyPolicies.
      • Une valeur string qui spécifie le nom de la stratégie.
      • Une valeur string qui représente 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 nulle (si ce paramètre est nul, la valeur de paramètre suivante doit être nulle).
      • Une valeur string qui représente le nom canonique de l’utilisateur du gestionnaire de l’utilisateur qui est l’éditeur du document. Cette valeur de paramètre est facultative et peut être null (si ce paramètre est nul, 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 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 stratégie.

  5. Enregistrez le document PDF.

    • Appelez la méthode getProtectedDoc de l’objet RMSecureDocumentResult pour obtenir le document 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 assurez-vous que l’extension de fichier est PDF.
    • Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour copier le contenu de l’objet Document dans le fichier (veillez à utiliser l’objet Document renvoyé par la méthode getProtectedDoc ).

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (mode EJB) : Application d’une stratégie à un document PDF à l’aide de l’API Java"
  • "Démarrage rapide (mode SOAP) : Application d’une stratégie à un document PDF à l’aide de l’API Java"

Voir également

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Application d’une stratégie à un document PDF à l’aide de l’API de service Web

Application d’une stratégie à un document PDF à l’aide de l’API Document Security (service Web) :

  1. Inclure les fichiers de projet.

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Créez un objet API Client Document Security.

    • Créez un objet RightsManagementServiceClient à l’aide de son constructeur par défaut.

    • Créez un objet RightsManagementServiceClient.Endpoint.Address à l’aide du constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string qui spécifie le WSDL au service 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.

  3. Récupérez un document PDF.

    • Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker un document PDF auquel une stratégie est appliquée.
    • Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier 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. Déterminez la taille du tableau d’octets en obtenant la propriété System.IO.FileStream de l’objet 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 avec le contenu du tableau d’octets.
  4. Appliquez une stratégie existante au document PDF.

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

    • Objet BLOB contenant le document PDF auquel la stratégie est appliquée.
    • Une valeur string qui spécifie le nom du document.
    • Une valeur string qui spécifie le nom du jeu de stratégies auquel appartient la stratégie. Vous pouvez spécifier une valeur null qui entraîne l’utilisation du jeu de stratégies MyPolicies.
    • Une valeur string qui spécifie le nom de la stratégie.
    • Une valeur string qui représente 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 nulle (si ce paramètre est nul, la valeur de paramètre suivante doit être null).
    • Une valeur string qui représente le nom canonique de l’utilisateur du gestionnaire de l’utilisateur qui est l’éditeur du document. Cette valeur de paramètre est facultative et peut être nulle (si ce paramètre est nul, la valeur du paramètre précédent doit être null).
    • Valeur RMLocale qui spécifie la valeur du paramètre régional (par exemple, RMLocale.en).
    • Paramètre de sortie string utilisé pour stocker la valeur de l’identifiant de stratégie.
    • Paramètre de sortie string utilisé pour stocker la valeur d’identifiant protégée par une stratégie.
    • Un paramètre de sortie string 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 stratégie.

  5. Enregistrez le document PDF.

    • Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF protégé par une stratégie.
    • 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 appelant son constructeur et en transmettant l’objet System.IO.FileStream.
    • Ecrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode System.IO.BinaryWriter de l’objet Write et en transmettant le tableau d’octets.

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (MTOM) : Application d’une stratégie à un document PDF à l’aide de l’API de service Web"
  • "Démarrage rapide (SwaRef) : Application d’une stratégie à un document PDF à l’aide de l’API de service Web"

Suppression de stratégies des documents PDF

Vous pouvez supprimer une stratégie d’un document protégé par une stratégie afin de supprimer la protection du document. En d’autres termes, si vous ne souhaitez plus que le document soit protégé par une stratégie. Si vous souhaitez mettre à jour un document protégé par une stratégie avec une nouvelle stratégie, au lieu de supprimer la stratégie et d’ajouter la stratégie mise à jour, il est plus efficace de changer de stratégie.

REMARQUE

Pour plus d’informations sur le service Document Security, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour supprimer une stratégie d’un document PDF protégé par une stratégie, procédez comme suit :

  1. Inclure les fichiers de projet
  2. Créez un objet API Client Document Security.
  3. Récupérez un document PDF protégé par une stratégie.
  4. Supprimez la stratégie du document PDF.
  5. Enregistrez le document PDF non sécurisé.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, veillez à inclure les fichiers proxy.

Création d’un objet API client Document Security

Avant d’effectuer par programmation une opération de service Document Security, créez un objet client de service Document Security.

Récupération d’un document PDF protégé par une stratégie

Vous pouvez récupérer un document PDF protégé par une stratégie pour supprimer une stratégie. Si vous tentez de supprimer une stratégie d’un document PDF qui n’est pas protégé par une stratégie, une exception est générée.

Suppression de la stratégie du document PDF

Vous pouvez supprimer une stratégie d’un document PDF protégé par une stratégie à condition qu’un administrateur soit spécifié dans les paramètres de connexion. Dans le cas contraire, la stratégie utilisée pour protéger un document doit contenir l’autorisation SWITCH_POLICY pour supprimer une stratégie d’un document PDF. En outre, l’utilisateur spécifié dans les paramètres de connexion AEM Forms doit également disposer de cette autorisation. Dans le cas contraire, une exception est générée.

Enregistrement du document PDF non sécurisé

Une fois que le service Document Security a supprimé une stratégie d’un document PDF, vous pouvez enregistrer le document PDF non sécurisé en tant que fichier PDF.

Voir également

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Application de stratégies à des documents PDF

Suppression d’une stratégie d’un document PDF à l’aide de l’API Java

Supprimez une stratégie d’un document PDF protégé par une stratégie à l’aide de l’API Document Security (Java) :

  1. Inclure les fichiers de projet.

    Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.

  2. 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.
  3. Récupérez un document PDF protégé par une stratégie.

    • Créez un objet java.io.FileInputStream qui représente le document PDF protégé par une stratégie en utilisant son constructeur et en transmettant une valeur string 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.
  4. Supprimez la stratégie du document PDF.

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

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

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (mode SOAP) : Suppression d’une stratégie d’un document PDF à l’aide de l’API Java"

Suppression d’une stratégie à l’aide de l’API de service Web

Supprimez une stratégie d’un document PDF protégé par une stratégie à l’aide de l’API Document Security (service Web) :

  1. Inclure les fichiers de projet.

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Créez un objet API Client Document Security.

    • Créez un objet DocumentSecurityServiceClient à l’aide de son constructeur par défaut.

    • Créez un objet DocumentSecurityServiceClient.Endpoint.Address à l’aide du 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.

  3. Récupérez un document PDF protégé par une stratégie.

    • Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker le document PDF protégé par une stratégie à partir duquel la stratégie est supprimée.
    • Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier 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é System.IO.FileStream de l’objet Length.
    • Renseignez le tableau d’octets avec les données de flux en appelant la méthode System.IO.FileStream de l’objet Read 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 avec le contenu du tableau d’octets.
  4. Supprimez la stratégie du document PDF.

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

  5. Enregistrez le document PDF non sécurisé.

    • Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier 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 appelant son constructeur et en transmettant l’objet System.IO.FileStream.

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (MTOM) : Suppression d’une stratégie d’un document PDF à l’aide de l’API de service Web"
  • "Démarrage rapide (SwaRef) : Suppression d’une stratégie d’un document PDF à l’aide de l’API de service Web"

Voir également

Appel d’AEM Forms à l’aide de MTOM

Appel d’AEM Forms à l’aide de SwaRef

Révocation de l’accès aux documents

Vous pouvez révoquer l’accès à un document PDF protégé par une stratégie, ce qui rend toutes les copies du document inaccessibles aux utilisateurs. Lorsqu’un utilisateur tente d’ouvrir un document PDF révoqué, il est redirigé vers une URL spécifiée où un document modifié peut être consulté. L’URL vers laquelle l’utilisateur est redirigé doit être spécifiée par programmation. Lorsque vous révoquez l’accès à un document, la modification prend effet la prochaine fois que l’utilisateur se synchronise avec le service Document Security en ouvrant le document en ligne protégé par une stratégie.

La possibilité de révoquer l’accès à un document offre une sécurité supplémentaire. Supposons, par exemple, qu’une version plus récente d’un document soit disponible et que vous ne souhaitiez plus que quiconque consulte la version obsolète. Dans ce cas, l’accès à l’ancien document peut être révoqué, et personne ne peut afficher le document à moins que l’accès ne soit rétabli.

REMARQUE

Pour plus d’informations sur le service Document Security, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour révoquer un document protégé par une stratégie, procédez comme suit :

  1. Inclure les fichiers de projet.
  2. Créez un objet API Client Document Security.
  3. Récupérez un document PDF protégé par une stratégie.
  4. Révoquez le document protégé par une stratégie.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, veillez à inclure les fichiers proxy.

Création d’un objet API client Document Security

Avant d’effectuer par programmation une opération de service Document Security, vous devez créer un objet client de service Document Security.

Récupération d’un document PDF protégé par une stratégie

Pour pouvoir révoquer un document PDF protégé par une stratégie, vous devez le récupérer. Vous ne pouvez pas révoquer un document qui a déjà été révoqué ou qui n’est pas un document protégé par une stratégie.

Si vous connaissez la valeur d’identifiant de licence du document protégé par une stratégie, il n’est pas nécessaire de récupérer le document PDF protégé par une stratégie. Cependant, dans la plupart des cas, vous devrez récupérer le document PDF pour obtenir la valeur de l’identifiant de licence.

Révocation du document protégé par une stratégie

Pour révoquer un document protégé par une stratégie, spécifiez l’identifiant de licence du document protégé par une stratégie. En outre, vous pouvez spécifier l’URL d’un document que l’utilisateur peut afficher lorsqu’il tente d’ouvrir le document révoqué. En d’autres termes, supposons qu’un document obsolète soit révoqué. Lorsqu’un utilisateur tente d’ouvrir le document révoqué, il voit un document mis à jour au lieu du document révoqué.

REMARQUE

Si vous tentez de révoquer un document déjà révoqué, une exception est générée.

Voir également

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Application de stratégies à des documents PDF

Rétablissement de l’accès aux documents révoqués

Révoquer l’accès aux documents à l’aide de l’API Java

Révoquez l’accès à un document PDF protégé par une stratégie à l’aide de l’API Document Security (Java) :

  1. Inclure les fichiers de projet

    Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.

  2. Création d’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.
  3. Récupération d’un document PDF protégé par une stratégie

    • Créez un objet java.io.FileInputStream qui représente le document PDF protégé par une stratégie en utilisant son constructeur et en transmettant une valeur string 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.
  4. Révocation du document protégé par une stratégie

    • 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 méthode DocumentManager de l’objet getLicenseId . Transmettez l’objet com.adobe.idp.Document représentant le document protégé par une stratégie. 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 méthode revokeLicense de l’objet LicenseManager et en transmettant les 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 méthode DocumentManager de l’objet getLicenseId).
      • Un membre de données statique de l’interface License qui spécifie la raison de la révocation du document. Par exemple, vous pouvez spécifier License.DOCUMENT_REVISED.
      • Valeur java.net.URL qui spécifie 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.

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (mode SOAP) : Révocation d’un document à l’aide de l’API Java"

Révoquer l’accès aux documents à l’aide de l’API de service Web

Révoquez l’accès à un document PDF protégé par une stratégie à l’aide de l’API Document Security (service Web) :

  1. Inclure les fichiers de projet

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Création d’un objet API client Document Security

    • Créez un objet DocumentSecurityServiceClient à l’aide de son constructeur par défaut.

    • Créez un objet DocumentSecurityServiceClient.Endpoint.Address à l’aide du 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.

  3. Récupération d’un document PDF protégé par une stratégie

    • Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker un document PDF protégé par une stratégie qui est révoqué.
    • Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document PDF protégé par une stratégie à 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é System.IO.FileStream de l’objet Length.
    • Renseignez le tableau d’octets avec les données de flux en appelant la méthode System.IO.FileStream de l’objet Read 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 avec le contenu du tableau d’octets.
  4. Révocation du document protégé par une stratégie

    • Récupérez la valeur de l’identifiant de licence du document protégé par une stratégie en appelant la méthode DocumentSecurityServiceClient de l’objet getLicenseID et en transmettant l’objet BLOB représentant le document protégé par une stratégie. Cette méthode renvoie une valeur string qui représente l’identifiant de licence.

    • Révoquez le document protégé par une stratégie en appelant la méthode revokeLicense de l’objet DocumentSecurityServiceClient et en transmettant les 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 méthode DocumentSecurityServiceService de l’objet getLicenseId).
      • Un membre de données statique de l’énumération Reason qui spécifie la raison de la révocation du document. Par exemple, vous pouvez spécifier Reason.DOCUMENT_REVISED.
      • Valeur string qui spécifie 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.

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (MTOM) : Révocation d’un document à l’aide de l’API de service Web"
  • "Démarrage rapide (SwaRef) : Révocation d’un document à l’aide de l’API de service Web"

Voir également

Suppression de stratégies de documents Word

Appel d’AEM Forms à l’aide de MTOM

Appel d’AEM Forms à l’aide de SwaRef

Rétablissement de l’accès aux documents révoqués

Vous pouvez rétablir l’accès à un document PDF révoqué, ce qui rend toutes les copies du document révoqué accessibles aux utilisateurs. Lorsqu’un utilisateur ouvre un document restauré qui a été révoqué, il peut afficher le document.

REMARQUE

Pour plus d’informations sur le service Document Security, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour rétablir l’accès à un document PDF révoqué, procédez comme suit :

  1. Inclure les fichiers de projet.
  2. Créez un objet API Client Document Security.
  3. Récupérez l’identifiant de licence du document PDF révoqué.
  4. Rétablissez l’accès au document PDF révoqué.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, veillez à inclure les fichiers proxy.

Création d’un objet API client Document Security

Avant d’effectuer par programmation une opération de service Document Security, vous devez créer un objet client de service Document Security. Si vous utilisez l’API Java, créez un objet DocumentSecurityClient . Si vous utilisez l’API du service Web Document Security, créez un objet DocumentSecurityServiceService.

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

Vous devez récupérer l’identifiant de licence du document PDF révoqué pour rétablir un document PDF révoqué. Après avoir obtenu la valeur d’identifiant de licence, vous pouvez rétablir un document révoqué. Si vous tentez de rétablir un document qui n’est pas révoqué, vous allez provoquer une exception.

Rétablissement de l’accès au document PDF révoqué

Pour rétablir l’accès à un document PDF révoqué, vous devez spécifier l’identifiant de licence du document révoqué. Si vous tentez de rétablir l’accès à un document PDF qui n’a pas été révoqué, vous provoquerez une exception.

Voir également

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Application de stratégies à des documents PDF

Révocation de l’accès aux documents

Rétablissez l’accès aux documents révoqués à l’aide de l’API Java

Rétablissez l’accès à un document révoqué à l’aide de l’API Document Security (Java) :

  1. Inclure les fichiers de projet.

    Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.

  2. 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.
  3. 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 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.
    • 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 représentant le document révoqué. Cette méthode renvoie une valeur string qui représente l’identifiant de licence.
  4. 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 de l’identifiant de licence du document révoqué.

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (mode SOAP) : Rétablissement de l’accès à un document révoqué à l’aide de l’API de service Web"

Rétablissez l’accès aux documents révoqués à l’aide de l’API de service Web

Rétablissez l’accès à un document révoqué à l’aide de l’API Document Security (service Web) :

  1. Inclure les fichiers de projet.

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Créez un objet API Client Document Security.

    • Créez un objet DocumentSecurityServiceClient à l’aide de son constructeur par défaut.

    • Créez un objet DocumentSecurityServiceClient.Endpoint.Address à l’aide du 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.

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

    • Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker un document PDF révoqué dans lequel 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 fichier 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é System.IO.FileStream de l’objet Length.
    • Renseignez le tableau d’octets avec les données de flux en appelant la méthode System.IO.FileStream de l’objet Read 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 avec le contenu du tableau d’octets.
  4. 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 représentant 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é en appelant la méthode DocumentSecurityServiceClient de l’objet unrevokeLicense et en transmettant une valeur string qui spécifie la valeur d’identifiant de licence du document PDF révoqué (transmettez la valeur renvoyée par la méthode DocumentSecurityServiceClient de l’objet getLicenseId).

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (MTOM) : Rétablissement de l’accès à un document révoqué à l’aide de l’API de service Web"
  • "Démarrage rapide (SwaRef) : Rétablissement de l’accès à un document révoqué à l’aide de l’API de service Web"

Voir également

Appel d’AEM Forms à l’aide de MTOM

Appel d’AEM Forms à l’aide de SwaRef

Inspection des documents PDF protégés par une stratégie

Vous pouvez utiliser l’API Document Security Service (Java et service Web) pour inspecter des documents PDF protégés par une stratégie. L’inspection des documents PDF protégés par une stratégie renvoie des informations sur le document PDF protégé par une stratégie. Vous pouvez, par exemple, déterminer la stratégie utilisée pour protéger le document et la date à laquelle le document a été protégé.

Vous ne pouvez pas effectuer cette tâche si votre version de LiveCycle est 8.x ou une version antérieure. La prise en charge de l’inspection des documents protégés par une stratégie est ajoutée dans AEM Forms. Si vous tentez d’inspecter un document protégé par une stratégie à l’aide de LiveCycle 8.x (ou d’une version antérieure), une exception est générée.

REMARQUE

Pour plus d’informations sur le service Document Security, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour inspecter un document PDF protégé par une stratégie, procédez comme suit :

  1. Inclure les fichiers de projet.
  2. Créez un objet API Client Document Security.
  3. Récupérez un document protégé par une stratégie à inspecter.
  4. Obtention d’informations sur le document protégé par une stratégie.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.

Création d’un objet API client Document Security

Avant d’effectuer par programmation une opération de service Document Security, créez un objet client de service Document Security. Si vous utilisez l’API Java, créez un objet RightsManagementClient . Si vous utilisez l’API du service Web Document Security, créez un objet RightsManagementServiceService.

Récupération d’un document protégé par une stratégie à inspecter

Pour inspecter un document protégé par une stratégie, récupérez-le. Si vous tentez d’inspecter un document non protégé par une stratégie ou révoqué, une exception est générée.

Inspect du document

Après avoir récupéré un document protégé par une stratégie, vous pouvez l’inspecter.

Obtention d’informations sur le document protégé par une stratégie

Après avoir inspecté un document PDF protégé par une stratégie, vous pouvez obtenir des informations à son sujet. Vous pouvez, par exemple, déterminer la stratégie utilisée pour protéger le document.

Si vous sécurisez un document avec une stratégie qui appartient à Mes stratégies, puis que vous appelez RMInspectResult.getPolicysetName ou RMInspectResult.getPolicysetId, la valeur null est renvoyée.

Si le document est sécurisé à l’aide d’une stratégie contenue dans un jeu de stratégies (autre que Mes stratégies), RMInspectResult.getPolicysetName et RMInspectResult.getPolicysetId renvoient des chaînes valides.

Voir également

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Documents PDF protégés par une stratégie Inspect à l’aide de l’API Java

Inspect d’un document PDF protégé par une stratégie à l’aide de l’API Document Security Service (Java) :

  1. Inclure 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.

  2. 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.
  3. Récupérez un document protégé par une stratégie à inspecter.

    • Créez un objet java.io.FileInputStream qui représente le document PDF protégé par une stratégie à l’aide de son constructeur. Transmettez une valeur string 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.
  4. Inspect le document.

    • Créez un objet DocumentManager en appelant la méthode getDocumentManager de l’objet RightsManagementClient.
    • Inspect le document protégé par une stratégie 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 stratégie. Cette méthode renvoie un objet RMInspectResult contenant des informations sur le document protégé par une stratégie.
  5. Obtention d’informations sur le document protégé par une stratégie.

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

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (mode SOAP) : Inspection des documents PDF protégés par une stratégie à l’aide de l’API Java"

Documents PDF protégés par une stratégie Inspect à l’aide de l’API de service Web

Inspect d’un document PDF protégé par une stratégie à l’aide de l’API Document Security Service (service Web) :

  1. Inclure les fichiers de projet.

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Créez un objet API Client Document Security.

    • Créez un objet RightsManagementServiceClient à l’aide de son constructeur par défaut.

    • Créez un objet RightsManagementServiceClient.Endpoint.Address à l’aide du 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.

  3. Récupérez un document protégé par une stratégie à inspecter.

    • Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker un document PDF à inspecter.
    • Créez un objet System.IO.FileStream en appelant son constructeur. Transmettez une valeur string qui représente l’emplacement du fichier 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é System.IO.FileStream de l’objet 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 avec le contenu du tableau d’octets.
  4. Inspect le document.

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

  5. Obtention d’informations sur le document protégé par une stratégie.

    Pour obtenir des informations sur le document protégé par une stratégie, 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 du champ policyName de l’objet RMInspectResult .

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (MTOM) : Inspection des documents PDF protégés par une stratégie à l’aide de l’API de service Web"
  • "Démarrage rapide (SwaRef) : Inspection des documents PDF protégés par une stratégie à l’aide de l’API de service Web"

Voir également

Appel d’AEM Forms à l’aide de MTOM

Appel d’AEM Forms à l’aide de SwaRef

Création de filigranes

Les filigranes permettent d’assurer la sécurité d’un document en identifiant de manière unique le document et en contrôlant la violation du droit d’auteur. Par exemple, vous pouvez créer et placer un filigrane qui indique Confidentiel sur toutes les pages d’un document. Une fois un filigrane créé, vous pouvez l’inclure dans une stratégie. En d’autres termes, vous pouvez définir l’attribut de filigrane de la stratégie avec le nouveau filigrane. Une fois qu’une stratégie contenant un filigrane est appliquée à un document, le filigrane apparaît dans le document protégé par une stratégie.

REMARQUE

Seuls les utilisateurs disposant de droits d’administrateur Document Security peuvent créer des filigranes. En d’autres termes, vous devez spécifier cet utilisateur lors de la définition des paramètres de connexion requis pour créer un objet client de service Document Security.

REMARQUE

Pour plus d’informations sur le service Document Security, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour créer un filigrane, procédez comme suit :

  1. Inclure les fichiers de projet.
  2. Créez un objet API Client Document Security.
  3. Définissez les attributs des filigranes.
  4. Enregistrez le filigrane avec le service Document Security.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, veillez à inclure les fichiers proxy.

Création d’un objet API client Document Security

Avant d’effectuer par programmation une opération de service Document Security, vous devez créer un objet client de service Document Security. Si vous utilisez l’API Java, créez un objet RightsManagementClient . Si vous utilisez l’API du service Web Document Security, créez un objet RightsManagementServiceService.

Définition des attributs de filigranes

Pour créer un filigrane, vous devez définir les attributs du filigrane. L’attribut name doit toujours être défini. Outre l’attribut name , vous devez définir au moins l’un des attributs suivants :

  • Texte personnalisé
  • DateIncluded
  • UserIdIncluded
  • UserNameIncluded

Le tableau suivant répertorie les paires clé-valeur requises lors de la création d’un filigrane à l’aide des services Web.

Nom de la clé

Description

Valeur

WaterBackCmd:IS_USERNAME_ENABLED

Indique si le nom d’utilisateur de l’utilisateur qui ouvre le document fait partie du filigrane.

True ou false

WaterBackCmd:IS_USERID_ENABLED

Indique si l’identification de l’utilisateur ouvrant le document fait partie du filigrane.

True ou false

WaterBackCmd:IS_CURRENTDATE_ENABLED

Indique si la date actuelle fait partie du filigrane.

True ou false

WaterBackCmd:IS_CUSTOMTEXT_ENABLED

Si cette valeur est définie sur true, la valeur du texte personnalisé doit être spécifiée à l’aide de WaterBackCmd:SRCTEXT.

True ou false

WaterBackCmd:OPACITY

Indique l’opacité du filigrane. La valeur par défaut est 0,5 si elle n’est pas spécifiée.

Valeur comprise entre 0,0 et 1,0.

WaterBackCmd:ROTATION

Indique la rotation du filigrane. La valeur par défaut est 0 degré.

Valeur comprise entre 0 et 359.

WaterBackCmd:SCALE

Si cette valeur est spécifiée, WaterBackCmd:IS_SIZE_ENABLED doit être présent et la valeur doit être true. Si cet attribut n’est pas spécifié, le comportement par défaut est adapté à la page.

Valeur supérieure à 0.0 et inférieure ou égale à 1.0.

WaterBackCmd:HORIZ_ALIGN

Indique l’alignement horizontal du filigrane. La valeur par défaut est center.

gauche, centre ou droite

WaterBackCmd:VERT_ALIGN

Indique l’alignement vertical du filigrane. La valeur par défaut est center.

haut, centre ou bas

WaterBackCmd:IS_USE_BACKGROUND

Indique si le filigrane est en arrière-plan. La valeur par défaut est false.

True ou false

WaterBackCmd:IS_SIZE_ENABLED

True si une échelle personnalisée est spécifiée. Si cette valeur est définie sur true, SCALE doit également être spécifié. Si cette valeur est définie sur false, la valeur par défaut est adaptée à la page.

True ou false

WaterBackCmd:SRCTEXT

Indique le texte personnalisé d’un filigrane. Si cette valeur est présente, WaterBackCmd:IS_CUSTOMTEXT_ENABLED doit également être présent et défini sur true.

True ou false

L’un des attributs suivants doit être défini pour tous les filigranes :

  • WaterBackCmd:IS_USERNAME_ENABLED
  • WaterBackCmd:IS_USERID_ENABLED
  • WaterBackCmd:IS_CURRENTDATE_ENABLED
  • WaterBackCmd:IS_CUSTOMTEXT_ENABLED

Tous les autres attributs sont facultatifs.

Enregistrement du filigrane

Un nouveau filigrane doit être enregistré auprès du service Document Security pour pouvoir être utilisé. Après avoir enregistré un filigrane, vous pouvez l’utiliser dans les stratégies.

Voir également

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Application de stratégies à des documents PDF

Création de filigranes à l’aide de l’API Java

Créez un filigrane à l’aide de l’API Document Security (Java) :

  1. Inclure les fichiers de projet.

    Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.

  2. 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.
  3. Définition des attributs de filigrane

    • Créez un objet 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 méthode setName de l’objet Watermark et en transmettant 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 méthode setBackground de l’objet Watermark et en transmettant true. En définissant cet attribut, le filigrane apparaît en 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 string qui représente 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 indique que le filigrane est complètement transparent.
  4. 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 représentant le filigrane à enregistrer. Cette méthode renvoie une valeur string qui représente la valeur d’identification du filigrane.

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (mode SOAP) : Création d’un filigrane à l’aide de l’API Java"

Créer des filigranes à l’aide de l’API de service Web

Créez un filigrane à l’aide de l’API Document Security (service Web) :

  1. Créez un objet API Client Document Security.

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Créez un objet API Client Document Security.

    • Créez un objet RightsManagementServiceClient à l’aide de son constructeur par défaut.

    • Créez un objet RightsManagementServiceClient.Endpoint.Address à l’aide du 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.

  3. 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 WatermarkSpec membre de données name de l’objet.
    • Définissez l’attribut id du filigrane en attribuant une valeur string 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 MyMapOf_xsd_string_To_xsd_anyType_Item membre de données value de l’objet (par exemple, .25).
    • Créez un objet MyArrayOf_xsd_anyType . Pour chaque objet MyMapOf_xsd_string_To_xsd_anyType_Item, appelez la méthode MyArrayOf_xsd_anyType de l’objet Add. Transmettez l’objet MyMapOf_xsd_string_To_xsd_anyType_Item .
    • Affectez l’objet MyArrayOf_xsd_anyType au membre de données values de l’objet WatermarkSpec.
  4. 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.

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (MTOM) : Création d’un filigrane à l’aide de l’API de service Web"
  • "Démarrage rapide (SwaRef) : Création d’un filigrane à l’aide de l’API de service Web"

Voir également

Appel d’AEM Forms à l’aide de MTOM

Appel d’AEM Forms à l’aide de SwaRef

Modification des filigranes

Vous pouvez modifier un filigrane existant à l’aide de l’API Java Document Security ou de l’API de service Web. Pour apporter des modifications à un filigrane existant, vous devez le récupérer, modifier ses attributs, puis le mettre à jour sur le serveur. Supposons, par exemple, que vous récupériez un filigrane et que vous modifiiez son attribut d’opacité. Avant que la modification ne prenne effet, vous devez mettre à jour le filigrane.

Lorsque vous modifiez un filigrane, la modification a un impact sur les documents futurs auxquels le filigrane est appliqué. En d’autres termes, les documents PDF existants qui contiennent le filigrane ne sont pas affectés.

REMARQUE

Seuls les utilisateurs disposant de droits d’administrateur Document Security peuvent modifier les filigranes. En d’autres termes, vous devez spécifier cet utilisateur lors de la définition des paramètres de connexion requis pour créer un objet client de service Document Security.

REMARQUE

Pour plus d’informations sur le service Document Security, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour modifier un filigrane, procédez comme suit :

  1. Inclure les fichiers de projet.
  2. Créez un objet API Client Document Security.
  3. Récupérez le filigrane à modifier.
  4. Définissez les attributs des filigranes.
  5. Mettez à jour le filigrane.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, veillez à inclure les fichiers proxy.

Création d’un objet API client Document Security

Avant d’effectuer par programmation une opération de service Document Security, vous devez créer un objet client de service Document Security. Si vous utilisez l’API Java, créez un objet DocumentSecurityClient . Si vous utilisez l’API du service Web Document Security, créez un objet DocumentSecurityServiceService.

Récupération du filigrane à modifier

Pour modifier un filigrane, vous devez récupérer un filigrane existant. Vous pouvez récupérer un filigrane en spécifiant son nom ou sa valeur d’identifiant.

Définition des attributs de filigranes

Pour modifier un filigrane existant, modifiez la valeur d’un ou de plusieurs attributs de filigrane. Lors de la mise à jour par programmation d’un filigrane à l’aide d’un service Web, vous devez définir tous les attributs qui ont été définis à l’origine, même si la valeur ne change pas. Supposons, par exemple, que les attributs de filigrane suivants soient définis : WaterBackCmd:IS_USERID_ENABLED, WaterBackCmd:IS_CUSTOMTEXT_ENABLED, WaterBackCmd:OPACITY et WaterBackCmd:SRCTEXT. Bien que le seul attribut que vous souhaitez modifier soit WaterBackCmd:OPACITY, vous devez définir les autres valeurs.

REMARQUE

Lorsque vous utilisez l’API Java pour modifier un filigrane, vous n’avez pas besoin de spécifier tous les attributs. Définissez l’attribut de filigrane à modifier.

REMARQUE

Pour plus d’informations sur les noms d’attributs du filigrane, voir Création de filigranes.

Mise à jour du filigrane

Après avoir modifié les attributs d’un filigrane, vous devez le mettre à jour.

Voir également

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Création de filigranes

Modification des filigranes à l’aide de l’API Java

Modifiez un filigrane à l’aide de l’API Document Security (Java) :

  1. Inclure les fichiers de projet.

    Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.

  2. 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.
  3. Récupérez le filigrane à modifier.

    Créez un objet WatermarkManager en appelant la méthode getWatermarkManager de l’objet DocumentSecurityClient 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.

  4. 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 indique que le filigrane est complètement transparent.

    REMARQUE

    Cet exemple ne modifie que l’attribut opacity.

  5. Mettez à jour le filigrane.

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

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous à la section Démarrage rapide (mode SOAP) : Modification d’un filigrane à l’aide de la section API Java .

Modification des filigranes à l’aide de l’API de service Web

Modifiez un filigrane à l’aide de l’API Document Security (service Web) :

  1. Inclure les fichiers de projet.

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Créez un objet API Client Document Security.

    • Créez un objet DocumentSecurityServiceClient à l’aide de son constructeur par défaut.

    • Créez un objet RightsManagementServiceClient.Endpoint.Address à l’aide du 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.
    • Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

  3. 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.

  4. 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 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 MyMapOf_xsd_string_To_xsd_anyType_Item membre de données value de l’objet (par exemple, .50).
    • Créez un objet MyArrayOf_xsd_anyType . Pour chaque objet MyMapOf_xsd_string_To_xsd_anyType_Item, appelez la méthode MyArrayOf_xsd_anyType de l’objet Add. Transmettez l’objet MyMapOf_xsd_string_To_xsd_anyType_Item .
    • Affectez l’objet MyArrayOf_xsd_anyType au membre de données values de l’objet WatermarkSpec.
  5. Mettez à jour le filigrane.

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

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous au didacticiel de mise en route suivant :

  • "Démarrage rapide (MTOM) : Modification d’un filigrane à l’aide de l’API de service Web"

Recherche d’événements

Le service Rights Management effectue le suivi d’actions spécifiques au fur et à mesure qu’elles se produisent, telles que l’application d’une stratégie à un document, l’ouverture d’un document protégé par une stratégie et la révocation de l’accès aux documents. Le contrôle des événements doit être activé pour le service de Rights Management ou les événements ne sont pas suivis.

Les événements appartiennent à l’une des catégories suivantes :

  • Les événements d’administrateur sont des actions liées à un administrateur, comme la création d’un compte administrateur.
  • Les événements de document sont des actions liées à un document, telles que la fermeture d’un document protégé par une stratégie.
  • Les événements de stratégie sont des actions liées à une stratégie, comme la création d’une stratégie.
  • Les événements de service sont des actions liées au service Rights Management, telles que la synchronisation avec l’annuaire d’utilisateurs.

Vous pouvez rechercher des événements spécifiques à l’aide de l’API Java Rights Management ou de l’API de service Web. En recherchant des événements, vous pouvez effectuer des tâches, comme créer un fichier journal de certains événements.

REMARQUE

Pour plus d’informations sur le service Rights Management, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour rechercher un événement de Rights Management, procédez comme suit :

  1. Inclure les fichiers de projet.
  2. Créez un objet API client Rights Management.
  3. Indiquez l’événement pour lequel effectuer la recherche.
  4. Recherchez l’événement .

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, veillez à inclure les fichiers proxy.

Création d’un objet API client Rights Management

Avant de pouvoir effectuer par programmation une opération de service Rights Management, vous devez créer un objet client de service Rights Management. Si vous utilisez l’API Java, créez un objet DocumentSecurityClient . Si vous utilisez l’API du service Web de Rights Management, créez un objet DocumentSecurityServiceService .

Définition des événements à rechercher

Vous devez spécifier l’événement à rechercher. Vous pouvez, par exemple, rechercher l’événement de création de stratégie qui se produit lors de la création d’une stratégie.

Recherche de l’événement

Après avoir spécifié l’événement à rechercher, vous pouvez utiliser l’API Java du Rights Management ou l’API du service Web du Rights Management pour rechercher l’événement.

Voir également

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Recherchez des événements à l’aide de l’API Java

Recherchez des événements à l’aide de l’API du Rights Management (Java) :

  1. Inclure les fichiers de projet

    Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.

  2. Création d’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.

  3. Définition des é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 appartenant à la classe EventManager qui représente l’événement pour lequel effectuer une recherche. Par exemple, pour rechercher l’événement de création de stratégie, transmettez EventManager.POLICY_CREATE_EVENT.
    REMARQUE

    Vous pouvez définir des critères de recherche supplémentaires en appelant les méthodes d’objet EventSearchFilter. Par exemple, appelez la méthode setUserName pour spécifier un utilisateur associé à l’événement.

  4. Recherche de l’événement

    Recherchez l’événement en appelant la méthode EventManager de l’objet searchForEvents 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.

Exemples de code

Pour obtenir des exemples de code à l’aide du service Rights Management, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (SOAP) : Recherche d’événements à l’aide de l’API Java"

Recherchez des événements à l’aide de l’API de service Web

Recherchez des événements à l’aide de l’API du Rights Management (service Web) :

  1. Inclure les fichiers de projet

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Création d’un objet API client Rights Management

    • Créez un objet DocumentSecurityServiceClient à l’aide de son constructeur par défaut.

    • Créez un objet DocumentSecurityServiceClient.Endpoint.Address à l’aide du 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.

  3. Définition des événements à rechercher

    • Créez un objet EventSpec à l’aide de son constructeur.
    • Indiquez 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 DataTime avec l’instance EventSpec qui représente 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 DataTime avec l’instance EventSpec 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é :

    Type d’événement

    Valeur

    ALL_EVENTS

    999

    USER_CHANGE_PASSWORD_EVENT

    1000

    USER_REGISTER_EVENT

    1001

    USER_PREREGISTER_EVENT

    1002

    USER_ACTIVATE_EVENT

    1003

    USER_DEACTIVATE_EVENT

    1004

    USER_AUTHENTICATE_EVENT

    1005

    USER_AUTHENTICATE_DENY_EVENT

    1006

    USER_ACCOUNT_LOCK_EVENT

    1007

    USER_DELETE_EVENT

    1008

    USER_UPDATE_PROFILE_EVENT

    1009

    DOCUMENT_VIEW_EVENT

    2000

    DOCUMENT_PRINT_LOW_EVENT

    2001

    DOCUMENT_PRINT_HIGH_EVENT

    2002

    DOCUMENT_SIGN_EVENT

    2003

    DOCUMENT_ADD_ANNOTATION_EVENT

    2004

    DOCUMENT_FORM_FILL_EVENT

    2005

    DOCUMENT_CLOSE_EVENT

    2006

    DOCUMENT_MODIFY_EVENT

    2007

    DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT

    2008

    DOCUMENT_SWITCH_POLICY_EVENT

    2009

    DOCUMENT_REVOKE_EVENT

    2010

    $1

    2011

    DOCUMENT_SECURE_EVENT

    2012

    DOCUMENT_UNKNOWN_CLIENT_EVENT

    2013

    DOCUMENT_CHANGE_REVOKE_URL_EVENT

    2014

    POLICY_CHANGE_EVENT

    3000

    POLICY_ENABLE_EVENT

    3001

    POLICY_DISABLE_EVENT

    3002

    POLICY_CREATE_EVENT

    3003

    POLICY_DELETE_EVENT

    3004

    POLICY_CHANGE_OWNER_EVENT

    3005

    SERVER_CLIENT_SYNC_EVENT

    4 000

    SERVER_SYNC_DIR_INFO_EVENT

    4001

    SERVER_SYNC_DIR_COMPLETE_EVENT

    4002

    SERVER_VERSION_MISMATCH_EVENT

    4003

    SERVER_CONFIG_CHANGE_EVENT

    4004

    SERVER_ENABLE_OFFLINE_ACCESS_EVENT

    4005

    ADMIN_ADD_EVENT

    5 000

    ADMIN_DELETE_EVENT

    5001

    ADMIN_EDIT_EVENT

    5002

    ADMIN_ACTIVATE_EVENT

    5003

    ADMIN_DEACTIVATE_EVENT

    5004

    ERROR_DIRECTORY_SERVICE_EVENT

    6 000

    CREATED_POLICYSET_EVENT

    7000

    DELETED_POLICYSET_EVENT

    7001

    MODIFIED_POLICYSET_EVENT

    7002

  4. Recherche de l’événement

    Recherchez l’événement en appelant la méthode DocumentSecurityServiceClient de l’objet searchForEvents et en transmettant l’objet EventSpec qui représente l’événement pour lequel effectuer la 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. À l’aide d’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.

Exemples de code

Pour obtenir des exemples de code à l’aide du service Rights Management, reportez-vous aux didacticiels de mise en route suivants :

  • "Démarrage rapide (MTOM) : Recherche d’événements à l’aide de l’API de service Web"
  • "Démarrage rapide (SwaRef) : Recherche d’événements à l’aide de l’API de service Web"

Voir également

Appel d’AEM Forms à l’aide de MTOM

Appel d’AEM Forms à l’aide de SwaRef

Application de stratégies à des documents Word

Outre les documents PDF, le service Rights Management prend en charge d’autres formats de document, tels qu’un document Microsoft Word (fichier DOC) et d’autres formats de fichier Microsoft Office. Par exemple, vous pouvez appliquer une stratégie à un document Word afin de le protéger. En appliquant une stratégie à un document Word, vous restreignez l’accès au document. Vous ne pouvez pas appliquer de stratégie à un document si celui-ci est déjà protégé par une stratégie.

Vous pouvez surveiller l’utilisation d’un document Word protégé par une stratégie après sa distribution. C’est-à-dire, vous pouvez voir comment le document est utilisé et qui l’utilise. Par exemple, vous pouvez savoir quand un utilisateur a ouvert le document.

REMARQUE

Pour plus d’informations sur le service Document Security, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour appliquer une stratégie à un document Word, procédez comme suit :

  1. Inclure les fichiers de projet.
  2. Créez un objet API Client Document Security.
  3. Récupérez un document Word auquel une stratégie est appliquée.
  4. Appliquez une stratégie existante au document Word.
  5. Enregistrez le document Word protégé par une stratégie.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, veillez à inclure les fichiers proxy.

Création d’un objet API client Document Security

Avant d’effectuer par programmation une opération de service Document Security, vous devez créer un objet client de service Document Security.

Récupération d’un document Word

Pour appliquer une stratégie, vous devez récupérer un document Word. Une fois que vous avez appliqué une stratégie au document Word, les utilisateurs sont restreints lors de l’utilisation du document. Par exemple, si la stratégie ne permet pas l’ouverture du document hors ligne, les utilisateurs doivent être en ligne pour ouvrir le document.

Application d’une stratégie existante au document Word

Pour appliquer une stratégie à un document Word, vous devez référencer une stratégie existante et spécifier à quel jeu de stratégies elle appartient. L’utilisateur qui définit les propriétés de connexion doit avoir accès à la stratégie spécifiée. Dans le cas contraire, une exception se produit.

Enregistrement du document Word

Une fois que le service Document Security a appliqué une stratégie à un document Word, vous pouvez enregistrer le document Word protégé par une stratégie en tant que fichier DOC.

Voir également

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Révocation de l’accès aux documents

Application d’une stratégie à un document Word à l’aide de l’API Java

Appliquez une stratégie à un document Word à l’aide de l’API Document Security (Java) :

  1. Inclure les fichiers de projet.

    Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.

  2. 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.
  3. 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.
  4. Appliquez une stratégie 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 protectDocument de l’objet DocumentManager et en transmettant les valeurs suivantes :

      • Objet com.adobe.idp.Document contenant le document Word auquel la stratégie est appliquée.
      • Une valeur string qui spécifie le nom du document.
      • Une valeur string qui spécifie le nom du jeu de stratégies auquel appartient la stratégie. Vous pouvez spécifier une valeur null qui entraîne l’utilisation du jeu de stratégies MyPolicies.
      • Une valeur string qui spécifie le nom de la stratégie.
      • Une valeur string qui représente 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 nulle (si ce paramètre est nul, la valeur de paramètre suivante doit être nulle).
      • Une valeur string qui représente le nom canonique de l’utilisateur du gestionnaire de l’utilisateur 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).
      • 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 stratégie.

  5. Enregistrez le document Word.

    • Appelez la méthode getProtectedDoc de l’objet RMSecureDocumentResult 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 de 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 (veillez à utiliser l’objet Document renvoyé par la méthode getProtectedDoc ).

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous au didacticiel de mise en route suivant :

  • "Démarrage rapide (mode SOAP) : Application d’une stratégie à un document Word à l’aide de l’API Java"

Application d’une stratégie à un document Word à l’aide de l’API de service Web

Appliquez une stratégie à un document Word à l’aide de l’API Document Security (service Web) :

  1. Inclure les fichiers de projet.

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Créez un objet API Client Document Security.

    • Créez un objet DocumentSecurityServiceClient à l’aide de son constructeur par défaut.

    • Créez un objet DocumentSecurityServiceClient.Endpoint.Address à l’aide du 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.
    • Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

  3. Récupérez un document Word.

    • Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker un document Word auquel une stratégie est appliquée.
    • Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier 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é System.IO.FileStream de l’objet 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 avec le contenu du tableau d’octets.
  4. Appliquez une stratégie existante au document Word.

    Appliquez une stratégie 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 la stratégie est appliquée.
    • Une valeur string qui spécifie le nom du document.
    • Une valeur string qui spécifie le nom du jeu de stratégies auquel appartient la stratégie. Vous pouvez spécifier une valeur null qui entraîne l’utilisation du jeu de stratégies MyPolicies.
    • Une valeur string qui spécifie le nom de la stratégie.
    • Une valeur string qui représente 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 nulle (si ce paramètre est nul, la valeur de paramètre suivante doit être null).
    • Une valeur string qui représente le nom canonique de l’utilisateur du gestionnaire de l’utilisateur qui est l’éditeur du document. Cette valeur de paramètre est facultative et peut être nulle (si ce paramètre est nul, la valeur du paramètre précédent doit être null).
    • Valeur RMLocale qui spécifie la valeur du paramètre régional (par exemple, RMLocale.en).
    • Paramètre de sortie string utilisé pour stocker la valeur de l’identifiant de stratégie.
    • Paramètre de sortie string utilisé pour stocker la valeur d’identifiant protégée par une stratégie.
    • Un paramètre de sortie string 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 stratégie.

  5. Enregistrez le document Word.

    • Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document Word protégé par une stratégie.
    • 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 appelant 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 l’objet Write et en transmettant le tableau d’octets.

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous au didacticiel de mise en route suivant :

  • "Démarrage rapide (MTOM) : Application d’une stratégie à un document Word à l’aide de l’API de service Web"

Suppression de stratégies des documents Word

Vous pouvez supprimer une stratégie d’un document Word protégé par une stratégie afin de supprimer la protection du document. En d’autres termes, si vous ne souhaitez plus que le document soit protégé par une stratégie. Si vous souhaitez mettre à jour un document Word protégé par une stratégie avec une nouvelle stratégie, au lieu de supprimer la stratégie et d’ajouter la stratégie mise à jour, il est plus efficace de changer de stratégie.

REMARQUE

Pour plus d’informations sur le service Document Security, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour supprimer une stratégie d’un document Word protégé par une stratégie, procédez comme suit :

  1. Inclure les fichiers de projet
  2. Créez un objet API Client Document Security.
  3. Récupérez un document Word protégé par une stratégie.
  4. Supprimez la stratégie du document Word.
  5. Enregistrez le document Word non sécurisé.s

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services web, veillez à inclure les fichiers proxy.

Création d’un objet API client Document Security

Avant d’effectuer par programmation une opération de service Document Security, créez un objet client de service Document Security.

Récupération d’un document Word protégé par une stratégie

Pour supprimer une stratégie, vous devez récupérer un document Word protégé par une stratégie. Si vous tentez de supprimer une stratégie d’un document Word qui n’est pas protégé par une stratégie, une exception est générée.

Suppression de la stratégie du document Word

Vous pouvez supprimer une stratégie d’un document Word protégé par une stratégie à condition qu’un administrateur soit spécifié dans les paramètres de connexion. Dans le cas contraire, la stratégie utilisée pour protéger un document doit contenir l’autorisation SWITCH_POLICY pour supprimer une stratégie d’un document Word. En outre, l’utilisateur spécifié dans les paramètres de connexion AEM Forms doit également disposer de cette autorisation. Dans le cas contraire, une exception est générée.

Enregistrement du document Word non sécurisé

Une fois que le service Document Security a supprimé une stratégie d’un document Word, vous pouvez enregistrer le document Word non sécurisé en tant que fichier DOC.

Voir également

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Application de stratégies à des documents Word

Supprimer une stratégie d’un document Word à l’aide de l’API Java

Supprimez une stratégie d’un document Word protégé par une stratégie à l’aide de l’API Document Security (Java) :

  1. Inclure les fichiers de projet

    Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.

  2. Création d’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.
  3. Récupération d’un document Word protégé par une stratégie

    • Créez un objet java.io.FileInputStream qui représente le document Word protégé par une stratégie 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.
  4. Suppression de la stratégie 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 removeSecurity de l’objet DocumentManager et en transmettant l’objet com.adobe.idp.Document contenant le document Word protégé par une stratégie. Cette méthode renvoie un objet com.adobe.idp.Document contenant un document Word non sécurisé.
  5. Enregistrement du document Word non sécurisé

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

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous au didacticiel de mise en route suivant :

  • "Démarrage rapide (mode SOAP) : Suppression d’une stratégie d’un document Word à l’aide de l’API Java"

Supprimer une stratégie d’un document Word à l’aide de l’API de service Web

Supprimez une stratégie d’un document Word protégé par une stratégie à l’aide de l’API Document Security (service Web) :

  1. Inclure les fichiers de projet

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Création d’un objet API client Document Security

    • Créez un objet RightsManagementServiceClient à l’aide de son constructeur par défaut.

    • Créez un objet RightsManagementServiceClient.Endpoint.Address à l’aide du 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.

  3. Récupération d’un document Word protégé par une stratégie

    • Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker le document Word protégé par une stratégie à partir duquel la stratégie est supprimée.
    • Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier 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. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété System.IO.FileStream de l’objet Length.
    • Renseignez le tableau d’octets avec les données de flux en appelant la méthode System.IO.FileStream de l’objet Read 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 avec le contenu du tableau d’octets.
  4. Suppression de la stratégie du document Word

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

  5. Enregistrement du document Word non sécurisé

    • Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string qui représente l’emplacement du fichier du document Word 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 appelant son constructeur et en transmettant l’objet System.IO.FileStream.

Exemples de code

Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous au didacticiel de mise en route suivant :

  • "Démarrage rapide (MTOM) : Suppression d’une stratégie d’un document Word à l’aide de l’API de service Web"

Voir également

Appel d’AEM Forms à l’aide de MTOM

Sur cette page