README.md

Identity Manager - Keyrock

Keyrock is the FIWARE component responsible for Identity Management. Using
Keyrock (in conjunction with other security components such as
PEP Proxy and
Authzforce) enables you to add
OAuth2-based authentication and authorization security to your services and
applications.

This project is part of FIWARE. For more information
check the FIWARE Catalogue entry for
Security.

Usage

API

Resources can be managed through the API (e.g. Users, applications and
organizations). Further information can be found in the
API section.

Finally, one of the main uses of this Generic Enabler is to allow developers to
add identity management (authentication and authorization) to their applications
based on FIWARE identity. This is posible thanks to
OAuth2 protocol. For more information check the
OAuth2 API.

Tests

For performing a basic end-to-end test, you have to follow the next steps. A
detailed description about how to run tests can be found
here.

Verify that the host address of IdM can be reached. By default, web access
will show a Login Page.

Acquire a valid username and password and access with those credentials. The
resulting web page is the landing page of the IdM KeyRock Portal.

Verify that you can view the list of applications, organizations, etc.

Advanced Documentation

Changes Introduced in 7.x

They biggest change introduced in 7.x is that the identity manager no longer
depends on Openstack components Keystone and Horizon. Now is fully implemented
in Node JS. Another remarkable changes have been made:

A driver has been implemented in order to make authentication against
another database different from the default one.

The appearance of the web portal can be easily modified though configurable
themes.

Now users don't need to switch session in order to create an application
that will belong to an organization.

Permissions of an application can be edited or deleted.

IdM could play the role of gateway between services and eDIAS Node in order
to allow users authentication with their national eID.