[keycloak-user] Theme Resources Urls

[Doug Szeto]

We're looking to use Keycloak in an enterprise environment that reinforces tight web restrictions. There are network guys combing over every url, and dev ops guys doing other things with urls, and software developers integrating Keycloak.

Customized theming is a big selling point because business people can change up the look without worrying about most web attacks. But operations people dislike tying urls to your release cycle, especially when there are hot fixes.

Your Freemaker template is a little strange too because it rewrites resource links as absolute urls, and make it behave strange behind reverse proxies.

I understand your reasons for defaults, but allowing another flag for prefixing custom theme web resources would integrate more easily with other environments.

--Doug

________________________________
From: Stian Thorgersen <sthorger at redhat.com>
Sent: Tuesday, December 1, 2015 20:27
To: Doug Szeto
Cc: Bill Burke; keycloak-user at lists.jboss.org
Subject: Re: [keycloak-user] Theme Resources Urls

Query param is an alternative practice. There's pros and cons with both approaches.

The idea of customized themes is so you can customize the themes. To change the look and feel, add a logo, add an extra field to the forms, etc..

Can you elaborate on exactly why you need to change the URL?

On 1 December 2015 at 13:21, Doug Szeto <DSzeto at investlab.com<mailto:DSzeto at investlab.com>> wrote:
If you want to bust the cache on a version update, a better practice is to stick the version id as a query parameter at the end of resources, see:
https://css-tricks.com/strategies-for-cache-busting-css/

ie http://localhost:8080/auth/resources/themes/login/keycloak/css/login.css?v=1.6.1.final

I thought the point of customized themes were to allow developers better control over the web resources being served without modifying the security source code. But if we can't control the url of our content, it limits our options on web optimization strategies.

I guess overriding the freemaker template is the only way to go.

--Doug

________________________________________
From: keycloak-user-bounces at lists.jboss.org<mailto:keycloak-user-bounces at lists.jboss.org> <keycloak-user-bounces at lists.jboss.org<mailto:keycloak-user-bounces at lists.jboss.org>> on behalf of Bill Burke <bburke at redhat.com<mailto:bburke at redhat.com>>
Sent: Monday, November 30, 2015 23:07
To: keycloak-user at lists.jboss.org<mailto:keycloak-user at lists.jboss.org>
Subject: Re: [keycloak-user] Theme Resources Urls

Browser caching is turned on for themed resources (admin console,
login, etc.)  This is obviously for performance reasons.

IN the past we received a HUGE amount of false bug reports of "Admin
console doesn't work", "my theme changes aren't showing", etc. after
upgrading Keycloak.  All because people didn't clear their browser
caches.  Hence, the version id.

You should not be externally linking to themed endpoints.  You can use a
different URL to ping the server for "is alive" i.e.
/<root>/realms/{realm-name}


On 11/30/2015 9:56 AM, Doug Szeto wrote:
> What do you mean by 'You can't customize the url format'?
>
> Is there a design decision reason why it is more secure to have your
> keycloak version exposed in the middle of your theme resource urls?
>
> Or would it be easier if you had a pull request?
>
> --Doug
>
>
>
> ------------------------------------------------------------------------
> *From:* Stian Thorgersen <sthorger at redhat.com<mailto:sthorger at redhat.com>>
> *Sent:* Monday, November 30, 2015 15:35
> *To:* Doug Szeto
> *Cc:* keycloak-user at lists.jboss.org<mailto:keycloak-user at lists.jboss.org>
> *Subject:* Re: [keycloak-user] Theme Resources Urls
> You can't customize the url format. Not sure how it would help during
> upgrades? I'd say the opposite as you end up with cached versions for
> the old release not being updated.
>
> On 28 November 2015 at 03:54, Doug Szeto <DSzeto at investlab.com<mailto:DSzeto at investlab.com>
> <mailto:DSzeto at investlab.com<mailto:DSzeto at investlab.com>>> wrote:
>
>
>     Hi,
>     I have created a custom theme as specific in your docs here:
>     http://keycloak.github.io/docs/userguide/keycloak-server/html/themes.html
>     It functions in the browser, in that these configs tell you where
>     the theme customization resources are stored locally, but the end
>     result is the resources are served from the url format pattern of:
>
>     http://localhost:8080/auth/resources/1.6.1.final/login/keycloak/css/login.css
>
>     Is there a way to customize the theme url format to scrub the
>     version number off the css/image/js resources? This will help out in
>     monitoring and upgrades.
>
>     Thanks,
>     --Doug
>     _______________________________________________
>     keycloak-user mailing list
>     keycloak-user at lists.jboss.org<mailto:keycloak-user at lists.jboss.org> <mailto:keycloak-user at lists.jboss.org<mailto:keycloak-user at lists.jboss.org>>
>     https://lists.jboss.org/mailman/listinfo/keycloak-user
>
>
>
>
> _______________________________________________
> keycloak-user mailing list
> keycloak-user at lists.jboss.org<mailto:keycloak-user at lists.jboss.org>
> https://lists.jboss.org/mailman/listinfo/keycloak-user
>

--
Bill Burke
JBoss, a division of Red Hat
http://bill.burkecentral.com
_______________________________________________
keycloak-user mailing list
keycloak-user at lists.jboss.org<mailto:keycloak-user at lists.jboss.org>
https://lists.jboss.org/mailman/listinfo/keycloak-user
_______________________________________________
keycloak-user mailing list
keycloak-user at lists.jboss.org<mailto:keycloak-user at lists.jboss.org>
https://lists.jboss.org/mailman/listinfo/keycloak-user

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/keycloak-user/attachments/20151209/53952652/attachment.html