Skip to main content Skip to complementary content
Announcements

Encrypting properties stored in the IAM configuration file

You can generate an encryption key to encrypt sensitive information in the Talend Identity and Access Management configuration file.

A default encryption key is delivered with the installation of Talend Identity and Access Management. It is recommended to replace it with your own encryption in the keys.properties file.

Procedure

  1. Go to the apache-tomcat folder of your Talend Identity and Access Management installation.
  2. Open the conf/keys.properties file. If it does not exist, you need to create it.
  3. Generate your own encryption secret.

    Example

    For example, using this OpenSSL command:

    openssl rand -base64 32
  4. In the keys.properties file, added this content:

    Example

    aes.key=<generated key>
  5. Save your changes.
    If the Talend Identity and Access Management is already on, restart it so that the configuration takes effect.

Results

On start of Talend Identity and Access Management, this encryption secret is used to encrypt the following properties:
  • tac.password
  • idp.db.password
  • oidc.db.password
  • oidc.dynRegService.initialAccessToken
  • oidc.keystore.password
  • oidc.key.password
  • syncope.password
  • sts.keystore.password
  • sts.key.password
  • all secrets in the clients/*.json files.

If you have started Talend Identity and Access Management before changing the encryption key, your properties have already been encrypted with the default key. In this situation, you must write all the encrypted values again in their original plain text values, because the new encryption key cannot decrypt those properties.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!

Leave your feedback here