Skip to main content

SSO

Description

Single Sign-On (SSO) is a mechanism that enables applications within the EHR Bridge network to securely connect to other applications and share the login context of a user. The primary use case of SSO is when a provider within an Electronic Health Record (EHR) launches an integrated application, and the user is automatically logged in to the application without having to enter their credentials again.

SignOn

This information is sent in the body of the POST request. It provides a mapping between existing EHR Bridge sources and destinations, as well as the claims in the JSON web token in a EHR Bridge Data Model Format.

API endpoints for Single Sign-On

Sync REST API Endpoint to call the API: https://{base_url}/api/v1/sso/signon.

Async REST API Endpoint to call the API: https://{base_url}/api/v1/endpoint.

Data Model JSON for SignOn

SignOn - Sample Payload
{
"Meta": {
"DataModel": "SSO",
"EventType": "Sign-on",
"EventDateTime": "2017-11-02T20:37:41.634Z",
"Test": true,
"Source": {
"ID": "47393f89-ec81-49db-abc6-84b8bfbc423c",
"Name": "EHR Bridge Dev Tools"
},
"SessionID": "abcd",
"SessionBaseURL": "https://api.ehrbridge.com/fhir/R4/ehr-fhir-sandbox/Development",
"Destinations": [
{
"ID": "de4742bd-7a99-430e-a739-db159e989318",
"Name": "Destinations EMR"
}
],
"FacilityCode": null
},
"Subject": "https://healtsystem.com/provider/4356789876",
"Expiration": "2022-08-16T14:36:21.718Z",
"IssuedAt": "2022-08-16T14:21:21.718Z",
"UserId": null,
"Name": "Booby Grant",
"FirstName": "Bobby",
"LastName": "Grant",
"MiddleName": null,
"EmailAddress": null,
"NPI": "4356789876",
"ProviderSpecialty": null,
"TimeZone": "America/Chicago",
"Locale": "en-US",
"PhoneNumber": {
"Office": "+16087851234"
},
"Patient": {
"Identifiers": [
{
"ID": "0000000001",
"IDType": "MR"
},
{
"ID": "7ef09441-f98b-4c72-80aa-ecae5ece748d",
"IDType": "EHRID"
},
{
"ID": "73814df3-f851-4987-b172-8ca5a4bfb431",
"IDType": "NIST"
}
],
"Demographics": {
"FirstName": "John",
"LastName": "F",
"MiddleName": "Marker",
"DOB": "2008-01-06",
"Sex": "Male",
"PhoneNumber": {
"Home": "+18088675301",
"Office": null,
"Mobile": null
},
"Address": {
"StreetAddress": "4762 Fairfield Street",
"City": "San Jose"",
"State": "CA",
"ZIP": "53566",
"County": "Santa Clara",
"Country": "USA"
}
}
},
"Visit": {
"VisitNumber": null,
"Location": {
"Type": "Inpatient",
"Facility": "MGM Hospital",
"Department": "3N",
"Room": "136"
}
},
"Order": {
"ID": null
}
}