Connector Configuration

This documentation provides more information about connecting your 3DEXPERIENCE platform application to an external SCM system.

The connector provides configuration status information for easy validation. The Status Messages table provides a reference to understanding the Status Messages provided.

Table 1. Status Messages
Configuration Status Message Description
Waiting to be configured There is no information about the connector on the form. The easiest method to configure the connector is to start from your connected app in the 3DEXPERIENCE platform and use the auto configure functionality when creating a new connector. Alternatively, you can manually use the Connector Configuration Fields.
Changes made to settings but not yet saved Save or validate the connector changes. If all the fields are entered, click Validate or Save.
Showing all saved settings The connector changes have been saved, but not validated in this session. The settings may have been validated previously, but it is possible that the URLs being referenced have changed. It may be useful, therefore, to run the Validate operation for assurance that these settings are still correct.
Note: These settings are active and may be in use by any objects configured to use this connector.
Validating URLs... The connector is in the process of validating the settings. Wait until the validation is complete.
SUCCESS – all settings validated but not yet saved The connector has validated the settings, but the settings have not been saved. Save the settings.
SUCCESS - All settings validated and no changes need saving. The connector is configured and validated. Register DesignSync Repositories or Register Git Repositories to make your repositories available to you connected application.
ERROR - one or more settings have problems The connector did not successfully validate. The error message listed provides guidance for how to correct the error.
The allowedResourceDomains pattern does not seem to be valid
Problems Encountered When Saving the General Settings
Could Not Read the General Settings
Connector and 3DSearch URLs Contain Mismatching Domains
Connector URL is Accessible, but Cannot be Confirmed to be a Valid Connector
Connector URL is Accessible and Valid, but Does Not Match the Connector Being Configured
3DPassport URL Cannot be Accessed
3DSearch URL Cannot be Accessed
3DSearch URL Is Accessible, but Relates to a Different 3DPassport URL
3DSearch URL is Accessible, but Cannot be Confirmed to be a 3DPassport-enabled Server
3DPassport or 3DSearch URL Cannot be Accessed, SSL/TLS Error
Unable to Access Connector URL
Undefined Repository Version Type
Table 2. Connector Configuration Fields
Field Description
Enable authentication When enabled, the users must authenticate with 3DPassport first to access the configuration page. In addition, they must be on the list of administrators to access the configuration page.

If not enabled, the configuration data is saved to disk when the form is submitted, with no authentication or access validation. This check box only applies to the configuration page. It does not affect the authentication and access validation for connector service requests.

When the platform is on the cloud and the connector is on premises, this check box is disabled, unless you have entered the connector configuration page from a connector link from the 3DEXPERIENCE platform.
Connector URL

This URL is the link to the external connector service. There are two possible options:

  • If a reverse proxy is in use, this URL is the host of the reverse proxy, including port number and path.
  • If reverse proxy is not in use, the URL is the daemon host for the server running the connector service.
The system may be able to automatically calculate this URL when you press Detect Adapter URL
3DPassport Service URL URL for the 3DPassport service. This must be the same 3DPassport service used by the 3DEXPERIENCE platform configured to use this connector. You can copy this URL from the Show 3DExperience URLs action in your connected application.
Is the 3DPassportserver on the cloud? Select this check box if the 3DPassport service is on the cloud. By default, this is not selected, meaning that the 3DPassport service is on premises.
3DSearch Service URL Location of the 3DSearch service (Required). You can copy this URL from the Show 3DExperience URLs action in your connected application.
Administrators The list of authenticated users allowed to access the connector configuration page and save changes. The list is in alphabetical order, one username per line. For information on using the interface, see Maintaining the Connectors Administrators List
Note: This option may only be visible after Enable Authentication has been specified and saved, and the connector page has been reopened through the connected application on the cloud.
Enable debug tracing When enabled, this enables debug tracing for the connector. The debug information is stored in the Tomee server log file, logs/catalina.out.
Tip: Enable this option only when requested by 3DS Support.
Detect Adapter URL Attempts to automatically deduce the connector URL value from the server.
Ok Saves the Connector Configuration changes.
Cancel Returns you to the previous page without saving any changes.
Help Opens this documentation.