Skip to content

Detailed Installation

Jump to bottom
Michael Schwartz edited this page Jan 15, 2024 · 1 revision

Overview

This project is a sample of password-based authentication. Authentication flow designed and developed using Agama and Agama Lab. If you are interested in low-code development and eager to create your authentication flow with drag-and-drop features, then Agama Lab is the right choice for you.

What is Agama? To gain a better understanding, please visit here.

The "agama-pw" project can be constructed using Agama Lab. To learn more about Agama Lab, please visit here.

Pre-requisite

Let's take a look at what you need:

  1. An account in Agama Lab.
  2. Basic knowledge about Agama.
  3. Commonly used Bean for your authentication flow.
  4. Jans server.

To quickly adapt to Agama projects like "agama-pw" please visit Quick Start Using Agama Lab.

Once flow is completed, you will need to establish a connection between your flow and an engine like Jans Server. To learn more about Engine and Bridge Configuration, please visit here.

Deploy and Test

Deployment

  • Download the release package from the Github releases

    wget https://github.com/GluuFederation/agama-pw/releases/download/v1.0.1/agama-pw.gama

  • Verify integrity of the downloaded package by verifying published sha256sum. Download sha256sum file for the package

    wget https://github.com/GluuFederation/agama-pw/releases/download/v1.0.1/agama-pw.gama.sha256sum

    Check the hash if it is matching

    sha256sum -c agama-pw.gama.sha256sum

    output similar to below should confirm the integrity of the downloaded package.

    agama-pw.gama: OK

  • Follow this guideline to deploy an Agama Project.

Test Deployment

You'll need an OpenID Connect test RP. You can try oidcdebugger, jans-tarp or jans-tent. Check out this video to see an example of agama-pw in action:

https://www.loom.com/share/73edb35bdfbf4497b1ffab17d9a66ad1?sid=354c60b7-7aeb-45dc-b828-b2668f46a6df

Clone this wiki locally