Biocryptology Connector module

Edition

Incubator (services)

Issues

Git

Latest

1.2

Compatible with Magnolia 6.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.

biocrypto credentials

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: