biigle/auth-haai

BIIGLE module to offer authentication via Helmholtz AAI.

v1.0 2025-07-11 11:35 UTC

Requires

• ext-json: *
• socialiteproviders/manager: ^4.4

GPL-3.0-only

• Martin Zurowietz

• biigle
• biigle-module

README

This is a BIIGLE module that provides authentication via Helholtz AAI.

Information on how to register your BIIGLE instance as a new service to Helmholtz AAI can be found here.

Installation

1. Run composer require biigle/auth-haai.
2. Run php artisan vendor:publish --tag=public to refresh the public assets of the modules. Do this for every update of this module.
3. Configure your Helmholtz AAI credentials in config/services.php like this:

   'haai' => [
       'client_id' => env('HAAI_CLIENT_ID'),
       'client_secret' => env('HAAI_CLIENT_SECRET'),
       'redirect' => '/auth/haai/callback',
   ],

4. Run the database migrations with php artisan migrate.

Developing

Take a look at the development guide of the core repository to get started with the development setup.

Want to develop a new module? Head over to the biigle/module template repository.

Contributions and bug reports

Contributions to BIIGLE are always welcome. Check out the contribution guide to get started.