Forum Discussion

JorenC's avatar
JorenC
Icon for Nimbostratus rankNimbostratus
Apr 23, 2019

Keycloak as idp for APM

Dear devcentral,

 

Has anyone successfully integrated keycloak as an OIDC backend for APM on F5? We are running v13.1 so this version should be able to use this feature, right?

 

So far I have successfully setup a provider using the autodiscover OpenID URI. Created a client application on the keycloak server with the client_id and secret. Next I'm somewhat confused on how to proceed? From what I read in the docs I need to configure the custom requests for keycloak. Though I can't seem the find these.

 

Kind regards,

 

Joren

 

14 Replies

  • Adaya's avatar
    Adaya
    Icon for Nimbostratus rankNimbostratus

    i am also curious about this, has anyone got this to work?

    • JorenC's avatar
      JorenC
      Icon for Nimbostratus rankNimbostratus

      Adaya,

       

      I've got this working for the password flow at the moment.

      The documentation is there but not to easy to figure out what goes where.. (my personal opinion)

       

      Still looking for some time to set up the authorization code flow.

      Once I get this implemented i'll try and add the setup on devcentral, stay tuned :)

       

      Kind regards,

       

      Joren

  • Adaya's avatar
    Adaya
    Icon for Nimbostratus rankNimbostratus

    Thanks for the reply. the specific implementation i'm actually looking for is the resource owner password flow. do you have the documentation you used to get this successfully working?

    • JorenC's avatar
      JorenC
      Icon for Nimbostratus rankNimbostratus

      Adaya,

       

      I did end up using the LinkedIn lab guide.

      https://clouddocs.f5.com/training/community/iam/html/class2/module1/module1.html#task-6-linkedin-custom-provider

       

      Do note, the most important piece is the creation of the custom requests.

      Once you get this flow working using curl commands, it is pretty straight forward to set these up. Though I do not find the official doc clear.

      I'll see if I can upload some screenshots tomorrow (busy days at work ;))

       

      Regards,

       

      Joren

  • Adaya's avatar
    Adaya
    Icon for Nimbostratus rankNimbostratus

    This helps,

     

    Appreciate the effort. If you have time, would it be too much to peak at your APM setup for the OP/IdP portion for Keycloak?

  • Hello, just wanted to know if someone finally manage to make this work with F5 APM and keycloak openid (or any custom on premise oAuth2 or openid provider) and authorisation code flow, custom request requests...

    I try to do the same for OpenID auth behind an API with v15.1 and AWAF but without success...

    • JorenC's avatar
      JorenC
      Icon for Nimbostratus rankNimbostratus

      We do have it running here. But haven't found the time to do full a write-up on the basic setup via APM.. :(

       

      Any specific questions you have regarding the APM integration?

      • avenging's avatar
        avenging
        Icon for Nimbostratus rankNimbostratus

        OK I tried to use the f5 as a resource server to validate JWT token.

         

        Did you manage to do it using the oauth provider configuration with OpenID Connect discovery like https://keycloakhost:keycloakport/auth/realms/master/.well-known/openid-configuration ?

         

        Because for me, the discovery works but if I use the auto-JWT part, on save, f5 tell me about an issue of certificate (the CA bunble provided in config is the one of the certificate for the OpenId discovery link, may be not the same use by master realm to sign token or authorisation code). So I created the JWKS part manualy.

         

        A request to the f5 APM VIP well redirect to the keycloack for AUTH but once authenticated the F5 tell that it cannot validate the token or auth code provided by the keycloak.

         

        As the password grant type has been deprecated, did you manage to make it work using the authorisation code flow?

         

        Also, wonder if for the step scope validation, you use the f5 type or have created some specific for keycloak?.

         

        Yes, if someone have time to do a detailed write up on dev central on how to configure APM with OpenID as Client and/or Ressource server for using with keycloak or any on premise custom Provider, I think this will help a lot of people.

         

        Thanks.

  • I go a little further on this but not yet working in F5.

    For the moment using curl to target keycloak from CLI, I was ablle to have a correct reply from the keycloak for introspec/ user info:

     

    curl --location --request POST 'https://keycloak.xxxxx.lu:8443/auth/realms/master/protocol/openid-connect/token/introspect' \
    --header 'Content-Type: application/x-www-form-urlencoded' \
    --header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJ5bzhwdzhZcHJ1UG96QzVuX0cyVHZ' \
    --data-urlencode 'client_id=F5-APM-Client' \
    --data-urlencode 'client_secret=db51def3-xxxx-xxx-xxx-xxx' \
    --data-urlencode 'token_type_hint=access_token' \
    --data-urlencode 'token=eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJ5bzhwdzhZcHJ1UG96QzVuX0cyVHZ'

     

    but When I try to create a custom f5 keycloak scope request, I always have the same issue :  error: HTTP error 401, Error: invalid_request: Authentication failed.

     

    So I dont understand why ? i try to made tcpdump to see what exactly F5 send to keycloak but, not helped for the moment.

    I see client credentials error in keycloak logs :

    But double checked the parameters > same used in curl ...

     

    • JorenC's avatar
      JorenC
      Icon for Nimbostratus rankNimbostratus

      ​@sebastien doucet​ your setup is indeed a bit different then mine but error seems related.

      We are using ou F5 APM as a full OIDC client, redirecting the user to IDP logon page, requesting token etc..

      Regarding the custom scope validation request, mine is more or less the same. Not so many params though, bare minimum only:

      What really helped me is to place an iRule between the F5 and keycloak to capture the SSL keys so you can decode the HTTPS traffic in the TCP dump. From there you can decode the tokens etc using jwt.io and validate whats is in there.

       

      #START
      when CLIENTSSL_HANDSHAKE {
         log local0. "TCP source port client_side: [TCP::remote_port]"
         log local0. "RSA Session-ID:[SSL::sessionid] Master-Key:[SSL::sessionsecret]"
         log local0. "CLIENT_RANDOM [SSL::clientrandom] [SSL::sessionsecret]"
      }
      when SERVERSSL_HANDSHAKE {
         log local0. "TCP source port serv_side: [TCP::local_port]"
         log local0. "RSA Session-ID:[SSL::sessionid] Master-Key:[SSL::sessionsecret]"
         log local0. "CLIENT_RANDOM [SSL::clientrandom] [SSL::sessionsecret]"
      }
      #END

       

      reference: https://support.f5.com/csp/article/K16700

      Also: Is your keycloak server behind an F5 virtual server? If so, make sure you did config keycloak to understand it is running behind a loadbalancer. cfr: https://www.keycloak.org/docs/latest/server_installation/index.html#_setting-up-a-load-balancer-or-proxy

       

      • avenging's avatar
        avenging
        Icon for Nimbostratus rankNimbostratus

        Thanks JorenC. I was finally able to made this working.

        Capturing the RSA was not working due to RSA-DHE but I find another way using request logger in keycloak server : https://mirocupak.com/logging-requests-with-undertow/

        And it seems that the f5 introspect request is not working as excepted in v15.1 because using the Keycloak scope request posted above the result was :

         

        2020-03-09 13:06:30,504 INFO  [io.undertow.request.dump] (default task-15)
        ----------------------------REQUEST---------------------------
                       URI=/auth/realms/master/protocol/openid-connect/token/introspect
         characterEncoding=null
             contentLength=1666
               contentType=[application/x-www-form-urlencoded]
                    header=Proxy-Connection=Keep-Alive
                    header=Accept=*/*
                    header=User-Agent=F5 OAuth Client
                    header=Authorization=Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJ5bzhwdzhZcHJ1UG96QzVuX0cyVHZVSVbOzSDkNlPyDi5A
                    header=oauth_dns_resolver_name=/Common/172.xx.xx.xx
                    header=oauth_serverssl_name=/Common/keycloak-publicssl
                    header=Expect=100-continue
                    header=Content-Type=application/x-www-form-urlencoded
                    header=Content-Length=1666
                    header=Host=keycloak.xxxxx.lu:8443
                    locale=[]
                    method=POST
                  protocol=HTTP/1.1
               queryString=
                remoteAddr=/172.xx.xx.xx:17741
                remoteHost=172.xx.xx.xx
                    scheme=https
                      host=keycloak.xxxxx.lu:8443
                serverPort=8443
                  isSecure=true
        body=
        %{session.oauth.client.last.access_token}=eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJ5bzhwdzhZcHJ1UG96QzVuX0cyVHZVSVbOzSDkNlPyDi5A
        token_type_hint=access_token
        --------------------------RESPONSE--------------------------
             contentLength=72
               contentType=application/json
                    header=Connection=keep-alive
                    header=Content-Type=application/json
                    header=Content-Length=72
                    header=Date=Mon, 09 Mar 2020 12:06:30 GMT
                    status=401

         

        And we see now that the F5 :

        • send %{session.oauth.client.last.access_token} in place of token
        • miss to send the client-id and client-secret parameters in the body
        • send to much useless info to the keycloak like dns resolvers IP, backend server IP, ssl profile....

        So I rebuild the request using only custom fields even for those by default like token, client-id...:

        and then now it works ! 🙂

        I do the same for userinfo request also.

         

        ----------------------------REQUEST---------------------------
                       URI=/auth/realms/master/protocol/openid-connect/token/introspect
         characterEncoding=null
             contentLength=1699
               contentType=[application/x-www-form-urlencoded]
                    header=Proxy-Connection=Keep-Alive
                    header=Accept=*/*
                    header=User-Agent=F5 OAuth Client
                    header=Authorization=Bearer hVhS2-trG8FsmeRyThTJ7zMGspLxZFGxV9kYjo
                    header=oauth_dns_resolver_name=/Common/172.xxx.xx.xx
                    header=oauth_serverssl_name=/Common/keycloak-publicssl
                    header=Expect=100-continue
                    header=Content-Length=1699
                    header=Content-Type=application/x-www-form-urlencoded
                    header=Host=keycloak.xxxxx.lu:8443
                    locale=[]
                    method=POST
                  protocol=HTTP/1.1
               queryString=
                remoteAddr=/172.xx.xx.xx:47015
                remoteHost=172.xx.xx.xx
                    scheme=https
                      host=keycloak.xxxxx.lu:8443
                serverPort=8443
                  isSecure=true
        body=
        client_id=F5-APM-Client
        client_secret=db51def3-xxxx-xxxx-xxxx-xxxxx
        token=hVhS2-trG8FsmeRyThTJ7zMGspLxZFGxV9kYjo
        token_type_hint=access_token
        --------------------------RESPONSE--------------------------
             contentLength=913
               contentType=application/json
                    header=Connection=keep-alive
                    header=Content-Type=application/json
                    header=Content-Length=913
                    header=Date=Mon, 09 Mar 2020 13:33:59 GMT
                    status=200
         
        ==============================================================

         

        Using the F5 as a Client and Ressource server for keycloak IDP is also working using f5 request without modification:

        So I can confirm that another workaround for the issuer port problem you encounter is to publish your keycloak to a non standard port.

        Thanks for your help, I will do a complete configuration guide when I have time available.