Note: Please get acquainted with this instruction to successfully set up SAML for Docupace. Proceed on the next steps if you have all the preferred professional services mentioned below. Otherwise, request the professional services to create a Change Request (CR) for the aspects of this configuration that are custom to the custom configuration on your specific requirements.
To set up Security Assertion Markup Language (SAML), stick to the following process:we follow this process.
...
Rw ui steps macro | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
The Client provides Provide Docupace with the name of the Identity Provider (IDP) for setting it up.
Docupace Professional Services (or Support) creates a ticket with:
| Jira workflow |
Rw step |
---|
Docupace sets up the a SAML site for SAML and then sends the site URL to it. From the SAML site, where customer you can download the Service Provider (SP) Metadata.
Rw step |
---|
Customer providesProvide Docupace with the following information:
IdentifyIdentity Provider (IDP) Metadata.
Test user in the IDP for the SSO testing.
Note: If you need to set up your connection before providing the metadata, the default configuration for a site is
Audience or Audience Restriction: https://host/sitename (URL without the
_ui
)AssertionConsumerService: https://host/sitename_ui/samlCallback?client_name=default
The client_name value may be different if setting up multiple SSO connections.
Info |
---|
Example:
|
Rw step |
---|
Docupace SRE Site Reliability Engineering (SRE) team at Docupace configures the SAML site with the Identity Provider (IDP) Metadata.
Rw step |
---|
Docupace Business Analyst (BA) creates a test user provided by linked to the Customer that matches one that you provided in Step 3.
Tip |
---|
Tip: The test user must match the username in IDP. |
Rw step |
---|
Docupace informs the Customer you when the SAML setup is completed and then complete. Then, Docupace provides the URL for the Service Provider (SP) initiated by the Identity Provider (IDP).
Rw step |
---|
Customer tests You test the SAML integration using the Service Provider URL provided by Docupace.
Tip |
---|
Tip: Testing |
the SAML integration confirms that the configuration at both ends has been completed successfully for both Service Provider and Identity Provider initiated by SSO. |
Infonote |
---|
ImportantTroubleshooting: If the test testing fails after accomplishing all the preferred actions, schedule a meeting between Docupace and the Customer's Identity Prover’s experts. During that meeting, the Customer’s experts and Docupace SAML experts will test the integration in the real-time environment, which can troubleshoot the SAML configuration. As a result, experts will determine whether they need to involve professional servicesDocupace will contact your Identity Provider to troubleshoot it along side their technical experts to adjust the configuration as needed. |