Configuring HTTPS

The following section details how to enable TLS over HTTP (HTTPS).

Requirements

In order to configure HTTPS you will need a:

  • JKS or PKCS12 keystore, containing a private key for the server to use as its identity.

  • The details of the key (alias and password) and the password for the keystore.

Configuration

  1. Move your chosen keystore into the SETTINGS directory.

  2. Add the following and set the required TLS settings in the settings.properties file:

    3. tls.keystore.filename=
tls.keystore.password=
tls.keystore.type=
tls.key.alias=
tls.key.password=
http.enabled=
https.enabled=
jboss.bind.address=

    TLS details

    Parameter

    Value

    tls.keystore.filename

    The name of the keystore file (including the extension) you have placed in your SETTINGS directory.

    tls.keystore.password

    The password for the keystore you have placed in your SETTINGS directory.

    tls.keystore.type

    Your keystore type: PKCS12 or JKS.

    tls.key.alias

    The unique identifier for the key you will be using.

    tls.key.password

    The password for the key you will use in the Keystore.

    http.enabled

    Set to false to disable the unsecure HTTP listener.

    https.enabled

    Set to true to enable the HTTPS listener.

    jboss.bind.address

    The address that 1Integrate should listen on, this should match the common name protected by your certificate.

  3. Next time 1Integrate starts, it will only listen on port 8443 over HTTPS. To change the secure port, add and set the HTTPS port:

    interface.https.port=8443