> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect InterSystems IRIS for Health with Basic Authentication – StackOne Hub

> Link a InterSystems IRIS for Health account in the StackOne Hub using Basic Authentication. End-user guide to authorize the integration and start using InterSystems IRIS for Health actions.

> [!WARNING]
>
> Requires administrator access to the InterSystems IRIS Management Portal.

## Get a user name and password

The **User Name** and **Password** belong to a dedicated IRIS user that you create for this connection. Its roles decide what the connection can reach.

**1. Create the user**

Sign in to your IRIS Management Portal and open **System Administration** > **Security** > **Users**.

<ul>
  <li>Click **Create New User**.</li>
  <li>**Name**: `stackone_fhir`. Copy it across to **User Name**.</li>
  <li>**Password**: a strong password. Copy it across.</li>
  <li>**Password (confirm)**: the same password</li>
  <li>Click **Save**.</li>
</ul>

![The Edit User form with the Name, Password and Password (confirm) fields and the Save button highlighted](https://mintcdn.com/stackone-60/I9nTEOTYDON35hNB/connectors/intersystemsfhir/images/basic-config-create-user.png?fit=max\&auto=format\&n=I9nTEOTYDON35hNB\&q=85\&s=07fb7139db0539843153b2b3eb04a993)

**2. Assign the roles**

On a default FHIR server, the user reads and writes FHIR data with no roles. On the user's **Roles** tab, assign the roles that apply:

<ul>
  <li>A role that holds the FHIR server's **Required Resource**, when **FHIR Server Authorization Settings** sets one</li>
  <li>For the bulk export actions, `%HS_BFC_Exporter`, plus a role with Use on `%HS_BFC_Export_System`, `%HS_BFC_Export_Patient`, `%HS_BFC_Export_Group` and `%HS_BFC_Export_Download`, and Read and Write on `%HS_BFC_Export_Status`</li>
  <li>Select each role in **Available**.</li>
  <li>Click the right arrow.</li>
  <li>Click **Assign**.</li>
</ul>

![The Roles tab with the Available list, the right arrow and the Assign button highlighted](https://mintcdn.com/stackone-60/I9nTEOTYDON35hNB/connectors/intersystemsfhir/images/basic-config-assign-roles.png?fit=max\&auto=format\&n=I9nTEOTYDON35hNB\&q=85\&s=9f39e7d7f1626d9991590fe098d2ab72)

## Find the server URLs

Both URLs start with the address of your IRIS web server.

**1. Find the FHIR R4 Base URL**

In the Management Portal, open **Health** > your FHIR namespace > **FHIR Server Management**. The server card shows the endpoint path after **URL:**.

<ul>
  <li>Format: `https://{IRIS web server host}{URL path}`</li>
  <li>Example: if you reach the Management Portal at `https://iris.example.org/csp/sys/UtilHome.csp` and the card shows `URL: /csp/healthshare/fhirserver/fhir/r4`, your **FHIR R4 Base URL** is `https://iris.example.org/csp/healthshare/fhirserver/fhir/r4`</li>
</ul>

![The FHIR Server Management page with the server card's URL highlighted](https://mintcdn.com/stackone-60/I9nTEOTYDON35hNB/connectors/intersystemsfhir/images/basic-config-fhir-server-url.png?fit=max\&auto=format\&n=I9nTEOTYDON35hNB\&q=85\&s=993769812dc9e65aae85baff518ab27b)

**2. Find the Bulk FHIR Coordinator URL**

The **Bulk FHIR Coordinator URL** is needed only for the bulk export actions. Open **Health** > your FHIR namespace > **Bulk FHIR Coordinator**. Use the configuration that has **Basic Authentication** as its **Auth Adapter** and lists the service user under **Authorized Users**.

<ul>
  <li>Format: `https://{IRIS web server host}{Endpoint}`</li>
  <li>Example: if the configuration's **Endpoint** is `/bulkfhir/r4`, your **Bulk FHIR Coordinator URL** is `https://iris.example.org/bulkfhir/r4`</li>
</ul>

![The Bulk FHIR Configurations list with a configuration's Endpoint highlighted](https://mintcdn.com/stackone-60/I9nTEOTYDON35hNB/connectors/intersystemsfhir/images/basic-config-bulk-fhir-endpoint.png?fit=max\&auto=format\&n=I9nTEOTYDON35hNB\&q=85\&s=eab44ec3a2cf014780192efe52981c4f)

## Link the Account

**1. Connect**

<ul>
  <li>Click **Connect**.</li>
  <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
  <li>Once authorization is successful, you will see a confirmation popup.</li>
</ul>

**2. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.