Upgrade instructions versions 4.x

4.04.08 to 4.04.09

Adapt Docker Compose variables

New (not required):

  • TOKEN_SERVER_ENGINE_EXTERNAL_REST_SERVICES_PROXY_PREEMPTIVE_AUTH_ENABLED_BOOLEAN

4.04.07 to 4.04.08

Run all database scripts

  • V4_04_08_00__add_registration_id_to_fido_user_authenticators.sql

Adapt Docker Compose variables

Configuration is now done via Docker Compose variables instead of ETCD. See the documentation for more details.

New (not required):

  • TOKEN_SERVER_ENGINE_EXTERNAL_REST_SERVICES_PROXY_ENABLED_BOOLEAN
  • TOKEN_SERVER_ENGINE_EXTERNAL_REST_SERVICES_PROXY_USERNAME
  • TOKEN_SERVER_ENGINE_EXTERNAL_REST_SERVICES_PROXY_PASSWORD
  • TOKEN_SERVER_ENGINE_EXTERNAL_REST_SERVICES_PROXY_SCHEMA
  • TOKEN_SERVER_ENGINE_EXTERNAL_REST_SERVICES_PROXY_HOST
  • TOKEN_SERVER_ENGINE_EXTERNAL_REST_SERVICES_PROXY_PORT

4.04.05 to 4.04.06

Run all database scripts (only for Oracle and MSSQL)

  • V4_04_06_00__correct_invalid_index_on_idp_attribute_mappings_table.sql

4.03.00 to 4.04.00

Run all database scripts

  • V4_04_00_00__change_client_id_to_fk_in_fido_user_authenticators.sql

4.04.00 to 4.04.01

Run all database scripts

  • V4_04_01_00__missing_event_index.sql
  • V4_04_01_01__add_actual_user_ids_in_events.sql

4.02.02 to 4.03.00

Run all database scripts

  • V4_03_00_01__add_fido_config.sql
  • V4_03_00_02__fido_authenticators_renamed.sql
  • V4_03_00_03__add_fido_policy_mapping_to_moble_auth_type.sql
  • V4_03_00_05__add_index_to_fido_user_authenticators.sql

Adapt config parameters in ETCD

Removed

  • /token-server/engine/mobile-authentication/fido/base-uri
  • /token-server/engine/mobile-authentication/fido/app-keys-json
  • /token-server/engine/mobile-authentication/fido/policy-mapping-json

New (not required)

  • /token-server/common/features/fido-enabled-boolean By default this property has the value true. Set it to false to disable FIDO authentication.
  • /token-server/engine/cache/application-properties-cache/ttl-seconds By default this property has the value of 300 seconds (5 minutes).

Other changes

The environment variable EXPERIMENTAL is no longer used.

4.01.01 to 4.02.00

Run all database scripts

  • V4_02_00_00__rename_statistics.sql
  • V4_02_01_00__add_device_names_encoded_to_clients.sql
  • V4_02_01_01__make_clients_redirect_url_nullable.sql
  • V4_02_01_02__add_foreign_key_to_auth_property_messages.sql (only MSSQL)

Adapt config params in ETCD:

Removed:

  • /token-server/admin/general/recent-events/period-minutes

3.17 to 4.01

Run all database scripts

  • V4_01_00_00__add_length_to_pin_policies.sql
  • V4_01_00_01__add_max_allowed_resends_to_auth_properties.sql
  • V4_01_00_02__move_push_credentials_to_separate_table.sql
  • V4_01_00_03__add_foreign_key_from_platform_to_push.sql
  • V4_01_00_04__add_api_only_to_scopes.sql
  • V4_01_00_05__add_unique_constraint_to_push_messaging_config_name_column.sql
  • V4_01_00_06__add_message_table_for_i18n.sql
  • V4_01_00_08__add_user_id_event_date_index_on_events.sql (only MySQL database)
  • V4_01_00_09__create_db_templates_structure.sql
  • V4_01_00_10__add_default_column_to_template_sets_table.sql
  • V4_01_01_00__remove_join_table_from_template_sets.sql

Adapt config params in ETCD:

New (not required):

  • /token-server/engine/notification-api/enabled-boolean By default this property has value false, to keep using the notification api enable this property.
  • /token-server/engine/mobile-authentication/deprecated-api/enabled By default this property has value false, to keep using the old mobile authentication endpoint enable this property.

Removed:

  • /token-server/admin/managementinfo/data-server/base-uri