Management Portal is a front-end component to manage resources registered in Maritime Identity Registry and Maritime Service Registry, the core components of Maritime Connectivity Platform.
This version of Management portal is powered by Clarity Design System.
This project was generated with Angular CLI version 18.2.3.
You can experience a live demo from our public demonstrator environment.
- node v20.17.0+
- pnpm v9.7.0+
- Go 1.24+
The Go WASM module, which is used for generating public/private key-pairs, certificate signing request and PKCS#12 keystores, can be built by running pnpm run build:go.
This needs to be done before performing any of the following actions.
Run ng serve for a dev server. Navigate to http://localhost:4200/. The application will automatically reload if you change any of the source files.
Our project is configured to support multiple environments, specifically production, test, and development (see angular.json at the root folder). The configuration is managed through Angular's built-in environment system, utilizing the /src/environments/ directory. There are three environments given by default:
- development: environment.development.ts
- test: environment.test.ts
- production: environment.ts
Configuration parameter in each file covers:
- production: boolean value of whether a build for production or not
- irBasePath: url of MIR API
- irProvider: name of the MIR provider
- irContact: contact of the MIR provider
- oidcBasePath: url of MIR OIDC (keycloak endpoint for the MCC testbed)
- hasServiceRegistry: boolean value of whether the provider has service registry or not
- srBasePath: url of MSR API if exist
- srProvider: name of the MSR provider
- srContact: contact of the MSR provider
- hasMSRLedger: boolean value of whether the MSR Ledger is connected
- ledgerPath: url of the MSR Ledger
- mpProvider: name of the Management Portal provider
- mpContact: contact of the Management Portal provider
- environmentTitle: title showing at the front page
- termsOfUse: terms of use using in the registration
- idpNamespace: identity provider short ID (IPID in MCP IDsec2 MCC Identity Management and Security; Identity Management) included in MCP MRN, e.g., 'mcc-test'
- environmentName: environment name showing at the front page
- mpName: official name of management portal
- footerName: a name you can put at footer
- footerLink: a link you can put at footer
- logoImg: logo image path, will be shown at the front page, e.g., 'assets/images/logo.svg'
You can use configuration by using -c %CONF_NAME%. Building with test configuration for example, ng build -c test.
You need to build the Go WASM module first to proceed.
Run ng build to build the project. The build artifacts will be stored in the dist/ directory.
Run ng test to execute the unit tests via Karma.
Run ng e2e to execute the end-to-end tests via a platform of your choice. To use this command, you need to first add a package that implements end-to-end testing capabilities.
You need to build the Go WASM module first to proceed.
Run ng deploy --repo=%REPO_TO_DEPLOY% --cname=%URL --dir="dist/management-portal-clr" for GitHub Pages deployment
Currently English(en-GB) and Korean(ko-KR) are supported.
This project is licensed under the Apache 2.0 License - see the LICENSE file for details.