Explore section lists all the community-contributed, ready-to-use Agama projects. It contains the most frequently used authentication journeys like passwords, passkeys, SMS-OTP, E-Mail OTP, etc. These projects can be downloaded in form of a .gama package and start using after providing a minimal required configuration. An Agama project can be added to an IDP that has an Agama integration. For example, IDPs like Janssen Server, Gluu Flex, etc.
Using Projects From Explore Catalog
- Sign in to the Agama Lab and navigate to the
Exploresection - From the list of available projects, click on the Agama project that you want to use. This will lead you to the GitHub repository for that project
- Go to the
Releasessection of the GitHub repository to locate the most recent release. Each release has anAssetssection that has downloadable.gamaarchive - Download the
.gamaarchive and add it to the IDP. Every IDP that has Agama integration may have different steps for adding a.gamaarchive. - Once the project has been added to the IDP using the
.gamaarchive, we need to provide configuration for the project. - Agama projects take a JSON structured string as configuration. The GitHub repository’s README should provide guidelines about how to structure the configuration JSON.
- Once you have the configuration JSON ready, follow the instructions provided by your IDP on how to add the configuration to the project.
When Using Janssen Server as IDP
Janssen Server comes with Agama Lab integration out-of-the-box. Follow these instructions from Janssen Server project documentation to quickly get and integrate projects from Agama Lab and start using it.
Contributing Projects To The Explore Catalog
The Explore Catalog lists Agama Projects that have been reviewed by Gluu and meet the requirements of the Catalog for license, documentation, and proper organization.