Uploading Adeptia Suite metadata to IdP Server

Owned by Saurabh Gupta (Unlicensed)
Last updated: Jul 06, 2023 by Ashhad Alam
2 min read

Uploading Adeptia Suite metadata to IdP server allows the IdP server to fetch the details of Service Provider such as server name, metadata information, certificate, encryption, single logout.

To upload Adeptia Suite metadata, you need to first download Adeptia Suite (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>/adeptia/saml2/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 Suite.

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

    For example, http://192.168.1.10:8080/adeptia/saml2/metadata.
    <registration_Id> is the name of the IdP, defined in the saml.properties file, to which you want to import Adeptia Suite metadata. 

    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, do the followings:

    1. Go to .../<AdeptiaInstalledFolder>AdeptiaServer/ServerKernel/etc/saml folder.
    2. Open saml.properties file in the Text Editor.

    3. Provide your SP metadata information in the following properties.

      Property NameDescription
      SAML_SSO_METADATA_GENERATOR_ENTITY_ID
      		Unique identifier of the Service Provider.
      SAML_SSO_METADATA_GENERATOR_ENTITY_BASE_URL
      		URL to redirect Adeptia Suite 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 Suite is running in the URL.
    4. Save the file.
    5. Repeat Step 1. The spring_saml_metadata.xml file will have the SP metadata information as specified in the saml.properties file.

  2. Open the browser, and hit the URL of the IdP.
    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. 

    The steps to upload the metadata file may vary from one IdP to another.



  3. Enter the username and password in the User Name and Password fields respectively.
  4. Click Log In.
    The User Profile screen appears. 
  5. Click Manage Metadata from the left menu options.
  6. Click Add new Service Provider.



  7. Enter the name of the Service Provider in the Enter the FQDN of the ServiceProvider field.
  8. (Recommended) Select all attributes (FirstName, LastName, and EmailAddress) in the Attributes sent in assertion field. 
  9. Paste the content of Adeptia (SP) metadata file, downloaded in the first step, in the Insert your metadata information field.
  10. Click Submit.