MyConext

Me environment for OpenConext

Getting started

System Requirements

• Java 8
• Maven 3
• MongoDB 3.4.x
• Yarn 1.x
• NodeJS
• Ansible

Building and running

The myconext-server

This project uses Spring Boot and Maven. To run locally, type:

cd manage-server

mvn spring-boot:run -Drun.jvmArguments="-Dspring.profiles.active=dev"

When developing, it's convenient to just execute the applications main-method, which is in Application. Don't forget to set the active profile to dev.

The account-gui

The myconext client is build with Svetle and to get initially started:

cd manage-gui
yarn install
yarn dev

Browse to the application homepage.

The myconext-gui

The Guest-IdP is also build with Svelte and to get initially started:

cd manage-gui
yarn install
yarn start

There is no home page, you'll need to visit a SP and choose the Guest IdP to login.

Build

To deploy production bundles

mvn deploy

Crypto

The myconext application uses a private RSA key and corresponding certificate to sign the SAML requests. We don't want to provide defaults, so in the integration tests the key / certificate pair is generated on the fly. if you want to deploy the application in an environment where the certificate needs to be registered with the Service Provider (Proxy) then you can generate a key pair with the following commands:

cd myconext/myconext-server/src/main/resources
openssl genrsa  -out myconext.pem 2048
openssl req -subj '/O=Organization, CN=OIDC/' -key myconext.pem -new -x509 -days 365 -out myconext.crt

Add the key pair to the application.yml file:

private_key_path: classpath:/myconext.pem
certificate_path: classpath:/myconext.crt

Miscellaneous

To get an overview of the git source file's:

cloc --read-lang-def=cloc_definitions.txt --vcs=git

Migration

Migrate your account