TLS/SSL-tanúsítványok kézbesítése az Apache Tomcatnek az Azure Key Vault használatával

Ez a cikk azt ismerteti, hogyan integrálható az Azure Key Vault az Apache Tomcatbe TLS/SSL-tanúsítványok kézbesítéséhez.

Győződjön meg arról, hogy a JVM hozzáfér a TLS/SSL-tanúsítványokhoz

Győződjön meg arról, hogy követte a TLS-/SSL-tanúsítványok JVM-való kézbesítéséhez az Azure Key Vault használatával című cikkben ismertetett lépéseket.

TLS/SSL konfiguráció hozzáadása a server.xml-hoz

Adja hozzá a következő konfigurációt a Tomcat server.xml fájlhoz. Mindenképpen cserélje le a <your-certificate> helyőrzőt a kiszolgálóoldali TLS/SSL-hez használni kívánt tanúsítvány nevére az Azure Key Vaultban.

<Connector port="8443"
           protocol="org.apache.coyote.http11.Http11NioProtocol"
           maxThreads="150"
           SSLEnabled="true">
    <SSLHostConfig>
        <Certificate
            certificateKeyAlias="<your-certificate>"
            certificateKeystoreFile=""
            certificateKeystorePassword=""
            certificateKeystoreType="DKS"
            certificateKeystoreProvider="AzureKeyVault" />
    </SSLHostConfig>
</Connector>

A szükséges indítási tulajdonságok megadása

A JAVA_OPTS és CLASSPATH környezeti változókkal állítsa be a környezetet a Tomcat indítása előtt. A környezeti változók megadásának egyik módja egy setenv.sh vagy setenv.bat szkript létrehozása a Tomcat bin könyvtárban.

Jegyzet

A környezeti változók beállításához más módszereket is használhat. Teszteltük a Tomcat catalina.sh szkriptjét vagy catalina.bat szkriptjét, valamint a Windows Tomcat szolgáltatás futtatásával.

export JAVA_OPTS="-Djava.security.properties==/xxx/my.java.security"
export CLASSPATH="/xxx/azure-security-keyvault-jca.jar"

Az alábbi JAVA_OPTS példa a szolgáltatásnév használatával végzett helyi tesztelésre vonatkozik:

export JAVA_OPTS='-Djava.security.properties==/xxx/my.java.security -Dazure.keyvault.uri=xxx -Dazure.keyvault.client-id=xxx -Dazure.keyvault.client-secret=xxx -Dazure.keyvault.tenant-id=xxx'

Ez a példa a felhasználó által hozzárendelt felügyelt identitást használó felhőbeli üzembe helyezéseket ismerteti:

export JAVA_OPTS='-Djava.security.properties==/xxx/my.java.security -Dazure.keyvault.uri=xxx -Dazure.keyvault.managed-identity=<your-managed-identity>'

Ez a példa a rendszer által hozzárendelt felügyelt identitást használó felhőbeli üzembe helyezéseket ismerteti:

export JAVA_OPTS='-Djava.security.properties==/xxx/my.java.security -Dazure.keyvault.uri=xxx'

Az egyes tulajdonságok jelentéséért lásd: TLS-/SSL-tanúsítványok JVM-való kézbesítése az Azure Key Vault használatával.

Következő lépések