# Configure external systems

> Configure external systems - How to configure external LDAP and SMTP systems easily, by using the
> configuration management interface in DataRobot.

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-04-24T16:03:56.643627+00:00` (UTC).

## Primary page

- [Configure external systems](https://docs.datarobot.com/en/docs/platform/admin/manage-cluster/sys-config.html): Full documentation for this topic (HTML).

## Sections on this page

- [Change configuration settings](https://docs.datarobot.com/en/docs/platform/admin/manage-cluster/sys-config.html#change-configuration-settings): In-page section heading.
- [Configuration-specific notes](https://docs.datarobot.com/en/docs/platform/admin/manage-cluster/sys-config.html#configuration-specific-notes): In-page section heading.
- [LDAP and SMTP notes](https://docs.datarobot.com/en/docs/platform/admin/manage-cluster/sys-config.html#ldap-and-smtp-notes): In-page section heading.
- [Configuration settings](https://docs.datarobot.com/en/docs/platform/admin/manage-cluster/sys-config.html#configuration-settings): In-page section heading.
- [LDAP settings](https://docs.datarobot.com/en/docs/platform/admin/manage-cluster/sys-config.html#ldap-settings): In-page section heading.
- [SMTP settings](https://docs.datarobot.com/en/docs/platform/admin/manage-cluster/sys-config.html#smtp-settings): In-page section heading.

## Related documentation

- [Account management](https://docs.datarobot.com/en/docs/platform/index.html): Linked from this page.
- [Administrator's guide](https://docs.datarobot.com/en/docs/platform/admin/index.html): Linked from this page.
- [Manage the cluster](https://docs.datarobot.com/en/docs/platform/admin/manage-cluster/index.html): Linked from this page.

## Documentation content

# Configure external systems

> [!NOTE] Availability information
> This feature is only available on the Self-Managed AI Platform.
> 
> Required permission: Enable System Configuration

To minimize iteration time when configuring external LDAP and SMTP systems, DataRobot provides a configuration management interface to ensure compatible configuration options. Using the new System Configuration interface, configuration values related to LDAP and SMTP can be controlled dynamically without the need to reconfigure the application, saving time and making the process more user friendly. All changes made through the interface are also recorded in the audit logs for future reference.

To work with the interface, select System Configuration from the Settings dropdown:

## Change configuration settings

The method for setting values is the same for all configuration options. See the full lists of [LDAP](https://docs.datarobot.com/en/docs/platform/admin/manage-cluster/sys-config.html#ldap-settings) and [SMTP](https://docs.datarobot.com/en/docs/platform/admin/manage-cluster/sys-config.html#smtp-settings) settings below.

To change settings:

1. Select an option from theSystem Configurationpage (LDAP or SMTP). The list of configuration settings updates to display those specific to that option. The current configuration setting value is automatically populated in theOPTIONfield. The displayed value is based on the default and/or theconfig.yamlvalue. It is displayed in read-only mode.
2. To override a current configuration setting value, toggle the setting'sOVERRIDE. When toggled on, theOPTIONfield becomes editable.
3. Change theOPTIONfield to the desired value and clickSAVE. The system immediately updates to use the new configuration value across the application (and the toggle remains on).
4. To revert settings to the default/config.yamlvalue:

## Configuration-specific notes

The following provide some option-specific details.

### LDAP and SMTP notes

For LDAP and SMTP options, in addition to the Save and Reset buttons, there is also a Test button. Use it to validate the current configuration setting values and catch errors that could result from an invalid configuration (e.g., incorrect LDAP or SMTP authentication settings). It is highly recommended that you use the Test option to confirm no errors before saving changes to LDAP- and SMTP-related configuration settings.

> [!NOTE] Note
> Saving invalid configuration settings could result in users (including the Admin user):
> 
> LDAP: being locked out of the application, requiring a fix from your support representative.
> SMTP: losing the ability to generate email notifications.

## Configuration settings

The following sections list settings by type.

### LDAP settings

- USER_AUTH_LDAP_ATTR_EMAIL_ADDRESS
- USER_AUTH_LDAP_ATTR_FIRST_NAME
- USER_AUTH_LDAP_ATTR_LAST_NAME
- USER_AUTH_LDAP_ATTR_UNIX_USER
- USER_AUTH_LDAP_BIND_PASSWORD
- USER_AUTH_LDAP_CONNECTION_OPTIONS
- USER_AUTH_LDAP_DIST_NAME_TEMPLATE
- USER_AUTH_LDAP_GLOBAL_OPTIONS
- USER_AUTH_LDAP_GROUP_SEARCH_BASE_DN
- USER_AUTH_LDAP_ORGANIZATION_NAME_ACCOUNT_ATTRIBUTE
- USER_AUTH_LDAP_REQUIRED_GROUP
- USER_AUTH_LDAP_REQUIRED_GROUP_ACCOUNT_ATTR
- USER_AUTH_LDAP_REQUIRED_GROUP_MEMBER_ATTR
- USER_AUTH_LDAP_SEARCH_BASE_DN
- USER_AUTH_LDAP_SEARCH_FILTER
- USER_AUTH_LDAP_SEARCH_SCOPE
- USER_AUTH_LDAP_URI
- USER_AUTH_SERVICE_USERNAMES
- USER_AUTH_TYPE

### SMTP settings

- DEFAULT_SENDER
- DEFAULT_SUPPORT
- SMTP_ADDRESS
- SMTP_CONNECTION-_TIMEOUT_SECONDS
- SMTP_MODE
- SMTP_PASSWORD
- SMTP_PORT
- SMTP_USER