DBLLP Aegis Authenticator OTP Provider for Keycloak

A Keycloak OTP Application Provider that adds Aegis Authenticator to the list of supported OTP applications in Keycloak's OTP setup screen.

Compatibility

• Keycloak 26.4.7
• Java 21

Building

./gradlew build

The JAR will be at build/libs/dbllp-keycloak-aegis-authenticator-otp-provider.jar.

Installation

1. Locate your Keycloak providers directory

This is typically found at providers/ within your Keycloak installation directory. Common locations include:

• Standalone/bare-metal install: <KEYCLOAK_HOME>/providers/
• Docker: /opt/keycloak/providers/ inside the container

2. Copy the JAR

Copy the built JAR into the providers/ directory:

build/libs/dbllp-keycloak-aegis-authenticator-otp-provider.jar  →  <KEYCLOAK_HOME>/providers/

If you are using Docker, you can mount or copy the JAR into the container. For example, in a docker-compose.yml:

volumes:
  - ./dbllp-keycloak-aegis-authenticator-otp-provider.jar:/opt/keycloak/providers/dbllp-keycloak-aegis-authenticator-otp-provider.jar

3. Rebuild and restart Keycloak

After adding a new provider JAR, Keycloak needs to be rebuilt:

<KEYCLOAK_HOME>/bin/kc.sh build    # Linux/macOS
<KEYCLOAK_HOME>\bin\kc.bat build   # Windows

Then restart Keycloak. If you are running Keycloak in development mode (start-dev), the build step happens automatically on startup.

4. Verify

Once Keycloak is running, "Aegis Authenticator" will appear as a selectable OTP application when users configure two-factor authentication.

License

Apache License 2.0 — see LICENSE for details.