DocumentationAEM 6.4Guide de Forms

Installation et configuration des services de document installing-and-configuring-document-services

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Admin
CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

AEM Forms fournit un ensemble de services OSGi permettant d’effectuer différentes opérations au niveau du document, par exemple des services pour créer, assembler, distribuer et archiver des documents de PDF, ajouter des signatures numériques pour limiter l’accès aux documents et décoder des formulaires à code-barres. Ces services sont inclus dans le module complémentaire AEM Forms. Collectivement, ces services sont connus sous le nom de services de document. La liste des services de document disponibles et leurs principales fonctionnalités est la suivante :

  • Service Assembler : permet de combiner, d’organiser et d’étendre vos documents aux formats PDF et XDP et d’obtenir des informations sur les documents PDF. Ce service permet également de convertir et de valider des documents PDF au format PDF/A standard, il convertit les formulaires PDF et XML aux formats PDF/A-1b, PDF/A-2b et PDFA/A-3b. Pour plus d’informations, consultez la section Service Assembler.

  • Service ConvertPDF : permet de convertir des documents PDF en fichiers PostScript ou en images (aux formats JPEG, JPEG 2000, PNG et TIFF). Pour plus d’informations, consultez la section Service ConvertPDF.

  • Service Barcoded Forms : permet d’extraire des données depuis des images électroniques de code-barres. Il accepte en entrée des fichiers PDF et TIFF qui contiennent un ou plusieurs codes à barres et extrait les données de code à barres. Pour plus d’informations, consultez la section Service Barcoded Forms.

  • Service DocAssurance : permet de chiffrer et de déchiffrer des documents, d’ajouter des droits d’utilisation aux fonctionnalités d’Adobe Reader ou encore d’ajouter des signatures numériques à vos documents. Le service Doc Assurance se compose en fait de trois services : Signature, Encryption et Reader Extensions. Pour plus d’informations, consultez la section Service DocAssurance.

  • Service Encryption : permet de chiffrer et de déchiffrer des documents. Lorsqu’un document est chiffré, son contenu devient illisible. Un utilisateur ou une utilisatrice autorisé(e) peut déchiffrer le document pour pouvoir accéder à son contenu. Pour plus d’informations, consultez la section Service Encryption.

  • Service Forms : permet de créer des applications clientes interactives de capture de données assurant la validation, le traitement, la transformation et la transmission de formulaires généralement créés dans Forms Designer. Le service Forms restitue sous forme de documents PDF tout type de formulaire que vous créez. Pour plus d’informations, consultez la section Service Forms.

  • Service Output : permet de créer des documents dans différents formats, y compris PDF et les formats d’imprimantes laser et d’imprimantes d’étiquettes. Les formats d’imprimantes laser sont les suivants : PostScript et PCL (Printer Control Language). Pour plus d’informations, consultez la section Service Output.

  • Service PDF Generator : fournit des API pour convertir des formats de fichier natifs en PDF. Il convertit également des fichiers PDF en d’autres formats et optimise la taille des documents PDF. Pour plus d’informations, consultez la section Service PDF Generator.

  • Service Reader Extension : permet à votre organisation de partager facilement des documents PDF interactifs en ajoutant des droits dʼutilisation aux fonctionnalités dʼAdobe Reader. Ce service active des fonctionnalités indisponibles à l’ouverture d’un document PDF dans Adobe Reader, comme l’ajout de commentaires dans un document, le remplissage de formulaires et l’enregistrement du document. Pour plus d’informations, consultez la section Service Reader Extensions.

  • Service Signature : permet d’utiliser des documents et des signatures numériques sur le serveur AEM. Par exemple, le service Signature est généralement utilisé dans les situations suivantes :

    • Le serveur AEM certifie un formulaire avant qu’il ne soit envoyé à un utilisateur pour qu’il s’ouvre à l’aide d’Acrobat ou d’Adobe Reader.
    • Le serveur d’AEM valide la signature qui a été ajoutée à un formulaire à l’aide d’Acrobat ou d’Adobe Reader.
    • Le serveur AEM signe un formulaire au nom d'un notaire.

    Le service de signature accède aux certificats et aux informations d’identification stockées dans le trust store. Pour plus d’informations, consultez la section Service Signature.

AEM Forms est une plateforme d’entreprise performante et les services de documents ne sont quʼune des fonctionnalités proposées. Pour obtenir la liste complète des fonctionnalités, voir Présentation d’AEM Forms.

Topologie de déploiement deployment-topology

Le module complémentaire AEM Forms est une application déployée sur AEM. En règle générale, vous n’avez besoin que d’une seule instance AEM (auteur ou publication) pour exécuter AEM Forms Document Services. La topologie suivante est recommandée pour exécuter AEM Forms Document Services. Pour plus d’informations sur les topologies, voir Topologies d’architecture et de déploiement pour AEM Forms.

Topologies d’architecture et de déploiement pour AEM Forms

NOTE
Bien qu’AEM Forms vous permette de configurer et d’exécuter toutes les fonctionnalités à partir d’un seul serveur, vous devez planifier la capacité, équilibrer la charge et configurer des serveurs dédiés pour des fonctionnalités spécifiques dans un environnement de production. Par exemple, pour un environnement utilisant le service PDF Generator pour convertir des milliers de pages par jour et plusieurs formulaires adaptatifs pour capturer des données, configurez des serveurs AEM Forms distincts pour le service PDF Generator et les fonctionnalités de formulaires adaptatifs. Cela permet de fournir des performances optimales et de dimensionner les serveurs indépendamment les uns des autres.

Configuration requise system-requirements

Avant de commencer à installer et configurer AEM Forms Document Services, assurez-vous que :

  • Le matériel et l’infrastructure logicielle sont en place. Pour obtenir une liste détaillée des matériels et logiciels pris en charge, voir Conditions techniques applicables.

  • Le chemin d’installation de l’instance AEM ne contient pas d’espaces.

  • Une instance AEM est en cours d’exécution. Dans la terminologie AEM, une « instance » est une copie d’AEM s’exécutant sur un serveur en mode de création ou de publication. En règle générale, une seule instance AEM (auteur ou publication) est nécessaire pour exécuter AEM Forms Document Services :

    • Auteur: Instance d’AEM utilisée pour créer, télécharger et modifier du contenu et administrer le site web. Une fois que le contenu est publié, il est répliqué sur l’instance de publication.
    • Publier: Une instance AEM qui diffuse le contenu publié au public sur Internet ou sur un réseau interne.

  • Les exigences de mémoire sont respectées. Le package complémentaire AEM Forms nécessite :

    • 15 Go d’espace temporaire pour les installations basées sur Microsoft Windows.
    • 6 Go d’espace temporaire pour les installations Unix.

  • Les logiciels client requis pour que PDF Generator effectue la conversion sous Microsoft Windows et Linux sont installés :

NOTE
  • Sous Microsoft Windows, PDF Generator prend en charge les itinéraires de conversion WebKit, Acrobat WebCapture et PhantomJS pour convertir des fichiers HTML en documents PDF.
  • Sur les systèmes dʼexploitation UNIX, PDF Generator prend en charge les itinéraires de conversion WebKit et PhantomJS pour convertir des fichiers HTML en documents PDF.

Exigences supplémentaires pour les systèmes d’exploitation UNIX extrarequirements

Si vous utilisez un système d’exploitation UNIX, installez les packages suivants à partir du support d’installation du système d’exploitation correspondant :

  • expat
  • libxcb
  • freetype
  • libXau
  • libSM
  • zlib
  • libICE
  • libuuid
  • glibc
  • libXext
  • nss-softokn-freebl
  • fontconfig
  • libX11
  • libXrender
  • libXrandr
  • libXinerama

  • (Générateur de PDF uniquement) Installez la version 32 bits des bibliothèques libcurl, libcrypto et libssl et créez les liens symboliques ci-dessous. Les liens symboliques pointent vers la dernière version des bibliothèques respectives :

    • /usr/lib/libcurl.so
    • /usr/lib/libcrypto.so
    • /usr/lib/libssl.so

  • (PDF Generator uniquement) Le service PDF Generator prend en charge les itinéraires WebKit et PhantomJS pour convertir des fichiers HTML en documents PDF. Pour activer la conversion pour l’itinéraire PhantomJS, installez les bibliothèques 64 bits répertoriées ci-dessous. En règle générale, ces bibliothèques sont déjà installées. Si une bibliothèque est manquante, installez-la manuellement :

    • linux-gate.so.1
    • libz.so.1
    • libfontconfig.so.1
    • libfreetype.so.6
    • libdl.so.2
    • librt.so.1
    • libpthread.so.0
    • libstdc++.so.6
    • libm.so.6
    • libgcc_s.so.1
    • libc.so.6
    • ld-linux.so.2
    • libexpat.so.1

Configurations de pré-installation preinstallationconfigurations

Les configurations répertoriées dans la section Configurations de pré-installation ne s’appliquent qu’au service PDF Generator. Si vous ne configurez pas le service PDF Generator, vous pouvez ignorer la section de configuration préalable à l’installation.

Installation d’Adobe Acrobat et d’applications tierces install-adobe-acrobat-and-third-party-applications

Si vous prévoyez d’utiliser le service PDF Generator pour convertir des formats de fichiers natifs tels que Microsoft Word, Microsoft Excel, Microsoft PowerPoint, OpenOffice, WordPerfect X7 et Adobe Acrobat en documents PDF, assurez-vous que ces applications sont installées sur le serveur AEM Forms.

NOTE
  • Adobe Acrobat, Microsoft Word, Excel et PowerPoint sont disponibles uniquement pour Microsoft Windows. Si vous utilisez un système d’exploitation UNIX, installez OpenOffice pour convertir des fichiers texte enrichi et des fichiers Microsoft Office pris en charge en documents PDF.
  • Fermez toutes les boîtes de dialogue qui s’affichent après l’installation d’Adobe Acrobat et d’un logiciel tiers pour tous les utilisateurs configurés pour utiliser le service PDF Generator.
  • Démarrez tous les logiciels installés au moins une fois. Fermez toutes les boîtes de dialogue pour tous les utilisateurs configurés pour utiliser le service PDF Generator.

Après avoir installé Acrobat, ouvrez Microsoft Word. Sur l’onglet Acrobat, cliquez sur Créer un fichier PDF et convertissez un fichier .doc ou.docx disponible sur votre ordinateur en document PDF. Si la conversion fonctionne, AEM Forms est prêt à utiliser Acrobat avec le service PDF Generator.

Configuration des variables d’environnement setup-environment-variables

Définissez des variables d’environnement pour Java Development Kit 32 bits et 64 bits, des applications tierces et Adobe Acrobat. Les variables d’environnement doivent contenir le chemin d’accès absolu de l’exécutable utilisé pour démarrer l’application correspondante, par exemple, le tableau ci-dessous répertorie les variables d’environnement pour quelques applications :

Application
Variable d’environnement
Exemple
JDK (64 bits)
JAVA_HOME
C:\Program Files\Java\jdk1.8.0_74
JDK (32 bits)
JAVA_HOME_32
C:\Program Files (x86)\Java\jdk1.8.0_74
Adobe Acrobat
Acrobat_PATH
C:\Program Files (x86)\Adobe\Acrobat 2015\Acrobat\Acrobat.exe
Bloc-notes
Notepad_PATH
C:\WINDOWS\notepad.exe
OpenOffice
OpenOffice_PATH
C:\Program Files (x86)\OpenOffice.org4
NOTE

  • Toutes les variables d’environnement et les chemins respectifs sont sensibles à la casse.

  • JAVA_HOME, JAVA_HOME_32 et Acrobat_PATH (Windows uniquement) sont des variables d’environnement obligatoires.

  • La variable d’environnement OpenOffice_PATH est définie sur le dossier d’installation et non pas sur le chemin d’accès au fichier exécutable.

  • Ne définissez pas de variables d’environnement pour des applications Microsoft Office telles que Word, PowerPoint, Excel et Project, ni pour des applications AutoCAD. Si ces applications sont installées sur le serveur, le service Generate PDF lance automatiquement ces applications.

  • Sur les plateformes UNIX, installez OpenOffice en tant que /root. Si OpenOffice n’est pas installé en tant que root, le service PDF Generator ne parvient pas à convertir les documents OpenOffice en documents PDF. Si vous devez installer et exécuter OpenOffice en tant qu’utilisateur non root, indiquez les droits sudo pour l’utilisateur non-root.

  • Si vous utilisez OpenOffice sur une plateforme UNIX, exécutez la commande suivante pour définir la variable de chemin :

    export OpenOffice_PATH=/opt/openoffice.org4

(Uniquement pour IBM WebSphere) Configuration du fournisseur de socket SSL IBM only-for-ibm-websphere-configure-ibm-ssl-socket-provider

Pour configurer le fournisseur de socket SSL IBM, procédez comme suit :

  1. Créez une copie du fichier java.security. L’emplacement par défaut du fichier est [WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security.

  2. Ouvrez le fichier java.security copié pour le modifier.

  3. Modifiez les usines de socket SSL par défaut pour utiliser les usines JSSE2 au lieu des usines IBM WebSphere par défaut :

    Contenu par défaut:

    code language-shell 
    #ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
#ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
#WebSphere socket factories (in cryptosf.jar)
ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory

    Contenu modifié :

    code language-shell 
    ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl

#WebSphere socket factories (in cryptosf.jar)
#ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
#ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory

  4. Pour permettre au serveur AEM Forms d'utiliser le fichier java.security mis à jour, lors du démarrage du serveur AEM Forms, ajoutez l'argument java suivant :

    -Djava.security.properties= [path of newly created Java.security file].

(Windows uniquement) Configurer et installer le service d’encre et de reconnaissance de l’écriture manuscrite configure-install-ink-and-handwriting-service

Si vous exécutez Microsoft Windows Server, configurez le service d’encre et de reconnaissance de l’écriture manuscrite. Le service est nécessaire pour ouvrir des fichiers Microsoft PowerPoint qui utilisent des fonctions d’encre de Microsoft Office :

  1. Ouvrez le Gestionnaire de serveur. Cliquez sur le bouton Gestionnaire de serveur sur la barre de lancement rapide.
  2. Cliquez sur Ajouter des fonctions dans le menu Fonctions. Cochez la case Services d’encre et de reconnaissance de l’écriture manuscrite.
  3. Boîte de dialogue Sélectionner des fonctionnalités avec l’option Services d’encre et de reconnaissance de l’écriture manuscrite cochée. Cliquez sur Installer pour installer le service.

(Windows uniquement) Configurer les paramètres de blocage des fichiers pour Microsoft Office configure-the-file-block-settings-for-microsoft-office

Modifiez les paramètres du Centre de gestion de la confidentialité de Microsoft Office pour permettre au service PDF Generator de convertir les fichiers créés avec des versions plus anciennes de Microsoft Office.

  1. Ouvrez une application Microsoft Office. Par exemple, Microsoft Word. Accédez à Fichier  >Options. La boîte de dialogue Options s’affiche.

  2. Cliquez sur Centre de gestion, puis cliquez sur Paramètres du Centre de gestion de la confidentialité.

  3. Dans le Paramètres de Trust Center, cliquez sur Paramètres de bloc de fichier.

  4. Dans la liste Type de fichier, désélectionnez l’option Ouvrir pour le type de fichier que le service PDF Generator devrait être autorisé à convertir en documents PDF.

(Windows uniquement) Accorder le droit Remplacer un jeton de niveau processus grant-the-replace-a-process-level-token-privilege

Le compte utilisateur utilisé pour démarrer le serveur d’applications requiert le Remplacer un jeton de niveau processus privilège. Le compte système local a la variable Remplacer un jeton de niveau processus par défaut. Pour les serveurs s’exécutant avec un utilisateur du groupe Administrateurs locaux, le privilège doit être accordé explicitement. Effectuez les étapes suivantes pour accorder le privilège :

  1. Ouvrez l’éditeur de stratégie de groupe de Microsoft Windows. Pour ouvrir l’éditeur de stratégie de groupe, cliquez sur Démarrer, saisissez gpedit.msc dans la zone Lancer la recherche, puis cliquez sur Éditeur de stratégie de groupe.
  2. Accédez à Stratégie d’ordinateur local > Configuration de l’ordinateur > Paramètres Windows > Paramètres de protection > Stratégies locales > Attribution des droits utilisateur et modifiez la variable Remplacer un jeton de niveau processus et incluez le groupe Administrateurs .
  3. Ajoutez l’utilisateur à l’entrée Remplacer un jeton de niveau processus .

(Windows uniquement) Activer le service PDF Generator pour les utilisateurs non-administrateurs enable-the-pdf-generator-service-for-non-administrators

Vous pouvez permettre à un utilisateur non-administrateur d’utiliser le service PDF Generator. Normalement, seuls les utilisateurs disposant de droits d’administrateur peuvent utiliser le service :

  1. Créez une variable d’environnement PDFG_NON_ADMIN_ENABLED.
  2. Définissez la valeur de la variable d’environnement sur TRUE.
  3. Redémarrez l’instance AEM Forms.

(Windows uniquement) Désactiver le contrôle de compte d’utilisateur (UAC) disable-user-account-control-uac

  1. Pour accéder à l’utilitaire de configuration système, sélectionnez Démarrer > Exécuter et saisissez MSCONFIG.

  2. Cliquez sur l’onglet Outils, faites défiler l’écran vers le bas, puis sélectionnez Modifier les paramètres de contrôle de compte d’utilisateur. Cliquez sur Démarrer pour lancer la commande dans une nouvelle fenêtre.

  3. Déplacez le curseur sur le niveau Ne jamais m’avertir. Cela fait, fermez la fenêtre de commande, puis celle de la configuration du système.

  4. Vérifiez que le paramètre de registre pour l’UAC est défini sur 0 (zéro). Pour vérifier, procédez comme suit :

    1. Microsoft recommande de sauvegarder le registre avant de le modifier. Pour obtenir la procédure détaillée, voir Comment sauvegarder et restaurer le registre dans Windows.
    2. Ouvrez l’éditeur du registre Windows de Microsoft. Pour ouvrir l’éditeur de registre, accédez à Démarrer > Exécuter, saisissez regedit, puis cliquez sur OK.
    3. Accédez à HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\. Assurez-vous que la valeur de EnableLUA est définie sur 0 (zéro).
    4. Assurez-vous que la valeur de EnableLUA est définie sur 0 (zéro). Si la valeur n’est pas 0, remplacez la valeur par 0. Fermez l’éditeur de registre.

  5. Redémarrez votre ordinateur.

(Windows uniquement) Désactiver le service de rapport d’erreur disable-error-reporting-service

Lors de la conversion d’un document au format PDF à l’aide du service PDF Generator sous Windows Server, ce dernier signale parfois que le fichier exécutable a rencontré un problème et doit se fermer. Cependant, elle n’a aucune incidence sur la conversion du PDF, car elle se poursuit en arrière-plan.

Pour éviter de recevoir l’erreur, vous pouvez désactiver le rapport d’erreur Windows. Pour en savoir plus sur la désactivation des rapports d’erreur, consultez la section https://technet.microsoft.com/en-us/library/cc754364.aspx.

(Windows uniquement) Configurer la conversion de fichiers HTML en PDF configure-html-to-pdf-conversion

Le service PDF Generator fournit des méthodes ou des itinéraires WebKit, WebCapture et PhantomJS pour convertir des fichiers HTML en documents PDF. Sous Windows, pour activer la conversion des itinéraires WebKit et Acrobat WebCapture, copiez la police Unicode vers le répertoire %windir%\fonts.

NOTE
À chaque installation de nouvelles polices dans le dossier de polices, redémarrez l’instance AEM Forms.

(Plateformes UNIX uniquement) Configurations supplémentaires pour la conversion de fichiers HTML en PDF extra-configurations-for-html-to-pdf-conversion

Sur les plateformes UNIX, le service PDF Generator prend en charge les itinéraires WebKit et PhantomJS pour convertir des fichiers HTML en documents PDF. Pour activer la conversion HTML vers PDF, effectuez les configurations suivantes, applicables à l’itinéraire de conversion de votre choix :

(Plateformes UNIX uniquement) Activer la prise en charge des polices Unicode (WebKit uniquement) enable-support-for-unicode-fonts-webkit-only

Copiez la police Unicode vers l’un des répertoires suivants, en fonction de votre système d’exploitation :

  • /usr/lib/X11/fonts/TrueType
  • /usr/share/fonts/default/TrueType
  • /usr/X11R6/lib/X11/fonts/ttf
  • /usr/X11R6/lib/X11/fonts/truetype
  • /usr/X11R6/lib/X11/fonts/TrueType
  • /usr/X11R6/lib/X11/fonts/TTF
  • /usr/openwin/lib/X11/fonts/TrueType (Solaris)
NOTE
  • Sur RedHat Enterprise Linux 6.x et versions ultérieures, les polices Courier ne sont pas disponibles. Pour installer les polices Courier, téléchargez l’archive font-ibm-type1-1.0.3.zip. Extrayez l’archive sous /usr/share/fonts. Créez un lien symbolique de /usr/share/X11/fonts vers /usr/share/fonts.
  • Supprimez tous les fichiers de cache de polices .lst des répertoires Html2PdfSvc/bin et /usr/share/fonts.
  • Vérifiez que les répertoires /usr/lib/X11/fonts et /usr/share/fonts existent. Si les répertoires n’existent pas, utilisez la commande ln pour créer un lien symbolique de /usr/share/X11/fonts vers /usr/lib/X11/fonts et un autre lien symbolique de /usr/share/fonts vers /usr/share/X11/fonts. Vérifiez également que les polices Courier sont disponibles à l’adresse /usr/lib/X11/fonts.
  • Vérifiez que toutes les polices (Unicode et non Unicode) sont disponibles dans le répertoire /usr/share/fonts ou /usr/share/X11/fonts.
  • Lorsque vous exécutez le service PDF Generator en tant qu’utilisateur non root, donnez à l’utilisateur non root un accès en lecture et en écriture à tous les répertoires de polices.
  • À chaque installation de nouvelles polices dans le dossier de polices, redémarrez l’instance AEM Forms.

Installation du package complémentaire AEM Forms install-aem-forms-add-on-package

Le module complémentaire AEM Forms est une application déployée sur AEM. Le package contient AEM Forms Document Services et d’autres fonctionnalités AEM Forms. Pour installer le package, procédez comme suit :

  1. Ouvrez la Distribution de logiciels. Vous avez besoin d’un Adobe ID pour vous connecter à la Distribution de logiciels.

  2. Appuyez sur  Adobe Experience Manager  disponible dans le menu d’en-tête.

  3. Dans le Filtres section :

    1. Sélectionner Forms de la Solution liste déroulante.
    2. Sélectionnez la version et le type du package. Vous pouvez également utiliser l’option  Rechercher des téléchargements pour filtrer les résultats.

  4. Appuyez sur le nom de package applicable à votre système d’exploitation, sélectionnez  Accepter les conditions du CLUF, puis appuyez sur Télécharger.

  5. Ouvrez Package Manager et cliquez sur  Télécharger le package  pour télécharger le package.

  6. Sélectionnez le package et cliquez sur  Installer.

    Vous pouvez également télécharger le package via le lien direct répertorié dans l’article Version d’AEM Forms.

  7. Une fois le package installé, vous êtes invité à redémarrer l’instance AEM. N’arrêtez pas le serveur immédiatement. Avant d’arrêter le serveur AEM Forms, attendez que les messages ServiceEvent REGISTERED et ServiceEvent UNREGISTERED cessent d’apparaître dans le fichier [AEM-Installation-Directory]/crx-quickstart/logs/error.log et que le journal soit stable.

Configurations post-installation post-installation-configurations

Configuration de Boot Delegation pour les bibliothèques RSA/BouncyCastle configure-boot-delegation-for-rsa-bouncycastle-libraries

  1. Désactivez l’instance AEM. Accédez au dossier [Répertoire d’installation AEM]\crx-quickstart\conf. Ouvrez le fichier sling.properties pour modification.

    Si vous utilisez [AEM installation directory]\crx-quickstart\bin\start.bat pour démarrer une instance AEM, modifiez le fichier sling.properties situé à l’emplacement suivant :[AEM_root]\crx-quickstart\.

  2. Ajoutez les propriétés suivantes au fichier sling.properties :

    code language-none 
    sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
sling.bootdelegation.class.org.bouncycastle.jce.provider.BouncyCastleProvider=org.bouncycastle.*

  3. (AIX uniquement) Ajoutez les propriétés suivantes au fichier sling.properties :

    code language-none 
    sling.bootdelegation.xerces=org.apache.xerces.*

  4. Enregistrez et fermez le fichier.

Configuration du service de gestion de polices configuring-the-font-manager-service

  1. Connectez-vous à AEM Configuration Manager en tant qu’administrateur.

  2. Recherchez et ouvrez le service CQ-DAM-Handler-Gibson Font Managers. Indiquez le chemin d’accès des répertoires des polices système, Adobe Server et client. Cliquez sur Enregistrer.

    note note
    NOTE
    Vos droits d’utilisation relatifs aux polices fournies par des sociétés autres qu’Adobe sont régis par les contrats de licence accompagnant ces polices. Ils ne sont pas couverts par la licence d’utilisation du logiciel Adobe qui vous est concédée. Adobe vous recommande de vérifier et de vous assurer que vous êtes conforme à tous les contrats de licence non-Adobe applicables avant d’utiliser des polices non-Adobe avec un logiciel Adobe, notamment en ce qui concerne l’utilisation de polices dans un environnement serveur.
    Lorsque vous installez de nouvelles polices dans le dossier de polices, redémarrez l’instance AEM Forms.

Configuration d’un compte d’utilisateur local pour exécuter le service PDF Generator configure-a-local-user-account-to-run-the-pdf-generator-service

Un compte d’utilisateur local est requis pour exécuter le service PDF Generator. Pour les étapes de création d’un utilisateur local, voir Créer un compte d’utilisateur dans Windows ou créer un compte d’utilisateur sur des plateformes UNIX.

  1. Ouvrez la page Configuration de PDF Generator dans AEM Forms.

  2. Dans l’onglet Comptes d’utilisateurs, saisissez les informations d’identification d’un compte d’utilisateur local, puis cliquez sur Envoyer. Si Microsoft Windows vous y invite, autorisez l’accès à l’utilisateur. Une fois ajouté, l’utilisateur configuré est affiché sous la section Vos comptes d’utilisateurs dans l’onglet Comptes d’utilisateurs.

Configuration des paramètres de délai d’expiration configure-the-time-out-settings

  1. Dans AEM Configuration Manager, recherchez et ouvrez le service  Jacorb ORB Provider.

    Ajoutez l’élément suivant au champ Properties.name personnalisé et cliquez sur Enregistrer. Il définit le délai de la réponse en attente (également appelé délai d’attente du client CORBA) à 600 secondes.

    jacorb.connection.client.pending_reply_timeout=600000

  2. Connectez-vous à l’instance de création AEM et accédez à Adobe Experience Manager  > Outils  > Forms  > Configuration de PDF Generator. L’URL par défaut est http://localhost:4502/libs/fd/pdfg/config/ui.html.

    Ouvrez le Configuration générale et modifiez la valeur des champs suivants pour votre environnement :

Champ
Description
Valeur par défaut
Expiration de conversion sur le serveur
Une conversion PDFG reste active pendant le nombre de secondes définies dans le délai de conversion du serveur.
270 secondes
Secondes d'analyse de nettoyage PDFG
Nombre de secondes requises pour effectuer des opérations après la conversion.
3600 secondes
Secondes avant expiration de la tâche
Durée pendant laquelle le service PDF Generator est autorisé à exécuter une conversion. Assurez-vous que la valeur de Secondes avant expiration de la tâche est supérieure à celle de Secondes d’analyse de nettoyage PDFG.
7200 secondes

(Windows uniquement) Configurer Acrobat pour le service PDF Generator configure-acrobat-for-the-pdf-generator-service

Sous Microsoft Windows, le service PDF Generator utilise Adobe Acrobat pour convertir les formats de fichiers pris en charge en document PDF. Pour configurer Adobe Acrobat pour le service PDF Generator, procédez comme suit :

  1. Ouvrez Acrobat et sélectionnez Modifier > Préférences > Mises à jour. Dans Rechercher les mises à jour maintenant, décochez Installer automatiquement les mises à jour et cliquez sur OK. Fermez Acrobat.

  2. Cliquez deux fois sur un document PDF sur votre système. Lorsque Acrobat démarre pour la première fois, les boîtes de dialogue de connexion, d’écran de bienvenue et de CLUF s’affichent. Fermez ces boîtes de dialogue pour tous les utilisateurs configurés pour utiliser PDF Generator.

  3. Exécutez le fichier de commandes de l’utilitaire PDF Generator pour configurer Acrobat pour le service PDF Generator :

    1. Ouvrez AEM Package Manager et téléchargez le fichier adobe-aemfd-pdfg-common-pkg-[version].zip depuis le gestionnaire de packages.

    2. Décompressez le fichier .zip téléchargé. Ouvrez l’invite de commande avec les privilèges d’administrateur.

    3. Accédez au répertoire [extracted-zip-file]\jcr_root\etc\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\scripts. Exécutez le fichier de commandes suivant :

      Acrobat_for_PDFG_Configuration.bat

      Acrobat est configuré pour s’exécuter avec le service PDF Generator.

  4. Exécutez l’outil de préparation du système pour valider l’installation d’Acrobat. L’outil vérifie que l’ordinateur est correctement configuré pour exécuter les conversions PDF Generator et génère un rapport au chemin indiqué:

    1. Ouvrez une invite de commandes et accédez au dossier [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\etc\fd\ pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\srt. Exécutez la commande suivante à partir de l’invite de commande :

      cscript SystemReadinessTool.vbs [Path_of_reports_folder] en

      note note
      NOTE
      Si l’outil System Readiness signale que le fichier pdfgen.api n’est pas disponible dans le dossier des plug-ins Acrobat, copiez le fichier pdfgen.api du répertoire [extracted-adobe-aemfd-pdfg-common-pkg]\plugins\x86_win32 au répertoire [Acrobat_root]\Acrobat\plug_ins.

    2. Accédez à [Path_of_reports_folder]. Ouvrez le fichier SystemReadinessTool.html. Vérifiez le rapport et résolvez les problèmes mentionnés.

(Windows uniquement) Configurer l’itinéraire principal pour la conversion de fichiers HTML en PDF configure-primary-route-for-html-to-pdf-conversion-windows-only

Le service PDF Generator fournit plusieurs itinéraires pour convertir des fichiers HTML en documents PDF : WebKit, Acrobat WebCapture (Windows uniquement) et PhantomJS. Adobe recommande d’utiliser l’itinéraire PhantomJS, car il peut gérer le contenu dynamique, ne dépend pas des bibliothèques 32 bits, JDK 32 bits et ne nécessite aucune police supplémentaire. En outre, l’itinéraire PhantomJS ne nécessite pas l’accès sudo ou root pour exécuter la conversion.

Webkit constitue l’itinéraire Principal par défaut pour la conversion du HTML vers le PDF. Pour modifier l’itinéraire de conversion :

  1. Sur l’instance de création AEM, accédez à Outils  > Forms  > Configuration de PDF Generator.

  2. Dans l’onglet Configuration générale, sélectionnez l’itinéraire de votre choix dans le menu déroulant Itinéraire principal pour les conversions HTML en PDF.

Initialisez Global Trust Store intialize-global-trust-store

Trust Store Management vous permet d’importer, de modifier et de supprimer des certificats de confiance sur le serveur pour la validation des signatures numériques et l’authentification de certificats. Vous pouvez importer et exporter un nombre illimité de certificats. Une fois un certificat importé, vous pouvez modifier les paramètres d’approbation et le type de Trust Store. Pour initialiser un Trust Store, procédez comme suit :

  1. Connectez-vous à une instance AEM Forms en tant qu’administrateur.
  2. Accédez à Outils > Sécurité > Trust Store.
  3. Cliquez sur Créer un Trust Store. Définissez le mot de passe, puis cliquez sur Enregistrer.

Configurer des certificats pour l’extension et le service de chiffrement des Readers set-up-certificates-for-reader-extension-and-encryption-service

Le service DocAssurance peut appliquer des droits d’utilisation aux documents du PDF. Pour appliquer des droits d’utilisation aux documents PDF, configurez les certificats :

Avant de configurer des certificats, assurez -vous que vous disposez des éléments suivants :

  • Fichier de certificat (.pfx).

  • Mot de passe de la clé privée fourni avec le certificat.

  • Alias de la clé privée. Vous pouvez exécuter la commande Java keytool pour afficher l’alias de la clé privée :
    keytool -list -v -keystore [keystore-file] -storetype pkcs12

  • Mot de passe du fichier de stockage de clés. Si vous utilisez le certificat Reader Extensions d’Adobe, le mot de passe du fichier KeyStore est toujours identique au mot de passe de la clé privée.

Pour configurer les certificats, procédez comme suit :

  1. Connectez-vous à l’instance Auteur AEM en tant qu’administrateur. Accédez à Outils > Sécurité > Utilisateurs.

  2. Cliquez sur le champ nom du compte d’utilisateur ou d’utilisatrice. La page Modifier les paramètres utilisateur s’affiche. Sur l’instance d’auteur AEM, les certificats résident dans un KeyStore. Si vous n’avez pas créé de KeyStore précédemment, cliquez sur Créer KeyStore et définissez un nouveau mot de passe pour le KeyStore. Si le serveur contient déjà un KeyStore, ignorez cette étape. Si vous utilisez le certificat Reader Extensions d’Adobe, le mot de passe du fichier Key Store est toujours identique au mot de passe de la clé privée.

  3. Sur la page Modifier les paramètres utilisateur, sélectionnez lʼonglet KeyStore. Développez l’option Ajouter la clé privée à partir du fichier de magasin de clés, puis fournissez un alias. L’alias est utilisé pour effectuer l’opération Reader Extensions.

  4. Pour télécharger le fichier de certificat, cliquez sur Sélectionner le fichier du magasin de clés, puis téléchargez un fichier <filename>.pfx.

    Ajoutez les mot de passe du magasin de clés, mot de passe de la clé privée et alias de la clé privée associés au certificat dans les champs respectifs. Cliquez sur Envoyer.

    note note
    NOTE
    Dans l’environnement de production, remplacez les informations d’identification d’évaluation par celles de production. Veillez à supprimer vos anciennes informations d’identification Reader Extensions avant de mettre à jour des informations d’identification expirées ou d’évaluation.

  5. Cliquez sur Enregistrer et fermer sur la page Modifier les paramètres utilisateur.

Activation d’AES-256 enable-aes

Pour utiliser le chiffrement AES 256 pour les fichiers de PDF, récupérez et installez les fichiers Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy. Remplacez les fichiers local_policy.jar et US_export_policy.jar dans le dossier jre/lib/security. Par exemple, si vous utilisez Sun JDK, copiez les fichiers téléchargés dans le dossier [JAVA_HOME]/jre/lib/security.

Le service Assembler dépend du service Reader Extensions, du service Signature, du service Forms et du service Output. Effectuez les étapes suivantes pour vérifier que les services requis sont opérationnels :

  1. Connectez-vous à lʼadresse https://'[server]:[port]'/system/console/bundles en tant qu’administrateur.
  2. Recherchez le service suivant et vérifiez que les services sont en cours d’exécution :
Nom du service
Nom du lot
Service Signatures
adobe-aemfd-signatures
Service Reader Extensions
com.adobe.aemfd.adobe-aemfd-readerextensions
Service Forms
com.adobe.livecycle.adobe-lc-forms-bedrock-connector
Service Output
com.adobe.livecycle.adobe-lc-forms-bedrock-connector

Problèmes connus et résolution des problèmes known-issues-and-troubleshooting

  • La conversion HTML vers PDF échoue si un fichier d’entrée compressé contient des fichiers de HTML dont le nom contient des caractères codés sur deux octets. Pour éviter ce problème, n’utilisez pas de caractères codés sur deux octets lors de l’attribution de noms aux fichiers de HTML.

  • Sur les systèmes d’exploitation UNIX, procédez comme suit pour rechercher les bibliothèques manquantes :

  1. Accéder à [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/.

  2. Exécutez la commande suivante pour répertorier toutes les bibliothèques requises par PhantomJS pour convertir un fichier HTML en PDF.

    ldd phantomjs

    Exécutez la commande suivante pour répertorier les bibliothèques manquantes.

    ldd phantomjs | grep not

  3. Installez manuellement les bibliothèques manquantes.

Étapes suivantes next-steps

Vous disposez d’un environnement de services de document AEM Forms opérationnel. Vous pouvez utiliser les services de document via :

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da