Les exemples et exemples de ce document ne concernent que l’environnement AEM Forms on JEE.
À propos du service de sécurité Document
Le service Document Security permet aux utilisateurs d'appliquer de manière dynamique des paramètres de confidentialité aux documents Adobe PDF et de garder le contrôle sur les documents, quelle que soit leur diffusion.
Le service Document Security empêche la diffusion des informations au-delà de la portée de l’utilisateur en permettant à ce dernier de contrôler 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, comment l’utiliser et contrôler le document une fois distribué. Un utilisateur peut également contrôler dynamiquement l’accès à un document protégé par une stratégie et peut 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 (fichiers DOC). Vous pouvez utiliser l'API du client Document Security pour utiliser ces types de fichiers. Les versions suivantes sont prises en charge :
Pour plus de clarté, les deux sections suivantes traitent de la façon de travailler avec les documents Word :
Vous pouvez exécuter ces tâches à l’aide du service Document Security :
Pour plus d'informations sur le service Document Security, consultez le Guide de référence des services pour AEM Forms.
Vous pouvez créer des stratégies par programmation à l’aide de l’API Java de Document Security ou de l’API de service Web. Une stratégie est un ensemble d'informations qui comprend les paramètres de sécurité du document, les utilisateurs autorisés et les droits d'utilisation. Vous pouvez créer et enregistrer autant de stratégies que vous le souhaitez à l’aide de paramètres de sécurité adaptés à différentes situations et à différents utilisateurs.
Les stratégies vous permettent d’effectuer les tâches suivantes :
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) qui décrit la stratégie. Les autorisations de stratégie et le principal sont définis 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>
Pour plus d'informations sur le service Document Security, consultez le Guide de référence des services pour AEM Forms.
Pour créer une stratégie, procédez comme suit :
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 de classe de votre projet :
Pour plus d’informations sur l’emplacement de ces fichiers JAR, voir Inclusion de fichiers de bibliothèque Java AEM Forms.
Création d’un objet API Client de sécurité Document
Avant de pouvoir exécuter par programmation une opération du service Document Security, créez un objet client du service Document Security.
Définir les 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 de stratégie doivent être uniques pour chaque jeu de stratégies. Un jeu de stratégies est simplement un ensemble de stratégies. Il peut y avoir deux stratégies portant le même nom si elles appartiennent à des jeux de stratégies distincts. Toutefois, deux stratégies d’un même jeu de stratégies ne peuvent pas avoir le même nom de stratégie.
Un autre attribut utile à définir est la période de validité. 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 :
Vous pouvez spécifier uniquement une date de début, ce qui signifie que la stratégie est valide 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 une 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 :
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 levée.
Pour plus d'informations sur les autres attributs que vous pouvez définir, consultez 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, et 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 :
Ces actions ont pour conséquence que les destinataires ne peuvent que vue en ligne du document et ne peuvent pas le copier. Le document reste sécurisé jusqu'à ce que la sécurité en soit supprimée.
Enregistrer 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 Document Security (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.
Créez un objet API Client de sécurité Document.
ServiceClientFactory
qui contient des propriétés de connexion.DocumentSecurityClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Définissez les attributs de la stratégie.
Policy
en appelant la méthode statique InfomodelObjectFactory
de l'objet createPolicy
. Cette méthode renvoie un objet Policy
.Policy
de l’objet setName
et en transmettant une valeur de chaîne qui spécifie le nom de la stratégie.Policy
de l'objet setDescription
et en transmettant une valeur de chaîne qui spécifie la description de la stratégie.Policy
de l'objet setPolicySetName
et en transmettant une valeur de chaîne qui spécifie le nom du jeu de stratégies. (Vous pouvez spécifier null
pour cette valeur de paramètre afin que la stratégie soit ajoutée au jeu de stratégies Mes stratégies.)createValidityPeriod
de l’objet InfomodelObjectFactory
. Cette méthode renvoie un objet ValidityPeriod
.ValidityPeriod
de l’objet setRelativeExpirationDays
et en transmettant un nombre entier spécifiant le nombre de jours.Policy
de l'objet setValidityPeriod
et en transmettant l'objet ValidityPeriod
.Créez une entrée de stratégie.
createPolicyEntry
de l'objet InfomodelObjectFactory
. Cette méthode renvoie un objet PolicyEntry
.InfomodelObjectFactory
statique createPermission
de l’objet. Transmettez un membre de données statiques qui appartient à l'interface Permission
qui représente l'autorisation. Cette méthode renvoie un objet Permission
. Par exemple, pour ajouter l’autorisation permettant 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 d’ajout).PolicyEntry
de l'objet addPermission
et en transmettant l'objet Permission
. (Répétez cette étape pour chaque objet Permission
que vous avez créé).createSpecialPrincipal
de l'objet InfomodelObjectFactory
. Transmettez un membre de données qui appartient à l'objet InfomodelObjectFactory
qui représente l'entité de sécurité. Cette méthode renvoie un objet Principal
. Par exemple, pour ajouter l’éditeur du document en tant que principal, transmettez InfomodelObjectFactory.PUBLISHER_PRINCIPAL
.PolicyEntry
de l'objet setPrincipal
et en transmettant l'objet Principal
.Policy
de l'objet addPolicyEntry
et en transmettant l'objet PolicyEntry
.Enregistrez la stratégie.
Créez un objet PolicyManager
en appelant la méthode DocumentSecurityClient
de l'objet getPolicyManager
.
Enregistrez la stratégie en appelant la méthode registerPolicy
de l'objet PolicyManager
et en transmettant les valeurs suivantes :
Policy
représentant la stratégie à enregistrer.Valeur de chaîne qui représente le jeu de stratégies auquel appartient la stratégie.
Si vous utilisez un compte d’administrateur 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
.
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 :
Créez une stratégie à l’aide de l’API Document Security (service Web) :
Incluez des 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
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un objet API Client de sécurité Document.
Créez un objet DocumentSecurityServiceClient
en utilisant son constructeur par défaut.
Créez un objet DocumentSecurityServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne 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 exécutant les tâches suivantes :
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.
Définissez les attributs de la stratégie.
PolicySpec
en utilisant son constructeur.name
de l'objet PolicySpec
.description
de l'objet PolicySpec
.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 afin que la stratégie soit ajoutée à Mes stratégies.)offlineLeasePeriod
de l’objet PolicySpec
.policyXml
de l’objet PolicySpec
avec une valeur de chaîne qui représente les données XML PDRL. Pour exécuter cette tâche, créez un objet .NET StreamReader
à l'aide de son constructeur. Transférez l'emplacement d'un fichier XML PDRL représentant la stratégie au constructeur StreamReader
. Ensuite, appelez la méthode StreamReader
de l’objet ReadLine
et affectez la valeur renvoyée à une variable de chaîne. 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
.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.
Enregistrez la stratégie.
Enregistrez la stratégie en appelant la méthode registerPolicy
de l'objet DocumentSecurityServiceClient
et en transmettant les valeurs suivantes :
PolicySpec
représentant la stratégie à enregistrer.null
qui entraîne l’ajout de la stratégie au jeu de stratégies MyPolices.Si vous utilisez un compte d’administrateur AEM forms dans les paramètres de connexion pour créer l’objet DocumentSecurityClient
, spécifiez le nom du jeu de stratégies lorsque vous appelez la méthode registerPolicy
.
Si vous utilisez un utilisateur Document SecurityDocument 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
.
Lors de la création d’une stratégie et de la spécification d’un jeu de stratégies, veillez à 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 Débuts rapides suivants :
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 é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
.
Pour plus d'informations sur le service Document Security, consultez le Guide de référence des services pour AEM Forms.
Pour modifier une stratégie existante, procédez comme suit :
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 de sécurité Document
Avant de pouvoir exécuter par programmation une opération 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
.
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 elle appartient. 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éfinir les 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. Faites ensuite référence au document XML PDRL mis à jour en utilisant le membre de données policyXML
de l'interface PolicySpec
.
Pour plus d'informations sur les autres attributs que vous pouvez définir, consultez la description de l'interface Policy
dans la Référence de l'API AEM Forms.
Mettre à jour 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 les documents sont mises à jour la prochaine fois que le document protégé par une stratégie est synchronisé avec le service Document Security.
Modifiez une stratégie existante à l’aide de l’API Document Security (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.
Créez un objet API Client de sécurité Document.
ServiceClientFactory
qui contient des propriétés de connexion.RightsManagementClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Récupérez une stratégie existante.
Créez un objet PolicyManager
en appelant la méthode RightsManagementClient
de l'objet getPolicyManager
.
Créez un objet Policy
qui représente la stratégie à mettre à jour en appelant la méthode PolicyManager
de l'objet getPolicy
et en transmettant les valeurs suivantes."
null
pour que le jeu de stratégies MyPolicies
soit utilisé.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
.
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, voir le Début rapide (mode SOAP) : Modification d’une stratégie à l’aide de la section API Java.
Modifiez une stratégie existante à l’aide de l’API Document Security (service Web) :
Incluez des 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
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un objet API Client de sécurité Document.
Créez un objet RightsManagementServiceClient
en utilisant son constructeur par défaut.
Créez un objet RightsManagementServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne 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 exécutant les tâches suivantes :
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.
Récupérez une stratégie existante.
Créez un objet PolicySpec
qui représente la stratégie à modifier en appelant la méthode RightsManagementServiceClient
de l'objet getPolicy
et en transmettant les valeurs suivantes :
null
pour que le jeu de stratégies MyPolicies
soit utilisé.Définissez les attributs de la stratégie.
Modifiez les attributs de la stratégie pour répondre aux besoins de votre entreprise.
Mettez à jour la 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 Débuts rapides suivants :
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. Cependant, 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 devient disponible.
Pour plus d'informations sur le service Document Security, consultez le Guide de référence des services pour AEM Forms.
Pour supprimer une stratégie existante, procédez comme suit :
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 de sécurité Document
Avant de pouvoir exécuter par programmation une opération du service Document Security, vous devez créer un objet client du 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
.
Supprimer la stratégie
Pour supprimer une stratégie, vous spécifiez la stratégie à supprimer et le jeu de stratégies auquel elle appartient. L’utilisateur dont les paramètres sont utilisés pour appeler AEM Forms doit être autorisé à 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.
Supprimez une stratégie à l’aide de l’API Document Security (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.
Créez un objet API Client de sécurité Document.
ServiceClientFactory
qui contient des propriétés de connexion.RightsManagementClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Supprimez la stratégie.
Créez un objet PolicyManager
en appelant la méthode RightsManagementClient
de l'objet getPolicyManager
.
Supprimez la stratégie en appelant la méthode deletePolicy
de l'objet PolicyManager
et en transmettant les valeurs suivantes :
null
pour que le jeu de stratégies MyPolicies
soit utilisé.Exemples de code
Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux Débuts rapides suivants :
Supprimez une stratégie à l’aide de l’API Document Security (service Web) :
Incluez des 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
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un objet API Client de sécurité Document.
Créez un objet RightsManagementServiceClient
en utilisant son constructeur par défaut.
Créez un objet RightsManagementServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne 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 exécutant les tâches suivantes :
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.
Supprimez la stratégie.
Supprimez une stratégie en appelant la méthode deletePolicy
de l'objet RightsManagementServiceClient
et en transmettant les valeurs suivantes :
null
pour que le jeu de stratégies MyPolicies
soit utilisé.Exemples de code
Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux Débuts rapides suivants :
Vous pouvez appliquer une stratégie à un document PDF afin de sécuriser le document. En appliquant une stratégie à un document PDF, vous restreignez l’accès au document. Vous ne pouvez pas appliquer une stratégie à un document si le document est déjà sécurisé avec une stratégie.
Pendant que le document est ouvert, vous pouvez également restreindre l’accès aux fonctionnalités Acrobat et Adobe Reader, y compris 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 l’avoir distribué. C'est-à-dire, vous pouvez voir comment le document est utilisé et qui l'utilise. Par exemple, vous pouvez savoir quand quelqu’un a ouvert le document.
Pour plus d'informations sur le service Document Security, consultez le Guide de référence des services pour AEM Forms.
Pour appliquer une stratégie à un document PDF, procédez comme suit :
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 de sécurité Document
Avant de pouvoir exécuter par programmation une opération du service Document Security, créez un objet client du 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 afin d’appliquer une stratégie. Une fois que vous avez appliqué une stratégie au document PDF, les utilisateurs sont limités 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.
Appliquer 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.
Enregistrer le 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 AEM Forms
Réglage des propriétés de la connexion
Révocation de l’accès aux Documents
Appliquez une stratégie à un document PDF à l’aide de l’API Document Security (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.
Créez un objet API Client de sécurité Document.
ServiceClientFactory
qui contient des propriétés de connexion.RightsManagementClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Récupérez un document PDF.
java.io.FileInputStream
qui représente le document PDF à l’aide de son constructeur. Transmettez une valeur de chaîne qui spécifie l’emplacement du document PDF.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Appliquez une stratégie existante au document PDF.
Créez un objet DocumentManager
en appelant la méthode RightsManagementClient
de l'objet getDocumentManager
.
Appliquez une stratégie au document PDF en appelant la méthode DocumentManager
de l’objet protectDocument
et en transmettant les valeurs suivantes :
com.adobe.idp.Document
contenant le document PDF auquel la stratégie est appliquée.null
qui se traduit par l'utilisation du jeu de stratégies MyPolicies
.null
(si ce paramètre est nul, la valeur de paramètre précédente doit être null
).com.adobe.livecycle.rightsmanagement.Locale
qui représente 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 sécuriser un document PDF, spécifiez null
.La méthode protectDocument
renvoie un objet RMSecureDocumentResult
contenant le document PDF protégé par une stratégie.
Enregistrez le document PDF.
RMSecureDocumentResult
de l’objet getProtectedDoc
pour obtenir le document PDF protégé par une stratégie. Cette méthode renvoie un objet com.adobe.idp.Document
.java.io.File
et assurez-vous que l’extension de fichier est PDF.com.adobe.idp.Document
de l'objet copyToFile
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 Débuts rapides suivants :
Voir également
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Appliquez une stratégie à un document PDF à l’aide de l’API Document Security (service Web) :
Incluez des 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
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un objet API Client de sécurité Document.
Créez un objet RightsManagementServiceClient
en utilisant son constructeur par défaut.
Créez un objet RightsManagementServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne 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 exécutant les tâches suivantes :
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.
Récupérez un document PDF.
BLOB
en utilisant son constructeur. L’objet BLOB
permet de stocker un document PDF auquel une stratégie est appliquée.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF et le mode d’ouverture du fichier.System.IO.FileStream
. Déterminez la taille du tableau d’octets en obtenant la propriété System.IO.FileStream
de l’objet Length
.System.IO.FileStream
de l’objet Read
. Passez le tableau d’octets, la position de départ et la longueur du flux à lire.BLOB
en attribuant son champ MTOM
au contenu du tableau d’octets.Appliquez une stratégie existante au document PDF.
Appliquez une stratégie au document PDF en appelant la méthode RightsManagementServiceClient
de l’objet protectDocument
et en transmettant les valeurs suivantes :
BLOB
contenant le document PDF auquel la stratégie est appliquée.null
qui se traduit par l'utilisation du jeu de stratégies MyPolicies
.null
).null
).RMLocale
qui spécifie la valeur du paramètre régional (par exemple, RMLocale.en
).application/pdf
).La méthode protectDocument
renvoie un objet BLOB
contenant le document PDF protégé par une stratégie.
Enregistrez le document PDF.
System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF protégé par une stratégie.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
.System.IO.BinaryWriter
en appelant son constructeur et en transmettant l'objet System.IO.FileStream
.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 Débuts rapides suivants :
Vous pouvez supprimer une stratégie d’un document protégé par une stratégie afin de supprimer la sécurité du document. Autrement dit, si vous ne voulez plus que le document soit protégé par une politique. Si vous souhaitez mettre à jour un document protégé par une stratégie à l’aide d’une nouvelle stratégie, il est plus efficace de changer de stratégie au lieu de la supprimer et d’ajouter la stratégie mise à jour.
Pour plus d'informations sur le service Document Security, consultez le Guide de référence des services pour AEM Forms.
Pour supprimer une stratégie d’un document PDF protégé par une stratégie, procédez comme suit :
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 de sécurité Document
Avant de pouvoir exécuter par programmation une opération du service Document Security, créez un objet client du 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 afin de 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, vous provoquerez une exception.
Supprimer 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. Si ce n’est pas le cas, la stratégie utilisée pour sécuriser un document doit contenir l’autorisation SWITCH_POLICY
afin de 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.
Enregistrer le 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 AEM Forms
Réglage des propriétés de la connexion
Application de stratégies à des Documents PDF
Supprimez une stratégie d’un document PDF protégé par une stratégie à l’aide de l’API Document Security (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.
Créez un objet API Client de sécurité Document.
ServiceClientFactory
qui contient des propriétés de connexion.DocumentSecurityClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Récupérez un document PDF protégé par une stratégie.
java.io.FileInputStream
qui représente le document PDF protégé par une stratégie en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du document PDF.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Supprimez la stratégie du document PDF.
DocumentManager
en appelant la méthode DocumentSecurityClient
de l'objet getDocumentManager
.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é.Enregistrez le document PDF non sécurisé.
java.io.File
et assurez-vous que l’extension de fichier est PDF.Document
de l'objet copyToFile
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 Débuts rapides suivants :
Supprimez une stratégie d’un document PDF protégé par une stratégie à l’aide de l’API Document Security (service Web) :
Incluez des 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
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un objet API Client de sécurité Document.
Créez un objet DocumentSecurityServiceClient
en utilisant son constructeur par défaut.
Créez un objet DocumentSecurityServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne 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 exécutant les tâches suivantes :
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.
Récupérez un document PDF protégé par une stratégie.
BLOB
en utilisant son constructeur. L’objet BLOB
permet de stocker le document PDF protégé par une stratégie à partir duquel la stratégie est supprimée.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF et le mode d’ouverture du fichier.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
.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.BLOB
en attribuant son champ MTOM
au contenu du tableau d’octets.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é.
Enregistrez le document PDF non sécurisé.
System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF non sécurisé.BLOB
renvoyé par la méthode removePolicySecurity
. Renseignez le tableau d’octets en obtenant la valeur du champ BLOB
de l’objet MTOM
.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 Débuts rapides suivants :
Voir également
Appel de AEM Forms à l’aide de MTOM
Appel de AEM Forms à l’aide de SwaRef
Vous pouvez révoquer l’accès à un document PDF protégé par une stratégie, de sorte que toutes les copies du document soient 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 affiché. 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 lorsque l’utilisateur se synchronise avec le service Document Security en ouvrant le document protégé par une stratégie en ligne.
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 vue le document à moins que l'accès ne soit rétabli.
Pour plus d'informations sur le service Document Security, consultez le Guide de référence des services pour AEM Forms.
Pour révoquer un document protégé par une stratégie, procédez comme suit :
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 de sécurité Document
Avant de pouvoir exécuter par programmation une opération du service Document Security, vous devez créer un objet client du service Document Security.
Récupération d’un document PDF protégé par une stratégie
Vous devez récupérer un document PDF protégé par une stratégie pour le révoquer. 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 d’identifiant de licence.
Révoquer le 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 vue 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é, un document mis à jour s’affiche au lieu du document révoqué.
Si vous tentez de révoquer un document déjà révoqué, une exception est levée.
Voir également
Inclusion des fichiers de bibliothèque Java 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évoquez l’accès à un document PDF protégé par une stratégie à l’aide de l’API Document Security (Java) :
Inclure les fichiers de projet
Incluez des fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.
Création d’un objet API Client de sécurité Document
ServiceClientFactory
qui contient des propriétés de connexion.DocumentSecurityClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Récupération d’un document PDF protégé par une stratégie
java.io.FileInputStream
représentant le document PDF protégé par une stratégie en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du document PDF.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Révoquer le document protégé par une stratégie
Créez un objet DocumentManager
en appelant la méthode DocumentSecurityClient
de l'objet getDocumentManager
.
Récupérez la valeur d'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
qui représente le document protégé par une stratégie. Cette méthode renvoie une valeur de chaîne qui représente la valeur de l’identifiant de licence.
Créez un objet LicenseManager
en appelant la méthode DocumentSecurityClient
de l'objet getLicenseManager
.
Révoquez le document protégé par une stratégie en appelant la méthode LicenseManager
de l’objet revokeLicense
et en transmettant les valeurs suivantes :
DocumentManager
de l’objet getLicenseId
).License
qui spécifie la raison de la révocation du document. Par exemple, vous pouvez spécifier License.DOCUMENT_REVISED
.java.net.URL
qui spécifie l'emplacement où se trouve un document révisé. 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 Débuts rapides suivants :
Révoquez l’accès à un document PDF protégé par une stratégie à l’aide de l’API Document Security (service Web) :
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
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Création d’un objet API Client de sécurité Document
Créez un objet DocumentSecurityServiceClient
en utilisant son constructeur par défaut.
Créez un objet DocumentSecurityServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne 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 exécutant les tâches suivantes :
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.
Récupération d’un document PDF protégé par une stratégie
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é.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne 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.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
.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.BLOB
en attribuant son champ MTOM
au contenu du tableau d’octets.Révoquer le document protégé par une stratégie
Récupérez la valeur d'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
qui représente le document protégé par une stratégie. Cette méthode renvoie une valeur de chaîne qui représente l’identifiant de licence.
Révoquez le document protégé par une stratégie en appelant la méthode DocumentSecurityServiceClient
de l’objet revokeLicense
et en transmettant les valeurs suivantes :
DocumentSecurityServiceService
de l’objet getLicenseId
).Reason
qui spécifie la raison de la révocation du document. Par exemple, vous pouvez spécifier Reason.DOCUMENT_REVISED
.string
qui spécifie l’emplacement de l’URL vers lequel se trouve un document révisé. 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 Débuts rapides suivants :
Voir également
Suppression de stratégies des Documents Word
Appel de AEM Forms à l’aide de MTOM
Appel de AEM Forms à l’aide de SwaRef
Vous pouvez rétablir l’accès à un document PDF révoqué, de sorte que toutes les copies du document révoqué soient accessibles aux utilisateurs. Lorsqu’un utilisateur ouvre un document restauré qui a été révoqué, il peut vue le document.
Pour plus d'informations sur le service Document Security, consultez le Guide de référence des services pour AEM Forms.
Pour rétablir l’accès à un document PDF révoqué, procédez comme suit :
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 de sécurité Document
Avant de pouvoir exécuter par programmation une opération du service Document Security, vous devez créer un objet client du 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érer l’identifiant de licence du document PDF révoqué
Pour rétablir un document PDF révoqué, vous devez récupérer l’identifiant de licence du 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 provoquerez 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 indiquer l’identifiant de licence du document révoqué. Si vous tentez de rétablir l’accès à un document PDF qui n’est pas révoqué, vous provoquerez une exception.
Voir également
Inclusion des fichiers de bibliothèque Java 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établissement de l’accès à un document révoqué à l’aide de l’API Document Security (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.
Créez un objet API Client de sécurité Document.
ServiceClientFactory
qui contient des propriétés de connexion.DocumentSecurityClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Récupérez l’identifiant de licence du document PDF révoqué.
java.io.FileInputStream
qui représente le document PDF révoqué en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du document PDF.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.DocumentManager
en appelant la méthode DocumentSecurityClient
de l'objet getDocumentManager
.DocumentManager
de l'objet getLicenseId
et en transmettant l'objet com.adobe.idp.Document
qui représente le document révoqué. Cette méthode renvoie une valeur de chaîne qui représente l’identifiant de licence.Rétablit l’accès au document PDF révoqué.
LicenseManager
en appelant la méthode DocumentSecurityClient
de l'objet getLicenseManager
.LicenseManager
de l’objet unrevokeLicense
et en transmettant la valeur d’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 Débuts rapides suivants :
Rétablissement de l’accès à un document révoqué à l’aide de l’API Document Security (service Web) :
Incluez des 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
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un objet API Client de sécurité Document.
Créez un objet DocumentSecurityServiceClient
en utilisant son constructeur par défaut.
Créez un objet DocumentSecurityServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne 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 exécutant les tâches suivantes :
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.
Récupérez l’identifiant de licence du document PDF révoqué.
BLOB
en utilisant son constructeur. L’objet BLOB
est utilisé pour stocker un document PDF révoqué auquel l’accès est rétabli.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF révoqué et le mode d’ouverture du fichier.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
.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.BLOB
en attribuant son champ MTOM
au contenu du tableau d’octets.Rétablit l’accès au document PDF révoqué.
DocumentSecurityServiceClient
de l'objet getLicenseID
et en transmettant l'objet BLOB
qui représente le document révoqué. Cette méthode renvoie une valeur de chaîne qui représente l’identifiant de licence.DocumentSecurityServiceClient
de l’objet unrevokeLicense
et en transmettant une valeur de chaîne qui spécifie la valeur d’identifiant de licence du document PDF révoqué (transmettez la valeur de retour de la méthode DocumentSecurityServiceClient
de l’objet getLicenseId
).Exemples de code
Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux Débuts rapides suivants :
Voir également
Appel de AEM Forms à l’aide de MTOM
Appel de AEM Forms à l’aide de SwaRef
Vous pouvez utiliser l’API Document Security Service (Java et service Web) pour inspecter les 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 sécuriser le document et la date à laquelle le document a été sécurisé.
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 à AEM Forms. Si vous tentez d’inspecter un document protégé par une stratégie à l’aide de LiveCycle 8.x (ou version antérieure), une exception est générée.
Pour plus d'informations sur le service Document Security, consultez le Guide de référence des services pour AEM Forms.
Pour inspecter un document PDF protégé par une stratégie, procédez comme suit :
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 de sécurité Document
Avant de pouvoir exécuter par programmation une opération du service Document Security, créez un objet client du 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 pour l’inspection
Pour inspecter un document protégé par une stratégie, récupérez-le. Si vous tentez d’inspecter un document non sécurisé avec une stratégie ou révoqué, une exception est générée.
Inspect, le 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 examiné un document PDF protégé par une stratégie, vous pouvez obtenir des informations à son sujet. Par exemple, vous pouvez déterminer la stratégie utilisée pour sécuriser 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 AEM Forms
Réglage des propriétés de la connexion
Inspect un document PDF protégé par une stratégie à l’aide de l’API Document Security Service (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java. Pour plus d’informations sur l’emplacement de ces fichiers, voir Inclusion des fichiers de bibliothèque Java AEM Forms.
Créez un objet API Client de sécurité Document.
ServiceClientFactory
qui contient des propriétés de connexion. (Voir Réglage des propriétés de la connexion.)RightsManagementClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Récupérez un document protégé par une stratégie à inspecter.
java.io.FileInputStream
qui représente le document PDF protégé par une stratégie en utilisant son constructeur. Transmettez une valeur de chaîne qui spécifie l’emplacement du document PDF.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Inspect le document.
DocumentManager
en appelant la méthode RightsManagementClient
de l'objet getDocumentManager
.LicenseManager
de l’objet inspectDocument
. 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.Obtenez des 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 RMInspectResult
de l’objet getPolicyName
.
Exemples de code
Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux Débuts rapides suivants :
Inspect un document PDF protégé par une stratégie à l’aide de l’API Document Security Service (service Web) :
Incluez des 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
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un objet API Client de sécurité Document.
Créez un objet RightsManagementServiceClient
en utilisant son constructeur par défaut.
Créez un objet RightsManagementServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne 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 exécutant les tâches suivantes :
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.
Récupérez un document protégé par une stratégie à inspecter.
BLOB
en utilisant son constructeur. L'objet BLOB
est utilisé pour stocker un document PDF à inspecter.System.IO.FileStream
en appelant son constructeur. Transmettez une valeur de chaîne qui représente l’emplacement du fichier du document PDF et le mode d’ouverture du fichier.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
.System.IO.FileStream
de l’objet Read
. Passez le tableau d’octets, la position de départ et la longueur du flux à lire.BLOB
en attribuant son champ MTOM
au contenu du tableau d’octets.Inspect le document.
Inspect le document protégé par une stratégie en appelant la méthode RightsManagementServiceClient
de l’objet inspectDocument
. 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.
Obtenez des 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 RMInspectResult
de l’objet policyName
.
Exemples de code
Pour obtenir des exemples de code à l’aide du service Document Security, reportez-vous aux Débuts rapides suivants :
Voir également
Appel de AEM Forms à l’aide de MTOM
Appel de AEM Forms à l’aide de SwaRef
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 créé. 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.
Seuls les utilisateurs disposant de droits d’administrateur Document Security peuvent créer des filigranes. En d’autres termes, vous devez spécifier un tel utilisateur lors de la définition des paramètres de connexion requis pour créer un objet client du service Document Security.
Pour plus d'informations sur le service Document Security, consultez le Guide de référence des services pour AEM Forms.
Pour créer un filigrane, procédez comme suit :
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 de sécurité Document
Avant de pouvoir exécuter par programmation une opération du service Document Security, vous devez créer un objet client du 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 des filigranes
Pour créer un filigrane, vous devez définir des attributs de filigrane. L'attribut name doit toujours être défini. Outre l’attribut name, vous devez définir au moins l’un des attributs suivants :
Le tableau suivant liste les paires clé/valeur requises lors de la création d’un filigrane à l’aide des services Web.
Nom de la clé |
Description |
Valeur |
---|---|---|
|
Indique si le nom d’utilisateur de l’utilisateur qui ouvre le document fait partie du filigrane. |
True ou false |
|
Indique si l’identification de l’utilisateur ouvrant le document fait partie du filigrane. |
True ou false |
|
Indique si la date actuelle fait partie du filigrane. |
True ou false |
|
Si cette valeur est true, la valeur du texte personnalisé doit être spécifiée à l’aide de |
True ou false |
|
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. |
|
Indique la rotation du filigrane. La valeur par défaut est 0 degré. |
Valeur comprise entre 0 et 359. |
|
Si cette valeur est spécifiée, |
Valeur supérieure à 0.0 et inférieure ou égale à 1.0. |
|
Indique l’alignement horizontal du filigrane. La valeur par défaut est center. |
gauche, centre ou droite |
|
Indique l’alignement vertical du filigrane. La valeur par défaut est center. |
haut, centre ou bas |
|
Indique si le filigrane est un arrière-plan. La valeur par défaut est false. |
True ou false |
|
True si une échelle personnalisée est spécifiée. Si cette valeur est vraie, SCALE doit également être spécifié. Si cette valeur est définie sur false, la valeur par défaut est ajustée à la page. |
True ou false |
|
Indique le texte personnalisé d’un filigrane. Si cette valeur est présente, |
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 avant de 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 AEM Forms
Réglage des propriétés de la connexion
Application de stratégies à des Documents PDF
Créez un filigrane à l’aide de l’API Document Security (Java) :
Incluez des fichiers de projet.
Incluez les fichiers JAR client, tels que adobe-rightsmanagement-client.jar
, dans le chemin de classe de votre projet Java.
Créez un objet API Client de sécurité Document.
ServiceClientFactory
qui contient des propriétés de connexion.RightsManagementClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Définition des attributs du filigrane
Watermark
en appelant la méthode statique InfomodelObjectFactory
de l'objet createWatermark
. Cette méthode renvoie un objet Watermark
.Watermark
de l’objet setName
et en transmettant une valeur de chaîne qui spécifie le nom de la stratégie.Watermark
de l’objet setBackground
et en transmettant true
. En définissant cet attribut, le filigrane apparaît à l’arrière-plan du document.Watermark
de l’objet setCustomText
et en transmettant une valeur de chaîne qui représente le texte du filigrane.Watermark
de l’objet setOpacity
et en transmettant un entier spécifiant le niveau d’opacité. La valeur 100 indique que le filigrane est complètement opaque et la valeur 0 indique que le filigrane est complètement transparent.Enregistrez le filigrane.
WatermarkManager
en appelant la méthode RightsManagementClient
de l'objet getWatermarkManager
. Cette méthode renvoie un objet WatermarkManager
.WatermarkManager
de l'objet registerWatermark
et en transmettant l'objet Watermark
représentant le filigrane à enregistrer. Cette méthode renvoie une valeur de chaîne 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 Débuts rapides suivants :
Créez un filigrane à l’aide de l’API Document Security (service Web) :
Créez un objet API Client de sécurité Document.
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
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un objet API Client de sécurité Document.
Créez un objet RightsManagementServiceClient
en utilisant son constructeur par défaut.
Créez un objet RightsManagementServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne 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 exécutant les tâches suivantes :
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.
Définissez les attributs du filigrane.
WatermarkSpec
en appelant le constructeur WatermarkSpec
.name
de l'objet WatermarkSpec
.id
du filigrane en attribuant une valeur de chaîne au membre de données WatermarkSpec
de l’objet id
.MyMapOf_xsd_string_To_xsd_anyType_Item
distinct.key
de l’objet MyMapOf_xsd_string_To_xsd_anyType_Item
(par exemple, WaterBackCmd:OPACITY)
.value
de l’objet MyMapOf_xsd_string_To_xsd_anyType_Item
(par exemple, .25
).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
.MyArrayOf_xsd_anyType
au membre de données WatermarkSpec
de l'objet values
.Enregistrez le filigrane.
Enregistrez le filigrane en appelant la méthode RightsManagementServiceClient
de l'objet registerWatermark
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 Débuts rapides suivants :
Voir également
Appel de AEM Forms à l’aide de MTOM
Appel de AEM Forms à l’aide de SwaRef
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, récupérez-le, modifiez ses attributs, puis mettez-le à jour sur le serveur. Supposons, par exemple, que vous récupériez un filigrane et que vous modifiez 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.
Seuls les utilisateurs disposant de droits d’administrateur Document Security peuvent modifier les filigranes. En d’autres termes, vous devez spécifier un tel utilisateur lors de la définition des paramètres de connexion requis pour créer un objet client du service Document Security.
Pour plus d'informations sur le service Document Security, consultez le Guide de référence des services pour AEM Forms.
Pour modifier un filigrane, procédez comme suit :
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 de sécurité Document
Avant de pouvoir exécuter par programmation une opération du service Document Security, vous devez créer un objet client du 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érer le 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 en spécifiant sa valeur d’identificateur.
Définition des attributs des filigranes
Pour modifier un filigrane existant, modifiez la valeur d’un ou de plusieurs attributs de filigrane. Lors de la mise à jour programmée d’un filigrane à l’aide d’un service Web, vous devez définir tous les attributs 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 à modifier soit WaterBackCmd:OPACITY
, vous devez définir les autres valeurs.
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.
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 AEM Forms
Réglage des propriétés de la connexion
Modifiez un filigrane à l’aide de l’API Document Security (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.
Créez un objet API Client de sécurité Document.
ServiceClientFactory
qui contient des propriétés de connexion.DocumentSecurityClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Récupérez le filigrane à modifier.
Créez un objet WatermarkManager
en appelant la méthode DocumentSecurityClient
de l'objet getWatermarkManager
et transmettez une valeur de chaîne qui spécifie le nom du filigrane. Cette méthode renvoie un objet Watermark
qui représente le filigrane à modifier.
Définissez les attributs du filigrane.
Définissez l’attribut d’opacité du filigrane en appelant la méthode Watermark
de l’objet setOpacity
et en transmettant un entier spécifiant le niveau d’opacité. La valeur 100 indique que le filigrane est complètement opaque et la valeur 0 indique que le filigrane est complètement transparent.
Cet exemple ne modifie que l'attribut d'opacité.
Mettez à jour le filigrane.
WatermarkManager
de l'objet updateWatermark
et en transmettant l'objet Watermark
dont l'attribut a été modifié.Exemples de code
Pour obtenir des exemples de code à l’aide du service Document Security, voir le Début rapide (mode SOAP) : Modification d’un filigrane à l’aide de la section API Java.
Modifiez un filigrane à l’aide de l’API Document Security (service Web) :
Incluez des 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
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un objet API Client de sécurité Document.
Créez un objet DocumentSecurityServiceClient
en utilisant son constructeur par défaut.
Créez un objet RightsManagementServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne 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 exécutant les tâches suivantes :
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.
Récupérez le filigrane à modifier.
Récupérez le filigrane à modifier en appelant la méthode DocumentSecurityServiceClient
de l’objet getWatermarkByName
. Transmettez une valeur de chaîne qui spécifie le nom du filigrane. Cette méthode renvoie un objet WatermarkSpec
qui représente le filigrane à modifier.
Définissez les attributs du filigrane.
MyMapOf_xsd_string_To_xsd_anyType_Item
distinct.key
de l’objet MyMapOf_xsd_string_To_xsd_anyType_Item
(par exemple, WaterBackCmd:OPACITY)
.value
de l’objet MyMapOf_xsd_string_To_xsd_anyType_Item
(par exemple, .50
).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
.MyArrayOf_xsd_anyType
au membre de données WatermarkSpec
de l'objet values
.Mettez à jour le filigrane.
Mettez à jour le filigrane en appelant la méthode DocumentSecurityServiceClient
de l'objet updateWatermark
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 Début rapide suivant :
Le service de Rights Management effectue le suivi d’actions spécifiques à 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 tombent dans l’une des catégories suivantes :
Vous pouvez rechercher des événements spécifiques en utilisant l’API Java Rights Management ou l’API de service Web. En recherchant des événements, vous pouvez effectuer des tâches, comme la création d’un fichier journal de certains événements.
Pour plus d’informations sur le service de Rights Management, voir Guide de référence des services pour AEM Forms.
Pour rechercher un événement de Rights Management, procédez comme suit :
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 exécuter une opération de service de Rights Management par programmation, vous devez créer un objet client de service de Rights Management. Si vous utilisez l’API Java, créez un objet DocumentSecurityClient
. Si vous utilisez l’API du service Web Rights Management, créez un objet DocumentSecurityServiceService
.
Spécifiez les événements à rechercher
Vous devez spécifier le événement à rechercher. Vous pouvez, par exemple, rechercher le événement de création de la stratégie, qui se produit lors de la création d’une nouvelle stratégie.
Rechercher le événement
Après avoir spécifié le événement à rechercher, vous pouvez utiliser l’API Java Rights Management ou l’API du service Web Rights Management pour rechercher le événement.
Voir également
Inclusion des fichiers de bibliothèque Java AEM Forms
Réglage des propriétés de la connexion
Recherchez des événements à l’aide de l’API Rights Management (Java) :
Inclure les fichiers de projet
Incluez des fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.
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.
Spécifiez les événements à rechercher
EventManager
en appelant la méthode DocumentSecurityClient
de l'objet getEventManager
. Cette méthode renvoie un objet EventManager
.EventSearchFilter
en appelant son constructeur.EventSearchFilter
de l'objet setEventCode
et en transmettant un membre de données statique appartenant à la classe EventManager
qui représente le événement pour lequel effectuer la recherche. Par exemple, pour rechercher le événement de création de stratégie, transmettez EventManager.POLICY_CREATE_EVENT
.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é au événement.
Rechercher le événement
Recherchez le é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 de é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 Débuts rapides suivants :
Recherchez des événements à l’aide de l’API du Rights Management (service Web) :
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
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Création d’un objet API Client Rights Management
Créez un objet DocumentSecurityServiceClient
en utilisant son constructeur par défaut.
Créez un objet DocumentSecurityServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne 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 exécutant les tâches suivantes :
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.
Spécifiez les événements à rechercher
EventSpec
en utilisant son constructeur.firstTime.date
de l’objet EventSpec
avec l’instance DataTime
qui représente le début de la période au moment où le événement s’est produit.true
au membre de données firstTime.dateSpecified
de l’objet EventSpec
.lastTime.date
de l’objet EventSpec
avec l’instance DataTime
qui représente la fin de la période au moment où le événement s’est produit.true
au membre de données lastTime.dateSpecified
de l’objet EventSpec
.eventCode
de l'objet EventSpec
. Le tableau suivant liste les valeurs numériques que vous pouvez affecter à cette propriété :Type d'événement |
Valeur |
---|---|
|
999 |
|
1000 |
|
1001 |
|
1002 |
|
1003 |
|
1004 |
|
1005 |
|
1006 |
|
1007 |
|
1008 |
|
1009 |
|
2000 |
|
2001 |
|
2002 |
|
2003 |
|
2004 |
|
2005 |
|
2006 |
|
2007 |
|
2008 |
|
2009 |
|
2010 |
|
2011 |
|
2012 |
|
2013 |
|
2014 |
|
3000 |
|
3001 |
|
3002 |
|
3003 |
|
3004 |
|
3005 |
|
4 000 |
|
4001 |
|
4002 |
|
4003 |
|
4004 |
|
4005 |
|
5 000 |
|
5001 |
|
5002 |
|
5003 |
|
5004 |
|
6 000 |
|
7 000 |
|
7001 |
|
7002 |
Rechercher le événement
Recherchez le événement en appelant la méthode DocumentSecurityServiceClient
de l’objet searchForEvents
et en transmettant l’objet EventSpec
qui représente le é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
. A l'aide d'une instance AuditSpec
, vous pouvez obtenir des informations sur le é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 Débuts rapides suivants :
Voir également
Appel de AEM Forms à l’aide de MTOM
Appel de AEM Forms à l’aide de SwaRef
Outre les documents PDF, le service Rights Management prend en charge d’autres formats de document, tels qu’un document Microsoft Word (DOC) et d’autres formats de fichier Microsoft Office. Par exemple, vous pouvez appliquer une stratégie à un document Word afin de la sécuriser. En appliquant une stratégie à un document Word, vous restreignez l’accès au document. Vous ne pouvez pas appliquer une stratégie à un document si le document est déjà sécurisé avec une stratégie.
Vous pouvez contrôler l’utilisation d’un document Word protégé par une stratégie après l’avoir distribué. C'est-à-dire, vous pouvez voir comment le document est utilisé et qui l'utilise. Par exemple, vous pouvez savoir quand quelqu’un a ouvert le document.
Pour plus d'informations sur le service Document Security, consultez le Guide de référence des services pour AEM Forms.
Pour appliquer une stratégie à un document Word, procédez comme suit :
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 de sécurité Document
Avant de pouvoir exécuter par programmation une opération du service Document Security, vous devez créer un objet client du service Document Security.
Récupération d’un document Word
Vous devez récupérer un document Word pour appliquer une stratégie. Une fois que vous avez appliqué une stratégie au document Word, les utilisateurs sont limités 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.
Appliquer 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.
Enregistrer le 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 AEM Forms
Réglage des propriétés de la connexion
Révocation de l’accès aux Documents
Appliquez une stratégie à un document Word à l’aide de l’API Document Security (Java) :
Incluez des fichiers de projet.
Incluez des fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.
Créez un objet API Client de sécurité Document.
ServiceClientFactory
qui contient des propriétés de connexion.DocumentSecurityClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Récupérez un document Word.
java.io.FileInputStream
qui représente le document Word en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l'emplacement du document Word.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Appliquez une stratégie existante au document Word.
Créez un objet DocumentManager
en appelant la méthode DocumentSecurityClient
de l'objet getDocumentManager
.
Appliquez une stratégie au document Word en appelant la méthode DocumentManager
de l'objet protectDocument
et en transmettant les valeurs suivantes :
com.adobe.idp.Document
contenant le document Word auquel la stratégie est appliquée.null
qui se traduit par l'utilisation du jeu de stratégies MyPolicies
.null
(si ce paramètre est null
, la valeur de paramètre précédente doit être null
).com.adobe.livecycle.rightsmanagement.Locale
qui représente 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.
Enregistrez le document Word.
RMSecureDocumentResult
de l’objet getProtectedDoc
pour obtenir le document Word protégé par une stratégie. Cette méthode renvoie un objet com.adobe.idp.Document
.java.io.File
et assurez-vous que l'extension de fichier est DOC.com.adobe.idp.Document
de l'objet copyToFile
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 Début rapide suivant :
Appliquez une stratégie à un document Word à l’aide de l’API Document Security (service Web) :
Incluez des 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
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Créez un objet API Client de sécurité Document.
Créez un objet DocumentSecurityServiceClient
en utilisant son constructeur par défaut.
Créez un objet DocumentSecurityServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne 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 exécutant les tâches suivantes :
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.
Récupérez un document Word.
BLOB
en utilisant son constructeur. L'objet BLOB
permet de stocker un document Word auquel une stratégie est appliquée.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l'emplacement du fichier du document Word et le mode d'ouverture du fichier.System.IO.FileStream
. Déterminez la taille du tableau d’octets en obtenant la propriété System.IO.FileStream
de l’objet Length
.System.IO.FileStream
de l’objet Read
. Passez le tableau d’octets, la position de départ et la longueur du flux à lire.BLOB
en attribuant son champ MTOM
au contenu du tableau d’octets.Appliquez une stratégie existante au document Word.
Appliquez une stratégie au document Word en appelant la méthode DocumentSecurityServiceClient
de l'objet protectDocument
et en transmettant les valeurs suivantes :
BLOB
contenant le document Word auquel la stratégie est appliquée.null
qui se traduit par l'utilisation du jeu de stratégies MyPolicies
.null
).null
).RMLocale
qui spécifie la valeur du paramètre régional (par exemple, RMLocale.en
).application/doc
).La méthode protectDocument
renvoie un objet BLOB
contenant le document Word protégé par une stratégie.
Enregistrez le document Word.
System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l'emplacement du fichier du document Word protégé par une stratégie.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
.System.IO.BinaryWriter
en appelant son constructeur et en transmettant l'objet System.IO.FileStream
.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 Début rapide suivant :
Vous pouvez supprimer une stratégie d’un document Word protégé par une stratégie afin de supprimer la sécurité du document. Autrement dit, si vous ne voulez plus que le document soit protégé par une politique. Si vous souhaitez mettre à jour un document Word protégé par une stratégie avec une nouvelle stratégie, il est plus efficace de changer de stratégie au lieu de la supprimer et d’ajouter la stratégie mise à jour.
Pour plus d'informations sur le service Document Security, consultez le Guide de référence des services pour AEM Forms.
Pour supprimer une stratégie d’un document Word protégé par une stratégie, procédez comme suit :
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 de sécurité Document
Avant de pouvoir exécuter par programmation une opération du service Document Security, créez un objet client du 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, vous provoquerez une exception.
Supprimer 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 sécuriser 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.
Enregistrer le 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 AEM Forms
Réglage des propriétés de la connexion
Application de stratégies à des Documents Word
Supprimez une stratégie d’un document Word protégé par une stratégie à l’aide de l’API Document Security (Java) :
Inclure les fichiers de projet
Incluez des fichiers JAR client, tels que adobe-rightsmanagement-client.jar, dans le chemin de classe de votre projet Java.
Création d’un objet API Client de sécurité Document
ServiceClientFactory
qui contient des propriétés de connexion.RightsManagementClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Récupération d’un document Word protégé par une stratégie
java.io.FileInputStream
qui représente le document Word protégé par une stratégie en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l'emplacement du document Word.com.adobe.idp.Document
en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream
.Supprimer la stratégie du document Word
DocumentManager
en appelant la méthode RightsManagementClient
de l'objet getDocumentManager
.DocumentManager
de l'objet removeSecurity
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é.Enregistrer le document Word non sécurisé
java.io.File
et assurez-vous que l'extension de fichier est DOC.Document
de l'objet copyToFile
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 Début rapide suivant :
Supprimez une stratégie d’un document Word protégé par une stratégie à l’aide de l’API Document Security (service Web) :
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
.
Remplacez localhost
par l’adresse IP du serveur hébergeant AEM Forms.
Création d’un objet API Client de sécurité Document
Créez un objet RightsManagementServiceClient
en utilisant son constructeur par défaut.
Créez un objet RightsManagementServiceClient.Endpoint.Address
en utilisant le constructeur System.ServiceModel.EndpointAddress
. Transmettez une valeur de chaîne 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 exécutant les tâches suivantes :
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
au champ BasicHttpBindingSecurity.Transport.ClientCredentialType
.Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly
au champ BasicHttpBindingSecurity.Security.Mode
.
Récupération d’un document Word protégé par une stratégie
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.System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l'emplacement du fichier du document Word et le mode d'ouverture du fichier.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
.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.BLOB
en attribuant son champ MTOM
au contenu du tableau d’octets.Supprimer la stratégie du document Word
Supprimez la stratégie du document Word en appelant la méthode RightsManagementServiceClient
de l'objet removePolicySecurity
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é.
Enregistrer le document Word non sécurisé
System.IO.FileStream
en appelant son constructeur et en transmettant une valeur de chaîne qui représente l'emplacement du fichier du document Word non sécurisé.BLOB
renvoyé par la méthode removePolicySecurity
. Renseignez le tableau d’octets en obtenant la valeur du champ BLOB
de l’objet MTOM
.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 Début rapide suivant :
Voir également
Appel de AEM Forms à l’aide de MTOM