TLS (Transport Layer Security, dessen Vorgänger SSL ist) ist die Standardsicherheitstechnologie, die für sicheres, verschlüsseltes Messaging in Ihrer API-Umgebung sorgt, von Anwendungen über Apigee Edge bis hin zu Ihren Backend-Diensten.
Unabhängig von der Umgebungskonfiguration für Ihre Management API, z. B. ob Sie einen Proxy, einen Router und/oder einen Load Balancer vor Ihrer Management API verwenden (oder nicht), können Sie mit Edge TLS aktivieren und konfigurieren. So haben Sie die Kontrolle über die Nachrichtenverschlüsselung in Ihrer lokalen API-Verwaltungsumgebung.
Bei einer lokalen Installation von Edge Private Cloud gibt es mehrere Stellen, an denen Sie TLS konfigurieren können:
- Zwischen einem Router und einem Message Processor
- Für den Zugriff auf die Edge Management API
- Für den Zugriff auf die Edge-Verwaltungs-UI
- Für den Zugriff auf die neue Edge-Benutzeroberfläche
- Für den Zugriff von einer App auf Ihre APIs
- Für den Zugriff von Edge auf Ihre Backend-Dienste
Eine vollständige Übersicht über die Konfiguration von TLS in Edge finden Sie unter TLS/SSL.
JKS-Datei erstellen
Bei vielen TLS-Konfigurationen wird der Schlüsselspeicher als JKS-Datei dargestellt, wobei der Schlüsselspeicher Ihr TLS-Zertifikat und Ihren privaten Schlüssel enthält. Es gibt mehrere Möglichkeiten, eine JKS-Datei zu erstellen. Eine Möglichkeit ist die Verwendung der Dienstprogramme openssl und keytool.
Beispiel: Sie haben eine PEM-Datei mit dem Namen server.pem, die Ihr TLS-Zertifikat enthält, und eine PEM-Datei mit dem Namen „private_key.pem“, die Ihren privaten Schlüssel enthält. Verwenden Sie die folgenden Befehle, um die PKCS12-Datei zu erstellen:
openssl pkcs12 -export -clcerts -in server.pem -inkey private_key.pem -out keystore.pkcs12
Sie müssen die Passphrase für den Schlüssel (falls vorhanden) und ein Exportpasswort eingeben. Mit diesem Befehl wird eine PKCS12-Datei mit dem Namen keystore.pkcs12 erstellt.
Verwenden Sie den folgenden Befehl, um sie in eine JKS-Datei mit dem Namen „keystore.jks“ zu konvertieren:
keytool -importkeystore -srckeystore keystore.pkcs12 -srcstoretype pkcs12 -destkeystore keystore.jks -deststoretype jks
Sie werden aufgefordert, das neue Passwort für die JKS-Datei und das vorhandene Passwort für die PKCS12-Datei einzugeben. Verwenden Sie für die JKS-Datei dasselbe Passwort wie für die PKCS12-Datei.
Wenn Sie einen Schlüsselalias angeben müssen, z. B. beim Konfigurieren von TLS zwischen einem Router und einem Message Processor, fügen Sie die Option -name in den Befehl openssl ein:
openssl pkcs12 -export -clcerts -in server.pem -inkey private_key.pem -out keystore.pkcs12 -name devtest
Fügen Sie dann die Option -alias zum Befehl keytool hinzu:
keytool -importkeystore -srckeystore keystore.pkcs12 -srcstoretype pkcs12 -destkeystore keystore.jks -deststoretype jks -alias devtest
Verschleiertes Passwort generieren
Bei einigen Teilen des Edge-TLS-Konfigurationsverfahrens müssen Sie ein verschleiertes Passwort in eine Konfigurationsdatei eingeben. Ein verschleiertes Passwort ist eine sicherere Alternative zur Eingabe Ihres Passworts im Nur-Text-Format.
Sie können ein verschleiertes Passwort generieren, indem Sie den folgenden Befehl auf dem Edge-Verwaltungsserver verwenden:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password
Geben Sie das neue Passwort ein und bestätigen Sie es, wenn Sie dazu aufgefordert werden. Aus Sicherheitsgründen wird der Text des Passworts nicht angezeigt. Dieser Befehl gibt das Passwort in folgendem Format zurück:
OBF:58fh40h61svy156789gk1saj MD5:902fobg9d80e6043b394cb2314e9c6
Verwenden Sie das verschleierte Passwort, das von OBF bei der Konfiguration von TLS angegeben wurde.
Weitere Informationen finden Sie in diesem Artikel.