B-FY Connector module

Edition

Incubator (services)

Issues

Git

Git

Latest

1.2

Compatible with Magnolia 6.2.

The B-FY Connector module enables any Magnolia installation to be able to authenticate using B-FY’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 initiates B-FY’s authentication protocol and lets you access protected content on Magnolia. The module also lets you logout from B-FY’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;
};

B-FY credentials

  1. Reach out directly to B-FY’s customer support to retrieve your credentials.

  2. Using the information from B-FY, fill in the applicable fields in Magnolia.

    • clientId

    • callbackURL

    Value your B-FY client Id at /modules/sso-connector/config/authenticationServices/b-fy:

    + biocrypto admincentral

    You might need to change this URL according where your 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 B-FY’s server. It needs a proper server /.auth URL.

Usage

Prerequisites

  • A B-FY account

  • Magnolia SSO Connector Module

Instructions

  1. You can login through any page on travel demo by clicking on the new B-FY login button on top of the page.

    travel login

  2. This redirects you to B-FY’s server.

    bfy 2fa

  3. After logging in with B-FY, you are redirected to the travel-demo homepage with a valid session using B-FY’s user credentials.

    bfy introInDemo

B-FY user profile

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

bfy viewUserProfile

Changelog

Version Notes

1.2

1.1

1.0

Initial release of the module.

Feedback

Incubators

×

Location

This widget lets you know where you are on the docs site.

You are currently perusing through the B-FY Connector module docs.

Main doc sections

DX Core Headless PaaS Legacy Cloud Incubator modules