orchestrator

README

Configuration

Use the following environment variables to configure the orchestrator:

General configuration:

• ORCA_PUBLIC_BASEURL (required): base URL of the public endpoints.
• ORCA_PUBLIC_ADDRESS (required): address the public endpoints bind to (default: :8080).
• ORCA_LOGLEVEL: log level, can be trace, debug, info, warn, error, fatal, panic, or disabled (default: info).

Required configuration for Nuts:

• ORCA_NUTS_PUBLIC_URL: public URL of the Nuts, used for informing OAuth2 clients of the URL of the OAuth2 Authorization Server, e.g. http://example.com/nuts.
• ORCA_NUTS_API_URL: address of the Nuts node API to use, e.g. http://nutsnode:8081.
• ORCA_NUTS_SUBJECT: Nuts subject of the local party, as it was created in/by the Nuts node.
• ORCA_NUTS_DISCOVERYSERVICE: ID of the Nuts Discovery Service that is used for CSD lookups (finding (local) care organizations and looking up their endpoints).

Configuration for Care Plan Contributor functionality:

• ORCA_CAREPLANCONTRIBUTOR_CAREPLANSERVICE_URL: FHIR base URL of the CarePlan service.
• ORCA_CAREPLANCONTRIBUTOR_STATICBEARERTOKEN: Secures the EHR-facing endpoints with a static HTTP Bearer token. Only intended for development and testing purposes, since they're unpractical to change often.
• ORCA_CAREPLANCONTRIBUTOR_FHIR_URL: Base URL of the FHIR API the CPC uses for storage.
• ORCA_CAREPLANCONTRIBUTOR_FHIR_AUTH_TYPE: Authentication type for the CPC FHIR store, options: `` (empty, no authentication), azure-managedidentity (Azure Managed Identity).
• ORCA_CAREPLANCONTRIBUTOR_FHIR_AUTH_SCOPES: OAuth2 scopes to request when authenticating with the FHIR server. If no scopes are provided, the default scope might be used, depending on the authentication method (e.g. Azure default scope).
• ORCA_CAREPLANCONTRIBUTOR_APPLAUNCH_SOF_REDIRECTURI: SMART App launch redirect URI that is used to send the code to by the EHR
• ORCA_CAREPLANCONTRIBUTOR_APPLAUNCH_SOF_CLIENTID: The client_id assigned by the EHR
• ORCA_CAREPLANCONTRIBUTOR_APPLAUNCH_SOF_CLIENT_SECRET: The client_secret assigned by the EHR
• ORCA_CAREPLANCONTRIBUTOR_APPLAUNCH_SOF_SCOPE: Any specific scope, for example launch fhirUser
• ORCA_CAREPLANCONTRIBUTOR_APPLAUNCH_DEMO_ENABLED: Enable the demo app launch endpoint (default: false).
• ORCA_CAREPLANCONTRIBUTOR_APPLAUNCH_DEMO_FHIRPROXYURL: Enable FHIR proxy for demo purposes on /demo/fhirproxy, which proxies requests to this URL.
• ORCA_CAREPLANCONTRIBUTOR_SESSIONTIMEOUT: Configure the user session timeout, use Golang time.Duration format (default: 15m).
• ORCA_CAREPLANSERVICE_ENABLED: Enable the CPS (default: false).
• ORCA_CAREPLANSERVICE_FHIR_URL: Base URL of the FHIR API the CPS uses for storage.
• ORCA_CAREPLANSERVICE_FHIR_AUTH_TYPE: Authentication type for the CPS FHIR store, options: `` (empty, no authentication), azure-managedidentity (Azure Managed Identity).
• ORCA_CAREPLANSERVICE_FHIR_AUTH_SCOPES: OAuth2 scopes to request when authenticating with the FHIR server. If no scopes are provided, the default scope might be used, depending on the authentication method (e.g. Azure default scope).

Configuration to enable Care Plan Service functionality:

• ORCA_CAREPLANSERVICE_ENABLED: Enable the CPS (default: false).
• ORCA_CAREPLANSERVICE_FHIR_URL: Base URL of the FHIR API the CPS uses for storage.
• ORCA_CAREPLANSERVICE_FHIR_AUTH_TYPE: Authentication type for the CPS FHIR store, options: `` (empty, no authentication), azure-managedidentity (Azure Managed Identity).
• ORCA_CAREPLANSERVICE_FHIR_AUTH_SCOPES: OAuth2 scopes to request when authenticating with the FHIR server. If no scopes are provided, the default scope might be used, depending on the authentication method (e.g. Azure default scope).

App Launch options

Demo

Redirect the browser to /demo-app-launch, and provide the following query parameters:

• patient: reference to the FHIR Patient resource.
• servieRequest: reference to the FHIR ServiceRequest resource that is being requested.
• practitioner: reference to the FHIR PractitionerRole resource of the current user.
• iss: FHIR server base URL.

SMART on FHIR