Switch branches/tags
Azure-Add-Nuget-Settings-Update CONTRAST-7831 CONTRAST-8781 CONTRAST-12222-protect-docs CONTRAST-14638-trouble-java CONTRAST-17463-re/move-articles CONTRAST-17470-what-is-contrast CONTRAST-17566 CONTRAST-18659-profiler-docs CONTRAST-20358-config CONTRAST-20381 CONTRAST-20663-update-ruby-config CONTRAST-20961-freemium-docs CONTRAST-21091-Add-VS-Plugin-Doc CONTRAST-21316-remove-appname CONTRAST-21554-remove-assembly CONTRAST-23556-integrated-service CONTRAST-23556-speedracer CONTRAST-23895-flask-app CONTRAST-25182-Add-Dotnet-Chaining CONTRAST-25851-service-clarification CONTRAST-25851-service-flag CONTRAST-26040-common-config CONTRAST-26040-dotnet-adjust CONTRAST-26040-node-common-config-changes CONTRAST-26732-pki CONTRAST-26736-cert-config CONTRAST-26737-node-docs CONTRAST-26999-java-common-config CONTRAST-27030 CONTRAST-27099-custom-metadata-java CONTRAST-27165-apps-grid CONTRAST-27166-server-grid CONTRAST-27312-node-config-emph CONTRAST-27409-changes-to-support-contrast-env-var-prefix CONTRAST-27463-node-10-lts CONTRAST-27975-remove-dotnet-proxy-host CONTRAST-28172-java-docker CONTRAST-28194 CONTRAST-28440-vsts-backlogs Contrast-AlexB-patch-1 DanFiedler-AddSystemReqs DanFiedler-FormatSuppTech Node-Install-Config-Updates OD3-Test-LayoutUpdates OD3-Test-Merged OD3-Test-TerraGood-MikeGood-Synced OD3-Test-TerraGood OD3-Test Release-356-Profiler-Chaining-Flag-Fix Update_General_Properties ZD#9080-Supported-LDAP-Servers bamboo contrast-25989-exec-helper-troubleshooting contrast-26111-verify-java-exec-helper ddooley77-patch-1 dhafley-patch-1 distributed-config dotnet-directory-changes fix-appname ide-plugins installer_doc j0nS3idman-patch-1 j0nS3idman-patch-2 j0nS3idman-patch-3 j0nS3idman-patch-4 j0nS3idman-patch-5 javaagent-appname-change linux-pkgs master mobile-help-doc nahsra-cve-shields nahsra-protect-rules-update nginx-path-typo node-8 node-env opendocs-redesign-links org-stats-filename-bug orientation-tests rebranding remove-profilerBehavior revert-525-CONTRAST-27047 reword-node-OS-support route-coverage-jersey rss search solarisSupport static-site-generator test-image-standards update-node-config wrong-min-version zookeeper_docs
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
74 lines (44 sloc) 4.88 KB

Enterprise-on-Premises (EOP) customers can manage their own instance of Contrast, including security policy, database settings and authentication. To modify system configuration settings for the Contrast application, you must have the SuperAdmin role. Individual users can be granted SuperAdmin permission on a case-by-case basis. Organization Admins can also access and change many of these settings for a specific organization in Organization Settings.

Find System Settings

To get started in System Settings, log in to your Contrast application. Go to the user menu in the top right corner (by your profile name and image), and select SuperAdmin. Once you're in the SuperAdmin view, open the user menu again, and select System Settings.

General Settings

General settings define the Contrast application URL for both browsing and RESTful requests. In addition, you want to integrate with Contrast Hub for library and CVE updates, you can select the option to "Try Hub". Any change to this value will require you to Restart Contrast.

If you moved the installation or had to change the hostname or IP address, here is the place to make that change. Simply update the TeamServer URL field with the new value. Again, any change will require a system restart.

Note: You will have to replace your agents so they know which address they should report to.


Get a glimpse of license allocation, see if any licenses are nearing expiration, and update your license when needed. For more information, read how to Manage Licenses in Organization Settings.


Manage the compliance policy for your organization(s) by creating restrictions or version requirements for libraries. Contrast will then flag libraries that violate the compliance settings, and alert you to violation.


Manage password policies, two-step verification, and API and application key management. You must restart the Contrast application after any change to these settings.


Contrast supports a the following authentications providers. Any change to this setting requires a system restart.


Change this setting with caution. It's very unlikely that a SuperAdmin will need change these values. In the event of a system restore operation, changes to the values of this configuration - such as the URL, which contains host information, or username and password - may be required. Any change to this value also requires a system restart.


Contrast can send email notifications to users when significant events occur, like a password reset. Configure settings for a SMTP server using the following fields.

  • Enable Mail: Use the toggle to enable or disable the feature.
  • Mail Protocol: Values can be "SMTP" or "SMTPs".
  • Mail Host: The fully qualified address of the SMTP server.
  • Mail Port: The likely value is "25".
  • Use SMTP Auth: Check the box to enable this setting.
  • Mail User: A user account for authentication purposes on the SMTP system.
  • Mail Password: The password for the mail user associated with the SMTP system.
  • Mail From: Use this setting to reset passwords and alerts.
  • Enable STARTTLSL: Check the box to enable this setting.

Log Level

The SuperAdmin can change the default log level for the various log files. Any change to this setting will take effect after a system restart.

Score Settings

You can customize the score settings for both overall application score and libraries. This setting allows EOP administrators to configure how scores get calculated and permit an individual organization to override the setting.

System Messages

If you want to alert all users in your organizations to important changes, you can send a system message, which they'll receive every time they log in to Contrast until the message expires or is deleted.