interopiO® Authentication & User Directories

As important as registering services (apps, cds hooks, etc.) is the ability to control and monitor who has access to these services. Users added to a User Directory can provide an email and password to access the provider/patient portal or to launch apps.

Two types of user directories exist:

1. Delegated: Dictated by the downstream Auth server associated with a given data adapter. Users can be seen in the User Directory view, but not created, modified, or deleted.
2. interopiO: Can be used in gateways configured to have a default data adapter of a CDR or a data adapter that has an open endpoint. Users in this type can be viewed, created, modified, and deleted.

User Directory Creation

Follow these steps to create a user directory on interopiO:

1. Click the "Authentication" link on left side of screen or the Authentication widget if you're on the environment home page.
2. Click "Add User Directory".
3. In the wizard, provide the "Display name", "User Directory ID" (auto generated but can be manually changed), and "Description". 
4. Click "Add User Directory".

Add Users

Follow these steps to add users to a user directory:

1. From the User Directory view, navigate to the tab labeled "Users".
2. Click "Add User".
3. In this view there are three main sections:
   1. Provide the "Name", "Email", and "Password" for the user.
   2. Select whether the user is a Provider or a Patient.
   3. FHIR data mappings can be added for this user at the bottom. This allows information about the user to be queried by portal or applications at the time of launch:
      1. Select the data adapter where a FHIR® resource about that user is stored. This information can only be received through a gateway configured against that data adapter (see Using interopiO > Gateway Management)
      2. Provide the FHIR® ID that identifies the user's FHIR® resource.
4. Click "Add User".