Configure the Import Setup Form

After a Developer defines a product as importable, an Import Setup Form pane appears on the Edit Authentication page. The purpose of this form is to collect the information necessary to connect the application to the company when a Company Administrator is importing an application.

To configure the Import Setup Form

Developers must complete the following procedure:

1. Go to Manage > Billing and Distribution > Products > productname | Edit > Integration | Edit Authentication. The Edit Authentication page opens.
2. Edit the authentication fields using the procedure described for each protocol (OpenID Connect, SAML or OpenID 2.0). See Edit authentication documentation.
3. Scroll down to the Import Setup Form.
4. Enter an overview that is visible to Company Administrators when they are prompted to configure this application for single sign-on. For example, the message could advise them that they need to enter the application vendor’s organization identifier and base URL.
5. Enter the steps that Company Administrators must perform in order to manually configure single sign-on for your application. These can be in plain text, or HTML.
   Following is the full list of supported placeholder values that can be embedded in your instructions:

Name	Value	Description
Identity Provider Issuer ID (Entity ID)	idp.issuer	Unique SAML entity ID that represents the marketplace in the SAML configuration
Identity Provider Login URL	idp.login.url	URL to which SAML authentication requests are sent
Signing Certificate URL	certificate.url	URL for the public certificate used to verify SAML assertions
Signing Certificate	certificate.content	Full content of the public certificate used to verify SAML assertions
SAML Identity Provider Metadata URL	metadata.url	URL for the SAML Identity Provider metadata

6. If your authentication configuration requires specific information about the Company Administrator's subscription to your application, that information can be collected in the Placeholder Parameters field. For each piece of data that is needed, click Add Placeholder to create a new placeholder field. Each placeholder that you add creates a field that is included on the Import Application page when the Company Administrator is importing the application. The placeholder identifiers can be entered in your configuration fields and are automatically replaced with the values entered by the Company Administrator.
   Following is an example:
   • Create a placeholder named domain and use domain in your SAML Assertion Consumer Service (ACS) URL, such as https://domain.example.com
   • If the Company Administrator enters testcompany as a value, the ACS is generated as: https://testcompany.example.com
7. Click Save. The product is now configured as an importable application that can be found, imported and managed by a Company Administrator.