Biid Authentication Node
The Biid Authentication Node allows ForgeRock users to integrate their AM instance with the Biid platform.
NB These instructions assume that an AM 5.5+ instance is already running with users configured.
The following steps detail how to install the node:
- Download the jar file from here.
- Copy the biidAuthNode-1.0.0-no-deps.jar file to the following path on the server:
- Restart AM.
- Login to the Biid Back Office, select the
Entityand click Edit to view it's details. Copy the Entity Key value and save it for Step 10.
- Still in the Biid back office, select and edit the
Entity Appto be used. Copy the App API Key value and again save it for Step 10.
- Login into AM console as an administrator and go to
Realms > Top Level Real > Authentication > Trees.
- Click on Add Tree button. Name the tree
biidand click Create.
- Add 3 tree nodes: Start, Username Collector, and Biid Authentication Initiator.
- Connect them as shown in the image below.
- Select the Biid Authentication Initiator node. Enter values for the Entity Key (saved in Step 4) and the App API Key (saved in step 5). Set the Biid API Server URL to your biid server location NB the URL should be similar to the following
https://api.test-biid.com. Set the Attribute to be used for the Biid username. Setting it to the default value of
snwill mean that the Forgerock username will be used.
- Add 5 nodes: Polling Wait Node, Biid Authentication Decision, Retry Decision Limit, Failure and Success. Connect them as shown in the image below.
- Select the Polling Wait Node and set Seconds To Wait to 15.
- Select the Retry Decision Limit and set the Retry Limit to 4.
- Save changes.
- You can now test the Biid authentication tree by accessing the following URL in your browser :
- When prompted enter the username and hit return. An authentication request will be sent to the biid app through the AM authentication tree. Biid will then verify the username and keys and if everything is correctly configured, an authentication request will appear on the device.