Adding your server

To access your FHIR server in Vanya you need to add and configure the server from the Vanya home screen. To get started, click the “Add New Server” button as shown below.

Add FHIR server

When the Server Details dialog will appears, fill in the required values on the first tab page:

FHIR server settings

- Name
A user friendly name for your server.

- URL
The complete accessible URL for your FHIR server.

- Groups
This is an optional field. If you had previously set up some server groups you can select them from the drop down list here.

- FHIR Version
Vanya currently supports only FHIR R4, so this option is pre selected.

Authentication Methods


Different FHIR servers authenticate in different ways. You should choose whichever method is appropriate to your server. The documentation links to the left provide details for connecting to individual server providers.

Possible authentication options are:

- No authentication
Publicly accessible servers often require no authentication. Servers running locally (localhost) may also not require authentication.

- OAuth
The most common authentication method. Vanya supports bearer token OAuth flows using “client_credentials” of “password” grant types.

- AWS
AWS healthlake uses a unique Signature 4 authentication method.

- GCP
Google cloud FHIR stores can be accessed using a Service Account Key configurable inside your GCP portal.

- Headers
Various custom request headers such as API keys can be configured here.

If your authentication method is not supported by Vanya or if you experience any difficulty when configuring your FHIR server, contact us and we’ll work with you.