The SAML IdP connector allows SigningHub to connect with an external SAML v2.0 Identity Provider (IdP) to authenticate users both at the time of login and at the time of signing. There are two pre-requisites of configuring a SAML IdP connector which are:
- The IdP connector is used to get the metadata XML file from the third party i.e. SAML IdP provider (for which this connector is being created). It includes the IdP signing certificate, which is used by SigningHub to verify assertions. If it is not, this must be supplied separately along with the metadata.
- The SigningHub Service Provider requests signing key and associated certificate, e.g. PFX file, generated by using ADSS Server.
- Click the "Configurations" option from the left menu.
- Click the "Connectors" option.
The "Connectors" screen will appear. - Click
from the grid header.
- A dialog will appear to add the connector details. The connector dialog is comprised of two screens, i.e. Basic Information and Details. Specify the basic information and click the "Next" button to provide the respective connector details.
- Click the "Finish" button. A new connector will be saved and displayed in the list.
| SAML IDP Connector | |
| Fields | Description |
| Name |
Specify a unique name for this connector, such as 'My SAML IDP'. This connector will be used in the configuration of Authentication Profiles. |
| Provider | Select the provider for this connector, i.e. "SAML Identity Provider". |
| Purpose | This field will display the purpose of the selected provider above, i.e. the purpose of "SAML Identity Provider" is "Authentication. |
| Logo | Upload a logo image that will appear on login page at the time of login. This is an optional parameter. |
| Browse IdP Metadata |
Browse the IdP metadata XML (from your machine) that is generated from the IdP server. This will auto fill in the related URLs in the below fields. You can also manually specify each URL on individual basis. |
| HTTP POST login URL | HTTP POST login URL that is populated from the IdP metadata XML.
|
| HTTP POST Logout URL | HTTP POST logout URL that is populated from the IdP metadata XML. |
| HTTP Redirect Login URL |
HTTP redirect login URL that is populated from the IdP metadata XML.
|
| HTTP Redirect Logout URL |
HTTP redirect logout URL that is populated from the IdP metadata XML. |
| Binding Type |
This will specify the SAML request type, i.e. Post or Redirect. By default the "Redirect" option is selected. |
| Signature Algorithm |
This will specify the signature algorithm of IdP server, i.e. SHA1 or SHA256. By default the "SHA1" option is selected. |
| IdP Signing Certificate |
As the name indicates this Identity Provider (IdP) Signing Certificate will be used to verify signed response send by IdP.
|
| SP Request Signing Certificate (PKCS#12) |
Browse and select a request signing certificate (PFX file) for the service provider (SP). This certificate (PKCS#12) will be used to perform signature for request.
|
| SP Request Signing Certificate Password |
This will specify the password of the SP Request Signing Certificate (PKCS#12). |
| Required Signed Assertions |
Enabling this check box will allow the SP to verify the signature of the signed response send by IdP. IdP signing certificate will be used for this verification.
|
| Authentication Request Signed |
This check box will enable the user to authenticate requests signing preferences, when it will be enabled, then the SP (service provider) will be able to send signed request to IdP using the SP Request Signing Certificate (PKCS#12) to sign the request.
|
| Export SP Metadata |
Click it to download a signed "SPMetaData.XML" file on your machine for the IdP server. Update this XML on the IdP server for the client-end configuration. |
| Active | Click this check box to make this connector active. Inactive connectors cannot be configured in the Authentication Profiles.
|
Important URL's:
SigningHub supports the single logout profile. To invoke the service the third party IdP should use the URL:
https://web.signinghub.com/saml/logout.
The Assertion Consumer Service URL that the IdP must use to communicate with SigningHub is:
https://web.signinghub.com/saml/sso.
It is recommended that the email address must be in the 'mail', 'email' or 'E-Mail Address' format while configuring outgoing claim types attribute mapping for a relying party.