Raid Registration Agency

Table of Contents

1. Getting Started
2. Installation
3. Running the Application
4. Project Structure
5. API Documentation
6. Contributing
7. License

Getting Started

To get started you'll need the following tools installed in your machine:

• Node.js >= 18
• Java >= 17
• Docker >= 27

Installation

1. Clone the repository

git clone  https://github.com/au-research/raid-au.git

2. Build the API

cd raid-au
./gradlew build

3. Install dependencies for the app

cd raid-agency-app
npm install

Running the Application

1. Start the API

./gradlew dockerComposeUp bootRun

2. Start the app

cd raid-agency-app
npm run dev

Project Structure

api-svc/db	The database migrations (handled by flyway) and generated database classes (handled by JOOQ)
api-svc/idl-raid-v2	OpenApi specs and code generation for API controllers
api-svc/raid-api	API Spring Boot application
iam/realms	Keycloak configuration used in local environment/integration tests. Loaded at startup
iam/src	Keycloak SPIs to handle group/raid permissions.
sso/	Docker config for Satosa. This allows SAML authentication between AAF and Keycloak for eduGAIN

API Documentation

• Swagger
• RAiD Metadata Schema

Contributing

We welcome contributions from the community! Whether you're fixing bugs, adding new features, improving documentation, or suggesting ideas, we'd love to have your input. Feel free to raise a pull request (include tests).

License

This project is licensed under the Apache 2.0 License - see the license.txt file for details.