Skip to main content
Requires administrator access to the InterSystems IRIS Management Portal, or to the admin console of the external authorization server your FHIR server trusts.

Register a SMART app

These steps use the OAuth 2.0 server built into IRIS. On an external authorization server, create a confidential client with the same redirect URL, grant type, authentication type and scopes.

1

Check the authorization server

Sign in to your IRIS Management Portal and open System Administration > Security > OAuth 2.0 > Server.

  • Supported grant types (check at least one): Authorization code selected
  • Return refresh token: If offline_access scope requested
  • Click Save.
  • The Authorization URL and Token URL stay empty when the Issuer endpoint has the same host as your FHIR server. Otherwise, add /oauth2/authorize and /oauth2/token to the Issuer endpoint, or use the endpoints of your external authorization server, and copy them into your Connector Profile.
  • Format: {Issuer endpoint}/oauth2/authorize and {Issuer endpoint}/oauth2/token
  • Example: if the Issuer endpoint is https://auth.example.org, your Authorization URL is https://auth.example.org/oauth2/authorize and your Token URL is https://auth.example.org/oauth2/token
The OAuth 2.0 Authorization Server Configuration page with the Issuer endpoint and the Authorization code grant type highlighted
2

Add the scopes

On the Scopes tab, check that openid, fhirUser, offline_access, user/*.rs and user/*.cud are listed. Patient sign-in also uses launch/patient and patient/*.rs. Add the ones the list is missing.

  • Click Add Supported Scope.
  • Enter supported scope: the scope, such as offline_access
  • Click OK.
  • Click Save.
The Scopes tab with the SMART on FHIR scopes and the Add Supported Scope button highlighted
3

Create the client

On the server configuration page, open Client Descriptions.

  • Click Create Client Description.
  • Name: StackOne
  • Client type: Confidential
  • Click Add URL.
  • Enter URL: the Callback URL from your Connector Profile
  • Click OK.
The Client Description form with Name, Confidential, Redirect URLs, Authorization code and form encoded body highlighted
4

Set the grant and authentication types

These settings on the same form decide how the client gets its tokens.

  • Supported grant types (check at least one): Authorization code
  • Authentication type: form encoded body
  • Click Save.
5

Copy the client credentials

In the OAuth 2.0 Server list, click the new client’s name.

  • Open the Client Credentials tab.
  • Copy the Client ID into your Connector Profile.
  • Click show next to Client secret.
  • Copy the Client secret into your Connector Profile.
The Client Credentials tab with the Client ID field and the show link highlighted

Create the StackOne Connector Profile

1

Create a Connector Profile

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2

Link an Account

Once the Connector Profile is created, continue to link an account.