SSL für JBoss Application Server konfigurieren

Zum Konfigurieren von SSL unter JBoss Application Server benötigen Sie eine SSL-Berechtigung für die Authentifizierung. Sie können das Java-Keytool zum Erstellen einer Berechtigung oder zum Anfordern und Importieren einer Berechtigung von einer Zertifizierungsstelle verwenden. Anschließend müssen Sie SSL unter JBoss aktivieren.

Sie können das Keytool mit einem einzelnen Befehl ausführen, der alle zum Erstellen des Keystore erforderlichen Informationen enthält.

In diesem Verfahren gilt:

• [appserver root] ist der Basisordner des Anwendungsservers, auf dem AEM Formulare ausgeführt werden.
• [type] ist ein Ordnername, der je nach der von Ihnen ausgeführten Installation variiert.

SSL-Berechtigung erstellen

1. Wechseln Sie an einer Eingabeaufforderung zum Ordner [JAVA HOME]/bin und geben Sie den folgenden Befehl ein, um die Berechtigung und den Keystore zu erstellen:

   keytool -genkey -dname "CN=Host , OU=NameGruppe , O=NameFirma ,L=NameStadt , S=** , C=LandCode" -alias "AEMForms Cert" -keyalg RSA -keypasskey_ -keystorepasswordkeystorename .keystore

   HINWEIS

   Ersetzen Sie [JAVA_HOME] durch den Ordner, in dem das JDK installiert ist, und ersetzen Sie den kursiv gedruckten Text durch die Werte, die mit Ihrer Umgebung übereinstimmen. Der Hostname ist der voll qualifizierte Domänenname des Anwendungsservers.

2. Geben Sie keystore_password ein, wenn Sie zur Eingabe eines Kennworts aufgefordert werden. Das Kennwort für den Keystore und der Schlüssel müssen identisch sein.

   HINWEIS

   keystore_password Das in diesem Schritt eingegebene Kennwort kann mit dem in Schritt 1 eingegebenen Kennwort (key_password) übereinstimmen oder anders sein.

3. Kopieren Sie den Ordner keystorename.keystore in den Ordner [appserver root]/server/[type]/conf, indem Sie einen der folgenden Befehle eingeben:

   • (Windows-Einzelserver) copy keystorename.keystore[appserver root]\standalone\configuration
   • (Windows-Servercluster) copy keystorename.keystore[appserver root]\domain\configuration
   • (Linux Single Server) cp keystorename.keystore [appserver root]/standalone/configuration
   • (Linux-Servercluster) cp <em>keystorename</em>.keystore<em>[appserver root]</em>/domain/configuration

4. Exportieren Sie die Zertifikatdatei durch Eingabe des folgenden Befehls:

   • (Einzelserver) keytool -export -alias "AEMForms Cert" -file AEMForms_cert.cer -keystore [appserver root]/standalone/configuration/keystorename.keystore
   • (Servercluster) keytool -export -alias "AEMForms Cert" -file AEMForms_cert.cer -keystore [appserver root]/domain/configuration/keystorename.keystore

5. Geben Sie das keystore_Kennwort ein, wenn Sie zur Eingabe eines Kennworts aufgefordert werden.

6. Kopieren Sie die Datei AEMForms_cert.cer in den Ordner [Anwendungsserver-Stammordner] \conf, indem Sie den folgenden Befehl eingeben:

   • (Windows-Einzelserver) copy AEMForms_cert.cer [appserver root]\standalone\configuration
   • (Windows-Servercluster) copy AEMForms_cert.cer [appserver root]\domain\configuration
   • (Linux Single Server) cp AEMForms _cert.cer [appserver root]\standalone\configuration
   • (Linux-Servercluster) cp AEMForms _cert.cer [appserver root]\domain\configuration

7. Zeigen Sie den Inhalt des Zertifikats durch Eingabe des folgenden Befehls an:

   • keytool -printcert -v -file [appserver root]\standalone\configuration\AEMForms_cert.cer
   • keytool -printcert -v -file [appserver root]\domain\configuration\AEMForms_cert.cer

8. So stellen Sie ggf. Schreibzugriff auf die Datei "cacerts"in [JAVA_HOME]\jre\lib\security zur Verfügung:

   • (Windows) Klicken Sie mit der rechten Maustaste auf die Datei „cacerts“, wählen Sie „Eigenschaften“ und deaktivieren Sie das Attribut „Schreibgeschützt“.
   • (Linux) Geben Sie chmod 777 cacerts ein

9. Importieren Sie das Zertifikat durch Eingabe des folgenden Befehls:

   keytool -import -alias “AEMForms Cert” -fileAEMForms_ .cer -keystorecertJAVA_HOME \jre\lib\security\cacerts

10. Geben Sie changeit als Kennwort ein. Dieses Kennwort ist das Standardkennwort für Java-Installationen. Eventuell wurde es von Ihrem Systemadministrator geändert.

11. Geben Sie bei Aufforderung für Trust this certificate? [no]: yes ein. Daraufhin wird die Bestätigung „Certificate was added to keystore“ angezeigt.

12. Wenn Sie die Verbindung über SSL von Workbench aus herstellen, müssen Sie das Zertifikat auf dem Workbench-Computer installieren.

13. Öffnen Sie in einem Texteditor die folgende Dateien zur Bearbeitung:

    • Einzelserver - [appserver root]/standalone/configuration/lc_<dbname/turnkey>.xml

    • Servercluster - [appserver root]/domain/configuration/host.xml

    • Servercluster - [appserver root]/domain/configuration/domain_<dbname>.xml

14. • Für Einzelserver Fügen Sie in der Datei „lc_<dbaname/tunkey>.xml“ Folgendes nach dem Abschnitt „<security-realms>“ ein:

    <security-realm name="SSLRealm">
    <server-identities>
    <ssl>
    <keystore path="C:/Adobe/Adobe_Experience_Manager_Forms/jboss/standalone/configuration/aemformses.keystore" keystore-password="changeit" alias="AEMformsCert" key-password="changeit"/>
    </ssl>
    </server-identities>
    </security-realm>
    

    Suchen Sie nach dem folgenden Code den Abschnitt <server>:

    <http-listener name="default" socket-binding="http" redirect-socket="https" max-post-size="104857600"/>

    Fügen Sie Folgendes dem <server>-Abschnitt hinzu, der nach dem obigen Code steht:

    <https-listener name="default-secure" socket-binding="https" security-realm="SSLRealm"/>
    

    • Fügen Sie für Servercluster im [Anwendungsserver-Stammordner] \domain\configuration\host.xml auf allen Knoten den folgenden <security-realms> Abschnitt hinzu:

    <security-realm name="SSLRealm">
    <server-identities>
    <ssl>
    <keystore path="C:/Adobe/Adobe_Experience_Manager_Forms/jboss/standalone/configuration/aemformses.keystore" keystore-password="changeit" alias="AEMForms Cert" key-password="changeit"/>
    </ssl>
    </server-identities>
    </security-realm>
    

    Suchen Sie auf dem primären Knoten des Serverclusters im Abschnitt [Anwendungsserver-Stammordner]\domain\configuration\domain_<dbname>.xml nach dem folgenden Code:

    <http-listener name="default" socket-binding="http" redirect-socket="https" max-post-size="104857600"/>

    Fügen Sie Folgendes dem <server>-Abschnitt hinzu, der nach dem obigen Code steht:

    <https-listener name="default-secure" socket-binding="https" security-realm="SSLRealm"/>
    

15. Ändern Sie die Werte für die Attribute keystoreFile und keystorePass in das Keystore-Kennwort, das Sie beim Erstellen des Keystore festgelegt haben.

16. Starten Sie den Anwendungsserver neu.

    • Für Turnkey-Installationen:

      • Klicken Sie in der Windows-Systemsteuerung auf Verwaltung und dann auf Dienste.
      • Wählen Sie JBoss für Adobe Experience Manager Forms.
      • Wählen Sie Aktion > Anhalten.
      • Warten Sie, bis als Status des Dienstes „Angehalten“ angezeigt wird.
      • Wählen Sie Aktion > Starten.

    • Für von Adobe vorkonfigurierte oder manuell konfigurierte JBoss-Installationen:

      • Wechseln Sie an einer Eingabeaufforderung zum Ordner [appserver root]/bin.

      • Beenden Sie den Server durch Eingabe des folgenden Befehls:

        • (Windows) shutdown.bat -S
        • (Linux) ./shutdown.sh -S

      • Warten Sie, bis der JBoss-Prozess vollständig heruntergefahren wurde. (Dies ist der Fall, wenn der JBoss-Prozess die Kontrolle wieder an das Terminal übergibt, in dem er gestartet wurde.)

      • Starten Sie den Server durch Eingabe des folgenden Befehls:

        • (Windows) run.bat -c <profile>
        • (Linux) ./run.sh -c <profile>

17. Um mit SSL auf Administration Console zuzugreifen, geben Sie in einem Webbrowser https://[host name]:[port]/adminui ein:

    Der SSL-Standardanschluss für JBoss ist 8443. Geben Sie von hier an beim Zugriff auf AEM Forms diesen Anschluss an.

Berechtigung von einer Zertifizierungsstelle anfordern

1. Wechseln Sie an einer Eingabeaufforderung zum Ordner [JAVA HOME]/bin und geben Sie den folgenden Befehl ein, um den Keystore und den Schlüssel zu erstellen:

   keytool -genkey -dname "CN=Host , OU=NameGruppe , O=NameFirma , L=NameStadt , S=** , C=NameLandCode" -alias "AEMForms Cert" -keyalg RSA -keypass-key_ -keystorepasswordkeystorename .keystore

   HINWEIS

   Ersetzen Sie [JAVA_HOME] durch den Ordner, in dem das JDK installiert ist, und ersetzen Sie den kursiv gedruckten Text durch die Werte, die mit Ihrer Umgebung übereinstimmen.

2. Geben Sie den folgenden Befehl ein, um eine Zertifikatanforderung an die Zertifizierungsstelle zu erzeugen:

   keytool -certreq -alias "AEMForms Cert" -keystore** .keystore -filekeystorenameAEMFormscertRequest.csr

3. Wenn Ihre Anforderung einer Zertifikatdatei erfüllt wurde, führen Sie die Schritte im nächsten Verfahren durch.

Berechtigung von einer Zertifizierungsstelle zum Aktivieren von SSL verwenden

1. Wechseln Sie an einer Eingabeaufforderung zum Ordner [JAVA HOME]/bin und geben Sie den folgenden Befehl ein, um das Stammzertifikat der Zertifizierungsstelle zu importieren, mit der die CSR-Datei signiert wurde:

   keytool -import -trustcacerts -file rootcert.pem -keystore keystorename.keystore -alias root

   Wenn sich das Stammzertifikat nicht im Browser befindet, importieren Sie es ebenfalls dorthin.

   HINWEIS

   Ersetzen Sie [JAVA_HOME]durch den Ordner, in dem das JDK installiert ist, und ersetzen Sie den kursiv gedruckten Text durch die Werte, die Ihrer Umgebung entsprechen.

2. Wechseln Sie an einer Eingabeaufforderung zum Ordner [JAVA HOME]/bin und geben Sie den folgenden Befehl ein, um die Berechtigung in den Keystore zu importieren:

   keytool -import -trustcacerts -file** .crt -keystoreCACertificateNamekeystorename .keystore

   HINWEIS

   • Ersetzen Sie [JAVA_HOME] durch den Ordner, in dem das JDK installiert ist, und ersetzen Sie den kursiv gedruckten Text durch die Werte, die mit Ihrer Umgebung übereinstimmen.
   • Das importierte, von der Zertifizierungsstelle signierte Zertifikat ersetzt ein selbst signiertes Zertifikat (sofern vorhanden).

3. Führen Sie die Schritte 13 bis 18 im Abschnitt „SSL-Berechtigung erstellen“ durch.