Biocryptology Connector module

Edition

Incubator (services)

Issues

BIOCRYPTO

Git

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:

    biocrypto admincentral

  • 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

Instructions

  1. You can login through any page on travel demo, clicking on the new biocryptology login button on top of the page:

    travel login

  2. This will redirect you to biocryptology’s server:

    login redirect

  3. After logging in with biocryptology, you will get redirected to travel-demo homepage with a valid session using biocryptology’s user info:

    redirect valid info

Your user profile

If you click on the user’s name you, can see the user’s profile:

view user profile

Changelog

Version Notes

1.2

1.1

1.0

Initial release of the module.
Feedback