Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated link.

Comment: 24.R1 updated the requirements/information across the article.

Remember to update to the correct version when it is time to publish externally.

Info

This article includes updates for Smart ID Identity Manager 245.0.R11.

Bootstrapping requirements

...

Note

Important information

Most descriptors need to have their certificates and keys bootstrapped before starting the application(s) for the first time. Whenever object history entries or secrets were created with the demo keys, a simple bootstrapping is no longer possible without resigning the object history, by using the batch_re-sign_history tool, and re-encrypting the secrets, by using the batch_secretfieldstore_change_encryption_key tool, see Change encryption key of secret field store. The tools can be requested from our technical support.

Info

Significant changes for Identity Manager

24

5.0.

R1

0

  • Most certificates and keys must be externally provided before first startup.

  • Various checks are introduced. For more information, see Sign and Encrypt engine bootstrap verification:

    • Known demo keys are explicitly blacklisted and Identity Manager will print an error log message, if any of those is encountered on startup of Identity Manager Operator and Identity Manager Admin.Identity Manager Admin and Identity Manager Operator will no longer start without bootstrapping, as most descriptors have missing keys/certs by default.

    • Identity Manager Admin and Identity Manager Operator check on startup whether the configured key for encrypted fields matches the database and will abort if that is not the case.

    • Identity Manager Operator checks on startup if the currently configured key for history signing matches the database and will abort if that is not the case.

    • Known demo keys are explicitly blacklisted and Identity Manager will print an error log message, if any of those is encountered on startup of Identity Manager Operator and Identity Manager Admin.

  • Bootstrap CA/certificate/key generation tooling has been refined, it now works properly on docker and is limited to development or test use (see Bootstrapping development and test systems).
    For production environments manual bootstrapping via Certificate Authorities is required. For more information, see Bootstrapping production Systems for details.

  • Pin scrambling of signencrypt.xml now works in docker deployments via dedicated tooling. See Scramble sensitive data in Identity Manager files for more information.

  • Each descriptor now references its own key by default, instead of for example, ZIP signing and history signing sharing the same key.

...