Introduction
This tutorial describes the procedure for installing the Atricore Identity Bus 1.0.0-m1 and JOSSO 1.8.2. Moreover, we'll show how to deploy a pre-built identity appliance for enabling a SAML2-based Identity Federation with one Identity Provider (IdP) and one Service Provider (SP).
Prerequisites
Make sure you've installed Atricore Identity Bus and JOSSO before continuing as explained in the Quick Start tutorial.
Scaffold an Identity Appliance Unit
Execute the Atricore Identity Bus console and run execute the following procedure :
karaf@atricore:/> samlr2:scaffoldIdau first-idau c:/temp/my-idaus
This command scaffolds an Identity Appliance Unit (IDAU) module identified as first-idau and located within the c:/temp/my-idaus folder.
By default, the generated Identity Appliance Unit defined Identity Provider (IdP) and one Service Provider (SP) relying on the standard SAML2 protocol for exchanging authentication and authorization information.
Setup the Identity Appliance Unit
Upon scaffolding the IDAU you may customize the Identity Appliance Unit by working on the included Atricore Identity Bus descriptors.
Package and Deploy Identity Appliance Unit
Once you're done with the Identity Appliance Unit setup you need to package and deploy it. This is done using next command:
karaf@atricore:/> idbus:deployIdau first-idau c:/temp/my-idaus
This command will create an Identity Appliance Unit package - which is also and OSGi bundle - identified as first-idau and located within the c:/temp/my-idaus folder onto the Atricore Identity Bus.
Before accessing the IDAU endpoints, make sure that IDAU is up and running by using the osgi:list | grep $idau-name console command.