Add the ability to search for organizations by their attributes

[phamann]

TL;DR

Following on from discussion in #88, this adds the ability to search for organizations based on their key=value attribute pairs, using a new q query paramter on the search resource, i.e GET /:realm/orgs?q=foo:bar.

Notes:

• The q and key:value search param follows convention in Keycloak core, such as the User search API.
• The API will now return a 400 Bad request if both a search and q parameter are provided.
• I haven't included the ability to query other organization fields other than attirbutes (as there aren't many and my personal need was for attributes). However, it should be an easy refactor in the future.
• As this addition isn't yet avalable via the phase-two java client, I had to add a raw HTTP test, I hope this is ok?
• As this is a new optional query param, I consider this a non-breaking change to the API, but let me know if you disagree.

---

Closes #88

[xgp]

@phamann Thanks so much for this addition.

Regarding your tests question, this isn't a problem, as the phasetwo-java lib isn't updated until after we make API changes. However, it (and the other API client libs) gets generated based on a spec file here: https://github.com/p2-inc/phasetwo-docs/blob/master/openapi.yaml . Would you mind doing a PR for that spec file for the change you made?

[phamann]

Hey @xgp, I've now submitted a PR to also update the OpenAPI schema as requested. https://github.com/p2-inc/phasetwo-docs/pull/94

[paulwer]

@xgp when did you plan to release this in the docker oss environment / the client sdk?

[xgp]

• client went out a few days ago https://repo1.maven.org/maven2/io/phasetwo/phasetwo-admin-client/0.1.4/
• docker image will be updated before eow

[paulwer]

@xgp i didnt see any updates at keycloak-js did I miss something? or is this still pending?

[xgp]

Sorry, the java client went out. js client still pending.

[xgp]

@paulwer these are released.