Keystore-Konfigurationen für SSL

In Keystore-Konfigurationen können Sie definieren, wie die Laufzeit von WebSphere Application Server Keystore-Typen für SSL-Konfigurationen lädt und verwaltet.

Das Attribut "java.security.Security.getAlgorithms("KeyStore")" zeigt standardmäßig keine vordefinierte Liste von Keystore-Typen in der Administrationskonsole an. Stattdessen ruft WebSphere Application Server alle Keystore-Typen ab, die vom Objekt "java.security.KeyStore" referenziert werden können, einschließlich Hardwareverschlüsselungskeystores, Keystores der Plattform z/OS, Keystores der Plattform IBM® i, IBMJCE-Keystores (IBM Java™ Cryptography Extension) und Java-basierten-CMS-Provider-Keystores (CMS, Certificate Management Services). Wenn Sie in der Datei java.security einen Keystore-Provider angeben oder programmgesteuert einen Keystore-Provider zur Liste hinzufügen, ruft WebSphere Application Server auch angepasste Keystores ab. Die Abrufliste hängt von der java.security-Konfiguration für die jeweilige Plattform und den jeweiligen Prozess ab.

Dateibasierte IBMJCE-Keystores (JCEKS, JKS und PKCS12)

Der folgende Beispielcode zeigt eine typische Konfiguration für einen dateibasierten IBMJCE-Keystore:
<keyStores xmi:id="KeyStore_1" name="NodeDefaultKeyStore" 
password="{xor}349dkckdd=" provider="IBMJCE"
location="${USER_INSTALL_ROOT}/config/cells/myhostNode01Cell
/nodes/myhostNode01/key.p12" type="PKCS12" fileBased="true" 
hostList="" initializeAtStartup="true" readOnly="false" 
description="Default key store for myhostNode01" usage="SSLKeys" 
managementScope="ManagementScope_1"/>
Weitere Informationen zu Standardkeystorekonfigurationen finden Sie unter Standardkonfiguration mit verkettetem Zertifikat in SSL.
In Tabelle 1 sind die Attribute beschrieben, die im Beispielcode verwendet werden.
Tabelle 1. Keystore-Konfigurationen . In der folgenden Tabelle sind die Keystorekonfigurationen beschrieben.
Attributname Standardeinstellung Beschreibung
xmi:id veränderlich Ein Wert, der abgesetzt wird, um den Keystore von einem anderen Bereich der Konfiguration aus zu referenzieren, z. B. von einer SSL-Konfiguration aus. Dieser Wert muss innerhalb der Datei security.xml eindeutig sein.
name Für einen JSSE-Keystore (Java Secure Socket Extension): NodeDefaultKeyStore. Für einen JSSE-Truststore: NodeDefaultTrustStore. Ein Name, mit dem der Keystore identifiziert werden kann, wenn er sichtbar ist. Anhand der Endung des Namens auf DefaultKeyStore oder DefaultTrustStore lässt sich feststellen, ob es sich um einen Standard-Keystore handelt.
password Das Keystore-Standardkennwort ist WebAS. Sie sollten dieses Kennwort so bald wie möglich ändern. Nähere Informationen finden Sie im Artikel Mit Scripting die Standardkennwörter für die Keystores ändern. Das Kennwort für den Zugriff auf den Keystore-Namen wird auch zum Speichern von Schlüsseln im Keystore verwendet.
description Keine Eine Beschreibung des Keystores.
usage Ein Attribut, das angibt, für welchen Zweck der Keystore verwendet wird. Die gültigen Werte sind SSLKeys, KeySetKeys, RootKeys, DeletedKeys, DefaultSigners, RSATokenKeys.
provider Der Standardprovider ist IBMJCE. Der Java-Provider, der das Attribut "type" implementiert (z. B. Typ PKCS12). Sie müssen keinen Provider angeben. In diesem Fall wird der erste Provider verwendet, der den angegebenen Keystoretyp implementiert.
location Der Standardwert ist variabel, referenziert jedoch normalerweise eine Datei mit dem Namen key.p12 oder trust.p12 in den Knoten- oder Zellenverzeichnissen des Konfigurationsrepositorys. Diese Dateien sind Keystores vom Typ PKCS12. Die Referenz auf die Keystore-Position. Wenn der Keystore dateibasiert ist, kann die Position jeden Pfad im Dateisystem des Knotens mit dem Keystore referenzieren. Wenn die Position jedoch außerhalb des Konfigurationsrepositorys liegt und Sie den Keystore fern von der Administrationskonsole oder dem Dienstprogramm wsadamin aus verwalten möchten, geben Sie das Attribut hostList mit dem Namen des Knotens an, auf dem sich der Keystore befindet.
type Der Standard-Java-Keystore-Typ für Verschlüsselungseinheiten ist PKCS12. Dieser Typ gibt den Keystore an. Gültige Typen können die vom Attribut java.security.Security.getAlgorithms("KeyStore") zurückgegebenen Typen sein. Dazu gehören folgende Keystore-Typen, deren Verfügbarkeit von der Prozess- und Plattformkonfiguration in java.security abhängt:
  • JKS
  • JCEKS
  • PKCS12
  • PKCS11 (Java-Verschlüsselungseinheit)
  • CMSKS
  • IBMi5OSKeyStore
  • JCERACFKS
  • JCECCAKS-Keystores (ersetzen JCE4758KS) - (z/OS-Verschlüsselungseinheit)
fileBased Die Standardeinstellung ist true. Diese Option ist für Standard-Keystores erforderlich. Sie gibt einen Keystore im Dateisystem an, den Sie mit einem FileInputStream oder FileOutputStream laden bzw. speichern können.
hostList Das Attribut hostList gibt den Namen eines fernen Hosts an, damit der Keystore fern verwaltet werden kann. Standardmäßig gibt es keine fern verwalteten Keystores. Alle Standard-Keystores werden lokal im Konfigurationsrepository verwaltet und auf allen Knoten synchronisiert. Mit dieser Option wird ein Keystore fern verwaltet. Als Hostnamen können Sie einen gültigen Knoten für einen Keystore angeben. Wenn Sie die Zertifikate für diesen Keystore mit der Administrationskonsole oder dem Dienstprogramm wsadmin verwalten, wird an den Knoten, auf dem sich der Keystore befindet, ein MBean-Aufruf für die freigegebene Operation abgesetzt. Sie können mehrere Hosts angeben, obwohl die Synchronisation der Keystore-Operationen nicht gewährleistet werden kann. Einer der aufgelisteten Hosts könnte beispielsweise heruntergefahren sein, während eine bestimmte Operation ausgeführt wird. Mehrere Hosts sollten Sie daher in dieser Liste angeben.
initializeAtStartup Die Standardeinstellung ist true. Diese Option teilt der Laufzeit mit, dass der Keystore beim Systemstart initialisiert werden soll. Sie kann für die Beschleunigung von Hardwareverschlüsselungseinheiten bedeutsam sein.
readOnly Die Standardeinstellung ist false. Diese Option teilt der Konfiguration mit, dass Sie nicht in diesen Keystore schreiben dürfen. Bestimmte Aktualisierungsoperationen für den Keystore sind damit unzulässig und können nicht ausgeführt werden. Ein Beispiel für einen schreibgeschützten Keystore-Typ der z/OS-Plattform ist JCERACFKS. Dieser Typ ist aus Sicht des WebSphere-Zertifikatmanagements schreibgeschützt, kann jedoch mit der Keystore-Verwaltungsfunktion für RACF aktualisiert werden.
managementScope Der Standardbereich ist der Knotenbereich für eine Base Application Server-Umgebung und der Zellenbereich für eine Network Deployment-Umgebung. Diese Option referenziert einen bestimmten Verwaltungsbereich, in dem Sie diesen Keystore sehen können. Wenn sich auf einem bestimmten Knoten beispielsweise physisch eine Hardwareverschlüsselungseinheit befindet, erstellen Sie den Keystore als Link zu diesem Knoten in der Topologie. Wählen Sie dazu Sicherheit > Sichere Kommunikation > SSL-Konfigurationen aus. Mit dem Verwaltungsbereich können Sie auch eine Keystore-Referenz eingrenzen. In einigen Fällen kann es sinnvoll sein, nur einem bestimmten Anwendungsserver die Referenzierung des Keystore zu erlauben. Der Verwaltungsbereich wäre dann auf diesen spezifischen Server beschränkt.

CMS-Keystores

In CMS-Keystores können Sie einige providerspezifische Attribute setzen.

[AIX Solaris HP-UX Linux Windows]Wenn der CMSKS-Provider das Attribut "createStashFileForCMS" unterstützt und Sie dieses Attribute für CMSKS-Keystores auf true setzen, erstellt WebSphere Application Server an der vom Attribut referenzierten Keystore-Position eine Datei .sth. Die Erweiterung .sth wird an den Keystore-Namen angehängt. Wenn der Keystore CMSKS beispielsweise für eine Plug-in-Konfiguration verfügbar ist und Sie createStashFileForCMS auf true setzen, wird die im folgenden Beispielcode dargestellte Stash-Datei im Pfad ${USER_INSTALL_ROOT}\profiles\AppSrv01/config/cells/myhostCell01/nodes/myhostNode01/servers/webserver1/plugin-key.sth erstellt.
<keyStores xmi:id="KeyStore_1132071489571" name="CMSKeyStore" 
password="{xor}HRYNFAtrbxEwOzpvbhw6MzM=" provider="IBMCMSProvider" 
location="${USER_INSTALL_ROOT}\profiles\AppSrv01/config/cells/myhostCell01
/nodes/myhostNode01/servers/webserver1/plugin-key.kdb" type="CMSKS"
fileBased="true" createStashFileForCMS="true" 
managementScope="ManagementScope_1132071489569"/>
Wenn Sie einen CMS-Keystore erstellen, ist der CMS-Provider IBMi5OSJSSEProvider und der CMS-Typ IBMi5OSKeyStore. Schauen Sie sich hierzu den folgenden Beispielcode an:
<keyStores xmi:id="KeyStore_1132071489571" name="CMSKeyStore" 
password="{xor}HRYNFAtrbxEwOzpvbhw6MzM=" provider="IBMi5OSJSSEProvider" 
location="${USER_INSTALL_ROOT}\profiles\AppSrv01/config/cells/myhostCell01
/nodes/myhostNode01/servers/webserver1/plugin-key.kdb" type="IBMi5OSKeyStore"
fileBased="true" createStashFileForCMS="true" 
managementScope="ManagementScope_1132071489569"/>
[IBM i]Anmerkung: Der Keystore-Typ der Plattform IBM i, IBMi5OSKeyStore, erkennt und generiert keine Kennwortstashdatei mit der Erweiterung .sth. Er speichert stattdessen einen internen Eintrag mit dem Kennwort für die Kystore-Datei (.kdb) an der Erstellungsposition dieser Datei. Wird die Datei .kdb verschoben, ist das Kennwort dem Keystore nicht mehr zugeordnet. In einem solchen Fall müssen Sie mit dem DCM (Digital Certificate Manager) den internen Eintrag mit dem Kennwort für die Keystore-Datei (.kdb) wiederherstellen. Weitere Informationen hierzu finden Sie im Artikel Internen Kennwortsatz für den Keystore .kdb erneut erstellen..
[IBM i]Achtung: Wenn Sie verkettete persönliche Zertifikate erstellt haben oder die Task "requestCACertificate" mit dem IBMi5OSKeyStore verwenden, erfordert der IBMi5OSJSSEProvider, dass der Unterzeichner für jedes Glied der Kette im Keystore vorhanden ist, bevor das neue Zertifikat erstellt wird. Deshalb müssen Sie den Unterzeichner in den Keystore "IBMi5OSKeyStore" importieren, bevor Sie das neue Zertifikat erstellen.

Keystores für Hardwareverschlüsselung

Informationen zur Konfiguration von Verschlüsselungseinheiten finden Sie im Artikel Schlüsselverwaltung für Verschlüsselung.

Einen Slot können Sie als angepasste Eigenschaft com.ibm.ssl.keyStoreSlot oder als Konfigurationsattribut slot="0" hinzufügen. Die angepasste Eigenschaft wird vor dem Attribut für Abwärtskompatibilität gelesen.


Symbol, das den Typ des Artikels anzeigt. Konzeptartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=csec_sslkeystoreconfs
Dateiname:csec_sslkeystoreconfs.html