PerunWebApps

This repository contains Perun web applications.

Repository information

All development takes place in public repository on our self-hosted GitLab instance. This repository is mirrored on GitHub for visibility.

See also other related repositories in the Perun IdM group.

Tools and dependencies

1. Install NVM (Node Version Manager) curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash (check NVM GitHub repository for the newest version)
2. Install NodeJS nvm install node
3. Install AngularCLI npm install -g @angular/cli
4. Run npm install
5. For end-to-end tests, install docker (includes docker compose)

Configuration

To deploy an application for production environment:

1. Configure web server Apache/Nginx with certificate
2. Register oidc client for each application at the service provider
3. Register and configure also backend as an OIDC client, if needed (set client id and client secret)
4. Create instance configuration file located at perun-web-apps/apps/<app_name>/src/assets/config/instanceConfig.json and configure the deployed application

To register an app to an SP contact the manager of the given instance.

The common configuration properties of all applications are specified in:

• Common configuration

For specific application configuration please refer to the README files in their respective folders:

• Admin GUI
• Consolidator
• Linker
• Password Reset
• Publications
• User profile

Contributing

If you want to contribute, you can check CONTRIBUTING.md for more details.