Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Uploading Adeptia Connect metadata to IdP server allows IdP server to fetch the details of Service Provider (such as server name, metadata information, certificate, encryption, single logout, and much more) of Service Provider .

To upload the Adeptia Connect metadata, you need to first download Adeptia Connect (SP) metadata file, and then upload it to the IdP server. Perform the following steps to upload Adeptia Connect metadata to IdP Server:

  1. Open the browser and hit the URL in the format :to download the Adeptia (SP) metadata file.

    <protocol_name>://<ip_address>:<port_number>/samlsaml2/service-provider-metadata/<registration_Id>

    where,

    <protocol_name> is the name of the protocol, for example, HTTP or HTTPS.

    <ip_address> is the IP address of the computer hosting Adeptia Connect.

    <port_number> is the port number of the computer hosting Adeptia Connect.

    <registration_Id> is the name of the IdP defined in the property SAML_SSO_IDPS_CONFIGURATION_0_REGISTRATION_ID in the saml.properties file. The default value for this property is default.

    For example, http://192.168.1.10:8080/samlsaml2/service-provider-metadata/default.

    The spring-<registration_saml_Id>-metadata.xml file will get downloaded to your computer. This file will have the default metadata information. 

    Image RemovedentityID

    Id>-metadata.xml file, you need to configure the following properties in the saml.properties file. 

    Info

    If you want to configure your own SP metadata information in the the spring-<registration_saml_metadata.xml file then

  2. Go to ...<ConnectPortalInstallFolder>/resources_config/saml folder.
  3. Open securityContext.xml file in the Text Editor.
  4. Provide your SP metadata information in the following properties.

    Property Name

    Description

    Variable Name

    Description

    SAML_SSO_METADATA_GENERATOR_ENTITY_ID
    Unique identifier of the service provider. It can be a unique name.
entityBaseURL
SAML_SSO_METADATA_GENERATOR_ENTITY_BASE_URL
URL to redirect Adeptia Connect after successful SAML authentication.
Needs
It needs to be a URL with protocol, server, port, and context path. If you are communicating over SSL protocol, provide the protocol name as https and port number on which Adeptia Connect is running in the URL.
BindingSSOBindings to be included in the metadata for WebSSO profile. Supported values are POST, Artifact, and PAOS.
  • Save the file.
  • Repeat Step 1. The spring_saml_metadata.xml file will have the SP metadata information as specified in the securityContext.xml file. 
  • Open the IdP server, here the following steps have been explained for SSO Circle IdP server. The steps to upload the metadata file may vary from server to server.

    SAML_SSO_IDPS_CONFIGURATION_0_REGISTRATION_ID

    Enter a registration id based on your requirement



  • Open the browser, and enter the URL in the format.

    <protocol_name>://<ip_address>:<port_number>

    Depending upon the IdP server that you're using, the login page appears. For example, the screen below depicts the login page of SSOCircle IdP.
    Image Added

  • Type the username and password in the User Name and Password text boxes respectivelythe respective fields.
  • Click Log In.
  • The User Profile screen appears. 
  • Click Manage Metadata from the left menu options.
  • Click Add new Service Provider.
    Image Removed
    Image Added

  • Type the name of the service provider Service Provider in the Enter the FQDN of the ServiceProvider text box.
  • (Recommended) Select all the attributes (FirstName, LastName, and EmailAddress) in the Attributes sent in assertion
  • Paste the content of Adeptia Connect (SP) metadata , (file downloaded in the first step, ) in the Insert your metadata information text box.
  • Click Submit . Your metadata information has been imported successfully.
  • Once the metadata information has been imported successfully, next step is to place the IdP metadata information within Adeptia Connect
    1. to upload the metadata.