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)
<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. | 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:
|
| 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 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.
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"/>
<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"/>
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..
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.
Konzeptartikel