Introduction
Connecting to DTP allows you to:
- obtain the network license,
- extend team-working capabilities, such as sharing test configurations, static analysis rules, and project settings,
- import findings from DTP, and
- report local analysis results to a centralized database1.
1 Reporting local analysis results to DTP requires configuring the DTP reporting settings in the .properties file; see Sending Results and Publishing Source Code to DTP.
See About the Parasoft Development Testing Workflow for additional information.
Configuring Connection to DTP Server
To connect to a DTP Server:
In your IDE, click Parasoft in the menu bar and choose Options.
- Select DTP.
Check Enable and enter the DTP Server Base URL and authentication information.
The default port numbers for DTP are:
8443
for https://8080
(on Linux) and80
(on Windows) for http://
If DTP is deployed to a location other than the root of the host server, the URL should include a context path (a relative path from the host name). This may be the case if your organization uses a reverse proxy. For example: https://mydtp.mycompany.com:8443/contextPath. Refer to the DTP documentation for additional information about reverse proxy server configuration and context path configuration.
You can click Test Connection to verify the settings.
If you use OpenID Connect for authentication on DTP, provide the Base URL of your DTP server, then configure the connection with the OpenID Connect server; see Configuring OpenID Connect. When you successfully connect to your OpenID Connect server, the DTP page will automatically display the information.- In the Project area, click Configure, then select a project stored in DTP; this allows you to retrieve settings associated with this project, as well as import findings assigned to this project (as described in Importing Static Analysis Findings).
- Click Apply to save the settings.
DTP Server will automatically configure your license (see step 2).
Shared Resources
The functionality described in this section has been deprecated.
The Shared Resources field indicates whether or not the tool has access to resources stored in the deprecated Team Server module of DTP. Test configurations, configuration files, and other files can be stored in Team Server and shared with team. DTP includes an instance of Team Server that stores resources for 10.x+ version of tools and an instance for legacy version of tools (9.x and older). This is to accommodate organizations with teams that may have a mix of versions.
No additional configuration is necessary is most cases, but the field may show a red indicator if the Team Server instance for legacy tools does not contain resources. Contact your Parasoft administrator if your organization has teams using legacy versions of Parasoft tools so that he or she can configure DTP to forward resources to the legacy instance of Team Server.
Configuring OpenID Connect in the UI
DTP ships with support for OpenID Connect user authentication (see the DTP User Guide for details). If OpenID Connect is enabled for your DTP server, you must configure dotTEST to authenticate users via OpenID Connect.
In your IDE, click Parasoft in the menu bar and choose Options.
- Choose OpenID Connect.
- Check Enable.
- Configure the following options:
Issuer URI: The URL of your OpenID Connect server.
Client ID: The ID registered on your OpenID Connect server.
Callback host: The local callback host required to communicate with the OpenID Connect server. The following options are available:
- localhost: The localhost address will be used for communication.
- 127.0.0.1: The loopback IP address 127.0.0.1 will be used for communication.
Callback port: The callback port number for communication with the OpenID Connect server. The following options are available:
- Automatically select an open port: Automatically selects an open port (recommended).
- Use port: Allows you to manually specify the port number.
Callback timeout: Specifies, in seconds, the maximum time the browser will wait for user credentials (see step 6). - Click Test Authentication or Apply to open the OpenID Connect authentication page in your browser.
- Provide your credentials in the browser window that opens. The authentication page may resemble the following:
- Close the browser window when the authentication confirmation is displayed and continue in your IDE.
- Click Apply to apply the changes.
The Status panel displays the current OpenID Connect authentication status.
About the Parasoft Development Testing Workflow
In addition to providing licensing and shared assets for testing and analyzing your software under development, Parasoft DTP collects and merges data points from Parasoft tools, third-party analysis tools, and external systems, such as bug tracking and requirements tracking systems. It aggregates and prioritizes data, as well as performs additional analysis to help you optimize development processes. Using your code analysis and test execution tool with DTP enables you to consistently apply quality practices across teams and throughout the SDLC. The following illustration shows the general workflow. Parasoft tools ship with plugins for integration with your build tools (i.e., Maven, Ant, Gradle, MS Build, make, etc.). These integrations allow you to analyze code and send data to DTP automatically as part of the automated build processes and continuous integration (CI). When the analysis tool is running, it captures massive amounts of detailed data associated with the code referred to as “observations.” Observations are code quality data, such as static analysis violations, unit test failures, metrics, etc., as well as logistical information about the code, such as authorship, scope, and source control location. When observations are sent to DTP, they are converted into “findings” and stored in the database. Findings are observations that have been analyzed, normalized, and aggregated into actionable data. You can import priorities and filtered findings from DTP directly into your IDE so that issues can be addressed. When you check code back into source control, the continuous integration process picks up the change, and the workflow is repeated. This ensures that defects are detected and prevented from becoming software bugs later in the development process when the costs of remediation are much higher. Integrating Parasoft Tools with the Build
Capturing Observations
Converting Data into Findings
Importing DTP Findings to the Desktop
Continuing the Cycle