Authentication Protocols - Smile CDR Documentation

Authentication Protocols

Smile CDR supports several mechanisms for authenticating users and systems that are communicating with Smile CDR.

The following diagram shows the various ways you can authenticate with different Smile CDR modules.

HTTP Basic

HTTP Basic Access Authentication is a mechanism that includes credentials (a username and password) included in an HTTP header with each request. The credentials are joined by a : (colon character) and then base64 encoded.

The following example shows a Basic Authentication request header.


Copy

This mechanism is usable only for non-interactive endpoints (i.e. API calls to Smile CDR). Using HTTP Basic requires transmitting raw credentials within the request headers, so it must always be combined with TLS/HTTPS and must not be used in an environment where HTTP headers might be intercepted.

OpenID Connect (OIDC) and SMART on FHIR

OpenID Connect (OIDC) is a specialization of the OAuth2 protocol. The SMART on FHIR specification for connected health applications requires the use of OIDC for authenticating these applications.

Learn more about SMART on FHIR in the SMART on FHIR Overview.

Security Assertion Markup Language (SAML)

SAML is an older standard than OIDC, but is still widely used. It is most commonly used as an enterprise single-sign-on (SSO) provider, allowing users in a corporate environment to authenticate against multiple applications using a central identity provider.

SAML works by passing digitally signed authentication requests and responses in XML document payloads.

Learn more about SAML in the SAML Inbound Security Module documentation.

Authentication Protocols

Security

Authentication Protocols Authorization and Consent Inbound Security Module Local Inbound Security Module LDAP Inbound Security Module Scripted Inbound Security Module SAML Inbound Security Module Trusted Client Mode Roles and Permissions Callback Scripts Anonymous Access Consent Service Consent Service: JavaScript API Consent Service: Java API Security Recipes Two Factor Authentication Password Hashing Algorithms JWT Signature Algorithms Troubleshooting Security

Authorization and Consent