Вопрос или проблема
Надеюсь, кто-то, кто разбирается в Keycloak, сможет помочь мне с этой проблемой.
Как воспроизвести:
Найдите пользователя, затем перейдите в Role Mappings > Client Roles > выберите клиент (назовем его Portal-app
пока). Это вызовет ошибку “Error! An unexpected server error has occurred
” в верхней части страницы.
Проверяя логи, я вижу Null Pointer Exception:
2019-08-01 10:47:15,305 ERROR [org.keycloak.services.error.KeycloakErrorHandler] (default task-66) Uncaught server error: java.lang.NullPointerException
at org.keycloak.services.resources.admin.permissions.RolePermissions.checkAdminRoles(RolePermissions.java:141)
at org.keycloak.services.resources.admin.permissions.RolePermissions.canMapRole(RolePermissions.java:288)
at org.keycloak.services.resources.admin.ClientRoleMappingsResource.lambda$getAvailableClientRoleMappings$0(ClientRoleMappingsResource.java:142)
at java.util.stream.ReferencePipeline$2$1.accept(ReferencePipeline.java:174)
at java.util.HashMap$KeySpliterator.forEachRemaining(HashMap.java:1556)
at java.util.stream.AbstractPipeline.copyInto(AbstractPipeline.java:481)
at java.util.stream.AbstractPipeline.wrapAndCopyInto(AbstractPipeline.java:471)
at java.util.stream.ReduceOps$ReduceOp.evaluateSequential(ReduceOps.java:708)
at java.util.stream.AbstractPipeline.evaluate(AbstractPipeline.java:234)
at java.util.stream.ReferencePipeline.collect(ReferencePipeline.java:499)
at org.keycloak.services.resources.admin.ClientRoleMappingsResource.getAvailableClientRoleMappings(ClientRoleMappingsResource.java:143)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:498)
at org.jboss.resteasy.core.MethodInjectorImpl.invoke(MethodInjectorImpl.java:139)
at org.jboss.resteasy.core.ResourceMethodInvoker.internalInvokeOnTarget(ResourceMethodInvoker.java:509)
at org.jboss.resteasy.core.ResourceMethodInvoker.invokeOnTargetAfterFilter(ResourceMethodInvoker.java:399)
at org.jboss.resteasy.core.ResourceMethodInvoker.lambda$invokeOnTarget$0(ResourceMethodInvoker.java:363)
at org.jboss.resteasy.core.interception.PreMatchContainerRequestContext.filter(PreMatchContainerRequestContext.java:355)
at org.jboss.resteasy.core.ResourceMethodInvoker.invokeOnTarget(ResourceMethodInvoker.java:365)
at org.jboss.resteasy.core.ResourceMethodInvoker.invoke(ResourceMethodInvoker.java:337)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invokeOnTargetObject(ResourceLocatorInvoker.java:137)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invoke(ResourceLocatorInvoker.java:106)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invokeOnTargetObject(ResourceLocatorInvoker.java:132)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invoke(ResourceLocatorInvoker.java:106)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invokeOnTargetObject(ResourceLocatorInvoker.java:132)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invoke(ResourceLocatorInvoker.java:106)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invokeOnTargetObject(ResourceLocatorInvoker.java:132)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invoke(ResourceLocatorInvoker.java:106)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invokeOnTargetObject(ResourceLocatorInvoker.java:132)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invoke(ResourceLocatorInvoker.java:106)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invokeOnTargetObject(ResourceLocatorInvoker.java:132)
at org.jboss.resteasy.core.ResourceLocatorInvoker.invoke(ResourceLocatorInvoker.java:100)
at org.jboss.resteasy.core.SynchronousDispatcher.invoke(SynchronousDispatcher.java:439)
at org.jboss.resteasy.core.SynchronousDispatcher.lambda$invoke$4(SynchronousDispatcher.java:229)
at org.jboss.resteasy.core.SynchronousDispatcher.lambda$preprocess$0(SynchronousDispatcher.java:135)
at org.jboss.resteasy.core.interception.PreMatchContainerRequestContext.filter(PreMatchContainerRequestContext.java:355)
at org.jboss.resteasy.core.SynchronousDispatcher.preprocess(SynchronousDispatcher.java:138)
at org.jboss.resteasy.core.SynchronousDispatcher.invoke(SynchronousDispatcher.java:215)
at org.jboss.resteasy.plugins.server.servlet.ServletContainerDispatcher.service(ServletContainerDispatcher.java:227)
at org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher.service(HttpServletDispatcher.java:56)
at org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher.service(HttpServletDispatcher.java:51)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:791)
at io.undertow.servlet.handlers.ServletHandler.handleRequest(ServletHandler.java:74)
at io.undertow.servlet.handlers.FilterHandler$FilterChainImpl.doFilter(FilterHandler.java:129)
at org.keycloak.services.filters.KeycloakSessionServletFilter.doFilter(KeycloakSessionServletFilter.java:90)
at io.undertow.servlet.core.ManagedFilter.doFilter(ManagedFilter.java:61)
at io.undertow.servlet.handlers.FilterHandler$FilterChainImpl.doFilter(FilterHandler.java:131)
at io.undertow.servlet.handlers.FilterHandler.handleRequest(FilterHandler.java:84)
at io.undertow.servlet.handlers.security.ServletSecurityRoleHandler.handleRequest(ServletSecurityRoleHandler.java:62)
at io.undertow.servlet.handlers.ServletChain$1.handleRequest(ServletChain.java:68)
at io.undertow.servlet.handlers.ServletDispatchingHandler.handleRequest(ServletDispatchingHandler.java:36)
at org.wildfly.extension.undertow.security.SecurityContextAssociationHandler.handleRequest(SecurityContextAssociationHandler.java:78)
at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:43)
at io.undertow.servlet.handlers.security.SSLInformationAssociationHandler.handleRequest(SSLInformationAssociationHandler.java:132)
at io.undertow.servlet.handlers.security.ServletAuthenticationCallHandler.handleRequest(ServletAuthenticationCallHandler.java:57)
at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:43)
at io.undertow.security.handlers.AbstractConfidentialityHandler.handleRequest(AbstractConfidentialityHandler.java:46)
at io.undertow.servlet.handlers.security.ServletConfidentialityConstraintHandler.handleRequest(ServletConfidentialityConstraintHandler.java:64)
at io.undertow.security.handlers.AuthenticationMechanismsHandler.handleRequest(AuthenticationMechanismsHandler.java:60)
at io.undertow.servlet.handlers.security.CachedAuthenticatedSessionHandler.handleRequest(CachedAuthenticatedSessionHandler.java:77)
at io.undertow.security.handlers.NotificationReceiverHandler.handleRequest(NotificationReceiverHandler.java:50)
at io.undertow.security.handlers.AbstractSecurityContextAssociationHandler.handleRequest(AbstractSecurityContextAssociationHandler.java:43)
at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:43)
at org.wildfly.extension.undertow.security.jacc.JACCContextIdHandler.handleRequest(JACCContextIdHandler.java:61)
at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:43)
at org.wildfly.extension.undertow.deployment.GlobalRequestControllerHandler.handleRequest(GlobalRequestControllerHandler.java:68)
at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:43)
at io.undertow.servlet.handlers.ServletInitialHandler.handleFirstRequest(ServletInitialHandler.java:292)
at io.undertow.servlet.handlers.ServletInitialHandler.access$100(ServletInitialHandler.java:81)
at io.undertow.servlet.handlers.ServletInitialHandler$2.call(ServletInitialHandler.java:138)
at io.undertow.servlet.handlers.ServletInitialHandler$2.call(ServletInitialHandler.java:135)
at io.undertow.servlet.core.ServletRequestContextThreadSetupAction$1.call(ServletRequestContextThreadSetupAction.java:48)
at io.undertow.servlet.core.ContextClassLoaderSetupAction$1.call(ContextClassLoaderSetupAction.java:43)
at org.wildfly.extension.undertow.security.SecurityContextThreadSetupAction.lambda$create$0(SecurityContextThreadSetupAction.java:105)
at org.wildfly.extension.undertow.deployment.UndertowDeploymentInfoService$UndertowThreadSetupAction.lambda$create$0(UndertowDeploymentInfoService.java:1502)
at org.wildfly.extension.undertow.deployment.UndertowDeploymentInfoService$UndertowThreadSetupAction.lambda$create$0(UndertowDeploymentInfoService.java:1502)
at org.wildfly.extension.undertow.deployment.UndertowDeploymentInfoService$UndertowThreadSetupAction.lambda$create$0(UndertowDeploymentInfoService.java:1502)
at org.wildfly.extension.undertow.deployment.UndertowDeploymentInfoService$UndertowThreadSetupAction.lambda$create$0(UndertowDeploymentInfoService.java:1502)
at io.undertow.servlet.handlers.ServletInitialHandler.dispatchRequest(ServletInitialHandler.java:272)
at io.undertow.servlet.handlers.ServletInitialHandler.access$000(ServletInitialHandler.java:81)
at io.undertow.servlet.handlers.ServletInitialHandler$1.handleRequest(ServletInitialHandler.java:104)
at io.undertow.server.Connectors.executeRootHandler(Connectors.java:360)
at io.undertow.server.HttpServerExchange$1.run(HttpServerExchange.java:830)
at org.jboss.threads.ContextClassLoaderSavingRunnable.run(ContextClassLoaderSavingRunnable.java:35)
at org.jboss.threads.EnhancedQueueExecutor.safeRun(EnhancedQueueExecutor.java:1985)
at org.jboss.threads.EnhancedQueueExecutor$ThreadBody.doRunTask(EnhancedQueueExecutor.java:1487)
at org.jboss.threads.EnhancedQueueExecutor$ThreadBody.run(EnhancedQueueExecutor.java:1378)
at java.lang.Thread.run(Thread.java:748)
У клиента Portal-app
определено 2 роли:
- user
- admin
Странно то, что:
- Я попытался удалить роль
admin
, заново выполнить шаги (найти пользователя, перейти в Role Mappings > Client Roles > выбрать клиентPortal-app
), и клиентская рольuser
отображается! (ошибки нет) - Добавить новую роль с именем
admin
, заново выполнить шаги, и та же ошибка отображается. - Удалить роль
admin
и добавить другую роль, такую какadmin1
, заново выполнить шаги, и тогда ошибки нет.
Так почему же не принимается роль admin
? В других реалмах на той же установке Keycloak есть клиенты с ролью admin
, и у них этой проблемы нет!
- Версия Keycloak:
5.0.0
- Версия Java:
1.8.0_201
Я знаю, что это старые версии, но сейчас мы не можем провести обновление по различным причинам.
Есть идеи, как это исправить? Заранее большое спасибо.
Кажется, в Keycloak есть баг. Если название реалма заканчивается на “-realm”, вы сможете создать роль admin, в противном случае вы не можете.
Соответствующая строка находится здесь.
Ответ или решение
Ошибка Null Pointer Exception в Keycloak при попытке сопоставления клиентской роли пользователю может возникать по ряду причин. Рассмотрим ваш случай подробно.
Разбор проблемы
Вы сталкиваетесь с ошибкой: "Error! An unexpected server error has occurred" при попытке назначить клиентскую роль пользователю через интерфейс Keycloak. Журналы указывают на Null Pointer Exception в ходе выполнения метода RolePermissions.canMapRole
из пакета org.keycloak.services.resources.admin.permissions
.
Анализ и возможные причины
-
Проблема с ролью "admin":
- Из вашего описания следует, что при наличии роли с именем
admin
возникает ошибка. Тем не менее, при добавлении или удалении этой роли проблема исчезает.
- Из вашего описания следует, что при наличии роли с именем
-
Ошибки в коде:
- Ссылаясь на GitHub, существует известная проблема в Keycloak, связанная с реализацией интерфейса прав. Это может быть связано с суффиксом названия realm, как указано на странице проекта, что требует определенных наименований.
-
Конфликт имен:
- Возможно, в вашем проекте существует конфликт имен. Название
admin
может являться ключевым и неправильно обрабатываться в контексте определенных версий Keycloak.
- Возможно, в вашем проекте существует конфликт имен. Название
Рекомендации по решению
-
Переименование роли:
- Избегайте использования роли с названием
admin
. Попробуйте использовать альтернативное название как временное решение, например,admin1
.
- Избегайте использования роли с названием
-
Проверка конфигурации realm:
- Убедитесь, что ваш realm называетcя согласно ограничениям, упомянутым в известных проблемах Keycloak. Возможно, это связано с реализацией роли администратора.
-
Обновление версии:
- Хотя обновление Keycloak, Java или сервера приложений не представляется возможным на данный момент, запланируйте это на будущее. Новые версии могут решить значительное количество известных ошибок.
-
Проход по коду:
- Проверьте связанные исходные коды, чтобы выявить все возможные конфликты. Ссылки на исходные коды, например, из GitHub, могут быть полезны.
Заключение
Ваша проблема с Keycloak может быть решена обходными путями до момента, когда вы сможете выполнить обновление программного обеспечения до актуальных версий. Временное решение включает переименование конфликтных ролей и тщательную проверку конфигураций. За более детальным разбором стоит обратиться в сообщество или к специализированной технической поддержке.
Уверен, эти шаги помогут вам разобраться со сложившейся ситуацией, а внедрение предлагаемых решений минимизирует влияние проблемы на вашу работу.