Uploading Adeptia Connect Metadata to IdP Server

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.

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

  1. Open the browser and hit the URL in the format:

    <protocol_name>://<ip_address>:<port_number>/saml/metadata

    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. 

    For example, http://192.168.1.10:8080/saml/metadata.

  2. The spring_saml_metadata.xml file will get downloaded to your computer. This file will have the default metadata information. 

    If you want to configure your own SP metadata information in the spring_saml_metadata.xml file then

    • You need to create the following environment variables. 

      For more information on how to create an environment variable on Windows or Linux, refer to this page.

      Variable Name

      Description

      SAML_SSO_METADATA_GENERATOR_ENTITY_ID
      Unique identifier of the service provider. It can be a unique name.
      SAML_SSO_METADATA_GENERATOR_ENTITY_BASE_URL
      URL to redirect Adeptia Connect after successful SAML authentication. 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.
  3. 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.



  4. Type the username and password in the User Name and Password text boxes respectively.
  5. Click Log In.
  6. The User Profile screen appears. 
  7. Click Manage Metadata from the left menu options.
  8. Click Add new Service Provider.



  9. Type the name of the service provider in the Enter the FQDN of the ServiceProvider text box.
  10. (Recommended) Select all attributes (FirstName, LastName, and EmailAddress) in the Attributes sent in assertion
  11. Paste the content of Adeptia (SP) metadata, file downloaded in the first step, in the Insert your metadata information text box.
  12. Click Submit. Your metadata information has been imported successfully.

Once the metadata information has been imported successfully, the next step is, Exposing IdP Metadata to Adeptia Connect.