Biocryptology Connector module
Edition |
Incubator (services) |
||
Issues |
|||
Git |
|||
Latest |
1.2
|
The Biocryptology Connector module enables any Magnolia installation to be able to authenticate using Biocryptology’s identity platform through the use of Open Id Connect.
This means you will get a new login link in the travel demo pages which will initiate Biocryptology’s authentication and let you access protected content on Magnolia.
The module also lets you logout from Biocryptology’s service when you logout from Magnolia
This module is at the INCUBATOR level. |
Installing with Maven
Maven is the easiest way to install the module. Add the following to your bundle:
<dependency>
<groupId>info.magnolia.biocryptology</groupId>
<artifactId>biocryptology-connector-module</artifactId>
<version>1.2</version>
</dependency>
You also need the Magnolia SSO Connector module.
<dependency>
<groupId>info.magnolia.connector.sso</groupId>
<artifactId>sso-connector</artifactId>
<version>2.7.4</version>
</dependency>
Jaas authentication
Add the following authenticator to the jaas.config file inside you war:
sso-authentication {
info.magnolia.connector.sso.jaas.SSOAuthenticationModule requisite;
info.magnolia.jaas.sp.jcr.JCRAuthorizationModule required;
};
Biocryptology credentials
You can find your credentials on biocryptology’s website: https://id.biocryptology.com in the "Plugins" section.
-
clientId
: You will need to fill the client id on /modules/sso-connector/config/authenticationServices/biocryptology: -
callbackURL
: You might need to change this url according to the context where the public instance is installed. By default its configured localhost on port 8080, using magnoliaPublic as context.
You need to check that the callback URLs are properly defined on biocryptology’s server. It needs a proper server/.auth URL. |
Usage
Prerequisites
-
A biocryptology account is needed: https://id.biocryptology.com
-
SSO connector module is needed.
Instructions
-
You can login through any page on travel demo, clicking on the new biocryptology login button on top of the page:
-
This will redirect you to biocryptology’s server:
-
After logging in with biocryptology, you will get redirected to
travel-demo
homepage with a valid session using biocryptology’s user info:
If you click on the user’s name you, can see the user’s profile: