Our partner please-open.it specializes in authentication and web security, and provides Keycloak as a service. Please-open.it propose to the community a bash script Oauth2/OpenID Connect wrapper, an useful tool to help integrators and identity management specialists debug their installation.

This bash script is an Oauth2/OpenID Connect wrapper. You can make any authentication request from command line with the right arguments.

Supported operations are :

  • get oidc server infos
  • client credentials
  • implicit flow
  • authorization code flow
  • resource owner password
  • auth code exchange
  • token exchange
  • refresh token
  • end session
  • token introspection
  • user infos

Use it as a guide for oauth2/openid connect discovery or in any testing/integration process. Script is totally stateless, save the output of a command in variables to reuse tokens.


You need curl, jq and netcat installed.

Note : on Debian, install netcat-openbsd version

Quick tour Using Google
Discovery document

Google is an OpenIdConnect provider, you can get the discovery document at https://accounts.google.com/.well-known/openid-configuration

Get a new token

*Using authorization_code_grant process, a standard for the web supported by all providers, you can get a new token from an authorization_code. To get a new authorization_code,

Then the console shows :

Open your web browser and paste the URI shown in the console. You will have a login screen then a consent screen. Afterthat, redirect process will show a page from with all given data. Get your authorization code.

Second step is exchanging an authorization_code for a token. The operation “auth_code” is designed for :

User infos

using the access_token we got previously :

Build for Keycloak ?

Of course ! Keycloak has its own discovery document (for a realm) with the “OpenID Endpoint Configuration” link. Keycloak supports all operations of this bash script, please refer to the documentation links for each operation below.

Feel free to test it with a realm you can get at https://realms.please-open.it.

For more information connect to please-open.it github repo :