Migration from older versions 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.