FhirClient

This project was generated with Angular CLI version 16.0.0.

Foundry

A live demo is hosted by HL7 FHIR Foundry, where you may also download curated configurations to run yourself.

Running locally

1. Install Node.js (tested on Node.js 18+)
2. Clone the repository

   git clone https://github.com/HL7-FAST/identity-matching-ui/

3. Install node-modules:

   npm ci

4. Run the application

   npm start

5. The application is now running on http://localhost:4200

Running in Docker

1. Install Docker
2. Clone the repository

   git clone https://github.com/HL7-FAST/identity-matching-ui/

3. Use Docker Compose or build and run the Docker image

Using Docker Compose

1. Build and run:

   docker compose up

   or detached:

   docker compose up -d

Building and running Docker image

1. Build the identity-matching-ui image:

   docker build -t identity-matching-ui .

2. Run identity-matching-ui in Docker:

   docker run -p 80:80 identity-matching-ui

   or detached:

   docker run -dp 80:80 identity-matching-ui

3. The application is now running on http://localhost

Auth Code Flow Config

You will need to configure your identity provider or remove the security from the project

import { AuthConfig } from 'angular-oauth2-oidc';

export const authCodeFlowConfig: AuthConfig = {
  // Url of the Identity Provider
  issuer: '',

  // URL of the SPA to redirect the user to after login
  redirectUri: window.location.origin + '/',

  loginUrl: window.location.origin + '/',

  // The SPA's id. The SPA is registerd with this id at the auth-server
  // clientId: 'server.code',
  clientId: '',

  // Just needed if your auth server demands a secret. In general, this
  // is a sign that the auth server is not configured with SPAs in mind
  // and it might not enforce further best practices vital for security
  // such applications.
  // dummyClientSecret: 'secret',
  dummyClientSecret: '',

  responseType: 'code',

  // set the scope for the permissions the client should request
  // The first four are defined by OIDC.
  // Important: Request offline_access to get a refresh token
  // The api scope is a usecase specific one
  scope: 'openid profile email',

  showDebugInformation: true,
};

To disable security you can remove this section from app.module.ts

OAuthModule.forRoot({
    resourceServer: {
        allowedUrls: [`${environment.baseApiUrl}`],
        sendAccessToken: true
    }
})

You will probably also want to remove the AuthBypassInterceptor from interceptor.barrel.ts. This interceptor is related to the auth-bypass component which allows requests to ignore the sceurity settings of the FAST Identity Matching FHIR server. If you are using this against your own fhir server that does not have security enabled this will be uncessary and can be removed as well. The component can be found in the app.module imports as well as app.component.

<span class="toolbar-divider">
    <app-auth-bypass></app-auth-bypass>
</span>

Code scaffolding

Run ng generate component component-name to generate a new component. You can also use ng generate directive|pipe|service|class|guard|interface|enum|module.

Build

Run ng build to build the project. The build artifacts will be stored in the dist/ directory.

Running unit tests

Run ng test to execute the unit tests via Karma.

Running end-to-end tests

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.

Further help

To get more help on the Angular CLI use ng help or go check out the Angular CLI Overview and Command Reference page.