The Service Provider Dashboard is a dashboard application where SURFconext Service Providers can register and manage their services. This can be both SAML 2.0, OpenID Connect Relying Parties and Oauth 2.0 Resource Server entities.
Use docker compose up -d to create and build the development environment.
An entry in your hostsfile is still required for things to work. An example entry would look like:
127.0.0.1 welcome.dev.openconext.local static.dev.openconext.local mujina-sp.dev.openconext.local mujina-idp.dev.openconext.local engine-api.dev.openconext.local oidc.dev.openconext.local manage.dev.openconext.local spdashboard.dev.openconext.local engine.dev.openconext.local teams.dev.openconext.local
Is your host system on an ARM based archetecture CPU, and are you running a docker solution in a VM? Chances are
you are not going to be able to step debug with XDebug. To achieve this you will need to use a slightly different
XDebug setting. In order to deliver those settings into the php-fpm container we suggest you a
docker-compose.overrides.yml file based on the dist file you will find in the docroot. You might need to do some
additional changes to your IDE. This Jetbrains Blogpost
might aid in that area.
This setup includes the OpenConext environment from the Devconf project. You need to checkout this project in the same directory as the sp-dashboard appcode. You will have:
dir/
- sp-dashboard/
- OpenConext-devconf/
In order to start the development environment, run docker compose --profile teams up -d. This will start the container that is
used in development to run the application.
You can then bootstrap the environment. It will ensure that a complete working OpenConext setup is running:
sh ../OpenConext-devconf/core/scripts/init.sh
Then start the command line in the container with docker compose exec -ti spdashboard bash. This will start a shell
Run composer install. This will install all PHP dependencies, including the development dependencies.
Run yarn install. This will install all js dependencies, including the development dependencies.
Run yarn encore dev. This will build the frontend.
Install database migrations
$ docker compose exec spdashboard /var/www/html/bin/console doctrine:migrations:migrate
The application is now up and running and can be accessed at
https://spdashboard.dev.openconext.local/. Note that in development the app_dev.php
front controller is used automatically, so you don't have to include /app_dev.php/ in the URLs.
- To view mails caught by Mailcatcher, visit spdashboard.dev.openconext.local:1080
composer check will run the full suite of tests and static analysis.
Cypress tests only run locally for now. Use npm run cy:open to run them. Please ensure the accessibility tests succeed when making changes in the frontend.
Some remarks:
- The Sp Dashboard sp should be configured with
coin:no_consent_required= 1. Not having this option set will result in a failing authentication sequence. - The Cypress tests should run in your dev environment. No fixture is provided yet to run the tests against.
- Running tests in PROD mode is encouraged (this disengages the web debug toolbar) saving false positives in a11y and html validation errors
- A service with ID = 2 should be present, it should have the add production entities option set.