Migration from older versionsMigrating from 1.0 Beta 1 to Beta 4
LDAP/AD configuration is changed. It is no longer under the "Settings" page. It is now under
Users->Federation. Add Provider will show you an "ldap" option.
Authentication SPI has been removed and rewritten. The new SPI is UserFederationProvider and is
more flexible.
DB Schema has changed again.
ssl-not-required property in adapter config has been removed. Replaced with
ssl-required, valid values are all (require SSL for all requests), external
(require SSL only for external request) and none (SSL not required).
Migrating from 1.0 Alpha 4 to Beta 1
DB Schema has changed. We have added export of the database to Beta 1, but not the ability to import
the database from older versions. This will be supported in future releases.
For all clients except bearer-only applications, you must specify at least one redirect uri. Keycloak
will not allow you to log in unless you have specified a valid redirect uri for that application.
Resource Owner Password Credentials flow is now disabled by default. It can be enabled by setting the toggle
for Direct Grant APION under realm config in the admin console.
Configuration is now done through standalone/configuration/keycloak-server.json. This
should mainly affect those that use MongoDB.
JavaScript adapter has been refactored. See the JavaScript adapter section for more details.
The "Central Login Lifespan" setting no longer exists. Please see the Session Timeout section
for me details.
Migrating from 1.0 Alpha 2 to Alpha 3
SkeletonKeyToken, SkeletonKeyScope, SkeletonKeyPrincipal, and SkeletonKeySession have been renamed to:
AccessToken, AccessScope, KeycloakPrincipal, and KeycloakAuthenticatedSession respectively.
ServleOAuthClient.getBearerToken() method signature has changed. It now returns an AccessTokenResponse
so that you can obtain a refresh token too.
Adapters now check the access token expiration with every request. If the token is expired, they will
attempt to invoke a refresh on the auth server using a saved refresh token.
Subject in AccessToken has been changed to the User ID.
Migrating from 1.0 Alpha 1 to Alpha 2
DB Schema has changed. We don't have any data migration utilities yet as of Alpha 2.
JBoss and Wildfly adapters are now installed via a JBoss/Wildfly subsystem. Please review the adapter
installation documentation. Edits to standalone.xml are now required.
There is a new credential type "secret". Unlike other credential types, it is stored in plain text in
the database and can be viewed in the admin console.
There is no longer required Application or OAuth Client credentials. These client types are now
hard coded to use the "secret" credential type.
Because of the "secret" credential change to Application and OAuth Client, you'll have to update
your keycloak.json configuration files and regenarate a secret within the Application or OAuth Client
credentials tab in the administration console.