2015-07-17 11:45:43 +00:00
|
|
|
<chapter id="admin-rest-api">
|
|
|
|
|
<title>Admin REST API</title>
|
|
|
|
|
<para>
|
|
|
|
|
The Keycloak Admin Console is implemented entirely with a fully functional REST admin API. You can invoke this
|
|
|
|
|
REST API from your Java applications by obtaining an access token. You must have the appropriate
|
|
|
|
|
permissions set up as described in <xref linkend="admin-permissions" /> and <xref linkend="per-realm-admin-permissions" />
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
The documentation for this REST API is auto-generated and is contained in the distribution of keycloak under
|
|
|
|
|
the docs/rest-api/overview-index.html directory, or directly from the docs page at the keycloak website.
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
There are a number of examples that come with the keycloak distribution that show you how to invoke on this REST API.
|
|
|
|
|
<literal>examples/preconfigured-demo/admin-access-app</literal> shows you how to access this api from java.
|
|
|
|
|
<literal>examples/cors/angular-product-app</literal> shows you how to invoke on it from Javascript. Finally there is example in
|
|
|
|
|
<literal>example/admin-client</literal>, which contains example for Admin client, that can be used to invoke REST endpoints easily as Java methods.
|
|
|
|
|
</para>
|
2014-05-28 16:33:49 +00:00
|
|
|
</chapter>
|
