SAML-Based Single Sign-On
SSO access is a standard for users accessing protected information, such as patient data. Access is provided by creating and enabling a login trust. This allows users to access all WebChart services by signing in one time. When properly configured, users are redirected to the SSO login page to access the system, accordingly.
The following document provides details and considerations for using Security Assertion Markup Language (SAML)-based single sign-on (SSO) with the WebChart systems. WebChart currently supports SAML 2.0 SP-initiated or IDP-initiated workflows with the HTTP-POST binding. WebChart provides a SAML-based SSO application program interface (API). For an in-depth review of SAML, see the public Wikipedia page: https://en.wikipedia.org/wiki/Security_Assertion_Markup_Language
The majority of this document was created for technical staff to utilize for SAML SSO configuration. The sections that follow are technical in nature. For a list of terminology commonly encountered as part of this topic, please see our SSO Documentation.
SAML assertions utilize most of the options detailed throughout the SSO Login Trust documentation. Note that in order to set up the WebChart system as a SAML service provider (SP), the following must be known about the identity provider (IDP):
- The IDP Issuer: This goes in the Domain field of the Login Trust.
- Public Key/Certificate: Used to authenticate the assertions.
- IDP Sign On Service URL: This goes in the Login URL field.
Also, identify any steps required to ensure the IDP-specified subjects will be present in the WebChart system. This may be an interface which creates users, a configuration allowing the IDP to create new users, on demand, or a manual process within the WebChart system.
The IDP must include the following information in the Assertion (shown in XPath notation):
//Assertion/Subject/NameID - This must be the WebChart username, or match a known translation, if enabled.
//Assertion/Issuer - This is the login trust Domain. Identifies the login_trusts entry (IDP) used for validating the assertion.
- XMLDSig - The XML Signature. Must validate using the public key on file for the identified IDP.
- If the Create New Users option has been enabled, the following are also required:
`` https://saml.example.com 5zno9n7vQQIc6bnVbiaUM4272xk= LlHu/jHpIbQAskUs+S1YCqvAo+E+nZnNX3QHZMTJJQ3nCK6Q9ApQk4akUoEqKRd77oJ/PVOXoqnUfWIdE1Mbxg78LCtYSqzT1fvw3Jbwi+eG14+PgjMP5Izx1bTtvFrg2cWI7lOsFrIRxepBgbvD+krTcJMAxVHJSOeYciMM+Vw= https://saml.example.com e9f91ee7-8cd0-4017-9a6c-c8e13be33645 123456789 Sam Jones urn:oasis:names:tc:SAML:2.0:ac:classes:Password