com.contrastsecurity.sdk

Class ContrastSDK

java.lang.Object

com.contrastsecurity.sdk.ContrastSDK

public class ContrastSDK
extends Object

Entry point for using the Contrast REST API. Make an instance of this class and call methods. Easy!

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ContrastSDK.Builder

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_CONNECTION_TIMEOUT Default connection timeout.
static int	DEFAULT_READ_TIMEOUT Default read timeout.

Constructor Summary

Constructors

Constructor and Description
ContrastSDK() Deprecated.
ContrastSDK(String user, String serviceKey, String apiKey) Deprecated.
ContrastSDK(String user, String serviceKey, String apiKey, String restApiURL) Deprecated.
ContrastSDK(String user, String serviceKey, String apiKey, String restApiURL, Proxy proxy) Deprecated.

Method Summary

Modifier and Type	Method and Description
GenericResponse	clearNotifications(String organizationId) Clear notifications for the org.
Application	createApplication(String organizationId, ApplicationCreateRequest request) Creates an application without a server that is meant to be instrumented later.
void	downloadAttestationReport(String organizationId, String userId, String reportId) Get the vulnerabilities in the organization whose ID is passed in.
void	downloadFile(HttpMethod method, String path, String saveDir)
GenericResponse	generateAttestationReport(String organizationId, String appId, AttestationCreateRequest request) Generate an attestation report for the application whose ID is passed in.
byte[]	getAgent(AgentType type, String organizationId) Download a contrast.jar agent associated with this account.
byte[]	getAgent(AgentType type, String organizationId, String profileName) Download a contrast.jar agent associated with this account.
Applications	getApplication(String organizationId, String appId) Get summary information about a single app without expandValues.
Applications	getApplication(String organizationId, String appId, EnumSet<FilterForm.ApplicationExpandValues> expandValues) Get summary information about a single app.
Application	getApplicationByNameAndLanguage(String orgId, String appName, AgentType language) Gets a single application based on the org, name, and language
Applications	getApplications(String organizationId) Get the list of applications being monitored by Contrast.
Applications	getApplicationsNames(String organizationId)
AssessLicenseOverview	getAssessLicensing(String organizationId) Get all Assess Licensing for an Organizations.
Coverage	getCoverage(String organizationId, String appId) Return coverage data about the monitored Contrast application.
List<JobOutcomePolicy>	getEnabledJobOutcomePolicies(String organizationId) Gets a list of enabled Job Outcome policies in an organization
List<JobOutcomePolicy>	getEnabledJoboutcomePoliciesByApplication(String organizationId, String appId) Gets a list of enabeld Job Outcome Policies in an organization that applies to an application
Applications	getFilteredApplications(String organizationId, ApplicationFilterForm applicationFilterForm) Get the list of filtered applications being monitored by Contrast.
Libraries	getLibraries(String organizationId, String appId)
Libraries	getLibraries(String organizationId, String appId, EnumSet<FilterForm.LibrariesExpandValues> expandValues) Return the libraries of the monitored Contrast application.
LibraryScores	getLibraryScores(String organizationId) Return the library Scores for an Organization.
LibraryStats	getLibraryStats(String organizationId) Return the library Stats for an Organization.
Applications	getLicensedApplications(String organizationId) Get the list of licensed applications being monitored by Contrast.
TraceNotesResponse	getNotes(String organizationId, String appId, String traceId, TraceFilterForm form) Get the notes (discussion) for the vulnerability ID in the application whose ID is passed in.
NotificationsResponse	getNotifications(String organizationId, TraceFilterForm form) Get notifications for the org.
Users	getOrganizationUsers(String organizationId) Get all users for an organization.
Organizations	getProfileDefaultOrganizations() Get the default organization for the user profile.
Organizations	getProfileOrganizations() Get all organizations for the user profile.
RouteCoverageResponse	getRouteCoverage(String organizationId, String appId) Return route coverage data about the monitored Contrast application.
Rules	getRules(String organizationId) Get the rules for an organization
Servers	getServers(String organizationId, ServerFilterForm filterForm) Return the servers of the monitored Contrast application.
Servers	getServersWithFilter(String organizationId, ServerFilterForm filterForm) Return the servers of the monitored Contrast application.
ServerTagsResponse	getServerTags(String organizationId, String appId) Get server tags for the org.
MetadataFilterResponse	getSessionMetadataForApplication(String organizationId, String appId, TraceFilterForm form) Get the available session metadata values in the application whose ID is passed in.
Traces	getTraceFilterByRule(String organizationId, String appId, List<String> ruleNames) Deprecated.
TraceListing	getTraceFilters(String organizationId, String appId) Get the filters for the traces in the application.
Traces	getTraces(String organizationId, String appId, TraceFilterForm form) Get the vulnerabilities in the application whose ID is passed in.
Traces	getTracesInOrg(String organizationId, TraceFilterForm form) Get the vulnerabilities in the organization whose ID is passed in.
Traces	getTracesWithFilter(String organizationId, String appId, TraceFilterType traceFilterType, TraceFilterKeycode keycode, TraceFilterForm form) Get the vulnerabilities in the application whose ID is passed in with a filter.
TracesWithResponse	getTracesWithResponse(String organizationId, String appId, TraceFilterForm form) Get the vulnerabilities in the application whose ID is passed in.
TagsResponse	getVulnTagsByApplication(String organizationId, String appId) Get the available vulnerability tags in the application whose ID is passed in.
VulnerabilityTrend	getYearlyNewVulnTrend(String organizationId) Get New (New Open and New Closed each month) Vulnerability Trend for an Organizations.
VulnerabilityTrend	getYearlyVulnTrend(String organizationId) Get Total (Total Open and Total Closed each month) Vulnerability Trend for an Organizations.
VulnerabilityTrend	getYearlyVulnTrendForApplication(String organizationId, String appId) Get all Vulnerability Trend for an Application.
HttpURLConnection	makeConnection(String url, String method)
InputStream	makeRequest(HttpMethod method, String path)
InputStream	makeRequestWithBody(HttpMethod method, String path, String body, MediaType mediaType)
MakeRequestResponse	makeRequestWithResponse(HttpMethod method, String path)
SecurityCheck	makeSecurityCheck(String organizationId, SecurityCheckForm securityCheckForm) Make a security check in a given organization by the security check form
void	setConnectionTimeout(int timeout) Sets a custom connection timeout for all SDK requests.
void	setReadTimeout(int timeout) Set a custom read timeout for all SDK requests.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_CONNECTION_TIMEOUT

public static final int DEFAULT_CONNECTION_TIMEOUT

Default connection timeout. If connection timeout its set to this value, custom timeout will be ignored and requests will take the default value that its usually assigned to them.

See Also:

Constant Field Values

DEFAULT_READ_TIMEOUT

public static final int DEFAULT_READ_TIMEOUT

Default read timeout. If read timeout its set to this value, custom timeout will be ignored and requests will take default value that its usually assigned to them.

See Also:

Constant Field Values

Constructor Detail

ContrastSDK

@Deprecated
public ContrastSDK()

Deprecated.

Use ContrastSDK.Builder

ContrastSDK

@Deprecated
public ContrastSDK(String user,
                               String serviceKey,
                               String apiKey,
                               String restApiURL)
                        throws IllegalArgumentException

Deprecated.

Create a ContrastSDK object to use the Contrast V3 API Deprecated - Please use builder

Parameters:

user - Username (e.g., joe@acme.com)

serviceKey - User service key

apiKey - API Key

restApiURL - the base Contrast API URL

Throws:

IllegalArgumentException - if the API URL is malformed

ContrastSDK

@Deprecated
public ContrastSDK(String user,
                               String serviceKey,
                               String apiKey,
                               String restApiURL,
                               Proxy proxy)
                        throws IllegalArgumentException

Deprecated.

Create a ContrastSDK object to use the Contrast V3 API through a Proxy. Deprecated - Please use builder

Parameters:

user - Username (e.g., joe@acme.com)

serviceKey - User service key

apiKey - API Key

restApiURL - the base Contrast API URL

proxy - Proxy to use

Throws:

IllegalArgumentException - if the API URL is malformed

ContrastSDK

@Deprecated
public ContrastSDK(String user,
                               String serviceKey,
                               String apiKey)

Deprecated.

Create a ContrastSDK object to use the Contrast V3 API Deprecated - Please use Builder

This will use the default api url which is https://app.contrastsecurity.com/Contrast/api

Parameters:

user - Username (e.g., joe@acme.com)

serviceKey - User service key

apiKey - API Key

Method Detail

getAssessLicensing

public AssessLicenseOverview getAssessLicensing(String organizationId)
                                         throws IOException,
                                                UnauthorizedException

Get all Assess Licensing for an Organizations.

Parameters:

organizationId - the ID of the organization

Returns:

AssessLicenseOverview with Assess Licensing for an Oeg.

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getYearlyVulnTrend

public VulnerabilityTrend getYearlyVulnTrend(String organizationId)
                                      throws IOException,
                                             UnauthorizedException

Get Total (Total Open and Total Closed each month) Vulnerability Trend for an Organizations.

Parameters:

organizationId - the ID of the organization

Returns:

VulnerabilityTrend with the yearly Vulnerability Trend for an Oeg.

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getYearlyNewVulnTrend

public VulnerabilityTrend getYearlyNewVulnTrend(String organizationId)
                                         throws IOException,
                                                UnauthorizedException

Get New (New Open and New Closed each month) Vulnerability Trend for an Organizations.

Parameters:

organizationId - the ID of the organization

Returns:

VulnerabilityTrend with the yearly Vulnerability Trend for an Oeg.

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getYearlyVulnTrendForApplication

public VulnerabilityTrend getYearlyVulnTrendForApplication(String organizationId,
                                                           String appId)
                                                    throws IOException,
                                                           UnauthorizedException

Get all Vulnerability Trend for an Application.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

Returns:

VulnerabilityTrend with the yearly Vulnerability Trend for an Oeg.

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getProfileOrganizations

public Organizations getProfileOrganizations()
                                      throws IOException,
                                             UnauthorizedException

Get all organizations for the user profile.

Returns:

Organization objects with a list of disabled and valid organizations for the user.

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getOrganizationUsers

public Users getOrganizationUsers(String organizationId)
                           throws IOException,
                                  UnauthorizedException

Get all users for an organization.

Parameters:

organizationId - the ID of the organization

Returns:

A List of User Objects.

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getProfileDefaultOrganizations

public Organizations getProfileDefaultOrganizations()
                                             throws IOException,
                                                    UnauthorizedException

Get the default organization for the user profile.

Returns:

Organization object with the default Organizaiton.

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

createApplication

public Application createApplication(String organizationId,
                                     ApplicationCreateRequest request)
                              throws IOException,
                                     UnauthorizedException,
                                     ApplicationCreateException

Creates an application without a server that is meant to be instrumented later.

Parameters:

organizationId -

request -

Returns:

Throws:

IOException

UnauthorizedException

ApplicationCreateException

getApplicationByNameAndLanguage

public Application getApplicationByNameAndLanguage(String orgId,
                                                   String appName,
                                                   AgentType language)
                                            throws IOException,
                                                   UnauthorizedException

Gets a single application based on the org, name, and language

Parameters:

orgId - ID of the organization

appName - Application name when the application was first created

language - Language of the application

Returns:

the Application found, returns null if the application is not found

Throws:

IOException

UnauthorizedException

getApplication

public Applications getApplication(String organizationId,
                                   String appId)
                            throws IOException,
                                   UnauthorizedException

Get summary information about a single app without expandValues.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

Returns:

Applications object that contains one Application; wrapper

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getApplication

public Applications getApplication(String organizationId,
                                   String appId,
                                   EnumSet<FilterForm.ApplicationExpandValues> expandValues)
                            throws IOException,
                                   UnauthorizedException

Get summary information about a single app.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

expandValues - Expand values to filter on

Returns:

Applications object that contains one Application; wrapper

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getApplications

public Applications getApplications(String organizationId)
                             throws UnauthorizedException,
                                    IOException

Get the list of applications being monitored by Contrast.

Parameters:

organizationId - the ID of the organization

Returns:

Applications object that contains the list of Application's

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getFilteredApplications

public Applications getFilteredApplications(String organizationId,
                                            ApplicationFilterForm applicationFilterForm)
                                     throws UnauthorizedException,
                                            IOException

Get the list of filtered applications being monitored by Contrast.

Parameters:

organizationId - the ID of the organization

applicationFilterForm - Query params to add more info to response

Returns:

Applications object that contains the list of Application's

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getLicensedApplications

public Applications getLicensedApplications(String organizationId)
                                     throws UnauthorizedException,
                                            IOException

Get the list of licensed applications being monitored by Contrast.

Parameters:

organizationId - the ID of the organization

Returns:

Applications object that contains the list of Application's

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getApplicationsNames

public Applications getApplicationsNames(String organizationId)
                                  throws UnauthorizedException,
                                         IOException

Throws:

UnauthorizedException

IOException

getRouteCoverage

public RouteCoverageResponse getRouteCoverage(String organizationId,
                                              String appId)
                                       throws IOException,
                                              UnauthorizedException

Return route coverage data about the monitored Contrast application.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

Returns:

RouteCoverage object for the given app

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getCoverage

public Coverage getCoverage(String organizationId,
                            String appId)
                     throws IOException,
                            UnauthorizedException

Return coverage data about the monitored Contrast application.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

Returns:

Coverage object for the given app

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getLibraries

public Libraries getLibraries(String organizationId,
                              String appId)
                       throws IOException,
                              UnauthorizedException

Throws:

IOException

UnauthorizedException

getLibraries

public Libraries getLibraries(String organizationId,
                              String appId,
                              EnumSet<FilterForm.LibrariesExpandValues> expandValues)
                       throws IOException,
                              UnauthorizedException

Return the libraries of the monitored Contrast application.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

expandValues - Query params to add more info to response

Returns:

Libraries object that contains the list of Library objects

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getLibraryScores

public LibraryScores getLibraryScores(String organizationId)
                               throws IOException,
                                      UnauthorizedException

Return the library Scores for an Organization.

Parameters:

organizationId - the ID of the organization

Returns:

LibraryScores object that contains the Library scores for an Org

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getLibraryStats

public LibraryStats getLibraryStats(String organizationId)
                             throws IOException,
                                    UnauthorizedException

Return the library Stats for an Organization.

Parameters:

organizationId - the ID of the organization

Returns:

LibraryScores object that contains the Library stats for an Org

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getServers

public Servers getServers(String organizationId,
                          ServerFilterForm filterForm)
                   throws IOException,
                          UnauthorizedException

Return the servers of the monitored Contrast application.

Parameters:

organizationId - the ID of the organization

filterForm - FilterForm query parameters

Returns:

Servers object that contains the list of Library objects

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getServersWithFilter

public Servers getServersWithFilter(String organizationId,
                                    ServerFilterForm filterForm)
                             throws IOException,
                                    UnauthorizedException

Return the servers of the monitored Contrast application.

Parameters:

organizationId - the ID of the organization

filterForm - FilterForm query parameters

Returns:

Servers object that contains the list of Library objects

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getTraces

public Traces getTraces(String organizationId,
                        String appId,
                        TraceFilterForm form)
                 throws IOException,
                        UnauthorizedException

Get the vulnerabilities in the application whose ID is passed in.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

form - FilterForm query parameters

Returns:

Traces object that contains the list of Trace's

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getTracesWithResponse

public TracesWithResponse getTracesWithResponse(String organizationId,
                                                String appId,
                                                TraceFilterForm form)
                                         throws IOException,
                                                UnauthorizedException

Get the vulnerabilities in the application whose ID is passed in.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

form - FilterForm query parameters

Returns:

TracesWithResponse object that contains the list of Trace's and the response code

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getNotes

public TraceNotesResponse getNotes(String organizationId,
                                   String appId,
                                   String traceId,
                                   TraceFilterForm form)
                            throws IOException,
                                   UnauthorizedException

Get the notes (discussion) for the vulnerability ID in the application whose ID is passed in.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

traceId - the ID of the vulnerability

form - FilterForm query parameters

Returns:

Traces object that contains the list of Trace's

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getVulnTagsByApplication

public TagsResponse getVulnTagsByApplication(String organizationId,
                                             String appId)
                                      throws IOException,
                                             UnauthorizedException

Get the available vulnerability tags in the application whose ID is passed in.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

Returns:

TagsResponse object that contains the list of Tags

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getSessionMetadataForApplication

public MetadataFilterResponse getSessionMetadataForApplication(String organizationId,
                                                               String appId,
                                                               TraceFilterForm form)
                                                        throws IOException,
                                                               UnauthorizedException

Get the available session metadata values in the application whose ID is passed in.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

form - FilterForm query parameters

Returns:

Traces object that contains the list of Trace's

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

generateAttestationReport

public GenericResponse generateAttestationReport(String organizationId,
                                                 String appId,
                                                 AttestationCreateRequest request)
                                          throws IOException,
                                                 UnauthorizedException,
                                                 ApplicationCreateException

Generate an attestation report for the application whose ID is passed in.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

request -

Throws:

IOException

UnauthorizedException

ApplicationCreateException

downloadAttestationReport

public void downloadAttestationReport(String organizationId,
                                      String userId,
                                      String reportId)
                               throws IOException,
                                      UnauthorizedException

Get the vulnerabilities in the organization whose ID is passed in.

Parameters:

organizationId - the ID of the organization

userId - the id of the user who requested the report

reportId - the id of the report that was generated

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getNotifications

public NotificationsResponse getNotifications(String organizationId,
                                              TraceFilterForm form)
                                       throws IOException,
                                              UnauthorizedException

Get notifications for the org.

Parameters:

organizationId - the ID of the organization

form - FilterForm query parameters

Returns:

Notifications object that contains the response from the API

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getServerTags

public ServerTagsResponse getServerTags(String organizationId,
                                        String appId)
                                 throws IOException,
                                        UnauthorizedException

Get server tags for the org.

Parameters:

organizationId - the ID of the organization

appId - the ID of the app

Returns:

ServerTagsResponse object that contains the server tags

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

clearNotifications

public GenericResponse clearNotifications(String organizationId)
                                   throws IOException,
                                          UnauthorizedException

Clear notifications for the org.

Parameters:

organizationId - the ID of the organization

Returns:

GenericResponse object that contains the response from the server

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getTracesInOrg

public Traces getTracesInOrg(String organizationId,
                             TraceFilterForm form)
                      throws IOException,
                             UnauthorizedException

Get the vulnerabilities in the organization whose ID is passed in.

Parameters:

organizationId - the ID of the organization

form - FilterForm query parameters

Returns:

Traces object that contains the list of Trace's

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getTraceFilters

public TraceListing getTraceFilters(String organizationId,
                                    String appId)
                             throws IOException,
                                    UnauthorizedException

Get the filters for the traces in the application.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

Returns:

TraceListing object that contains the trace filters for the application

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getTracesWithFilter

public Traces getTracesWithFilter(String organizationId,
                                  String appId,
                                  TraceFilterType traceFilterType,
                                  TraceFilterKeycode keycode,
                                  TraceFilterForm form)
                           throws IOException,
                                  UnauthorizedException

Get the vulnerabilities in the application whose ID is passed in with a filter.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

traceFilterType - filter type

keycode - id or key to filter on

form - FilterForm query parameters

Returns:

Traces object that contains the list of Trace's

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getTraceFilterByRule

@Deprecated
public Traces getTraceFilterByRule(String organizationId,
                                               String appId,
                                               List<String> ruleNames)
                                        throws IOException,
                                               UnauthorizedException

Deprecated.

Get the vulnerabilities in the application by the rule.

Parameters:

organizationId - the ID of the organization

appId - the ID of the application

ruleNames - FilterForm query parameters

Returns:

Traces object that contains the list of Trace's

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

makeSecurityCheck

public SecurityCheck makeSecurityCheck(String organizationId,
                                       SecurityCheckForm securityCheckForm)
                                throws IOException,
                                       UnauthorizedException

Make a security check in a given organization by the security check form

Parameters:

organizationId - the ID of the organization

securityCheckForm - the security check form

Returns:

the security check that was made

Throws:

IOException

UnauthorizedException

getEnabledJobOutcomePolicies

public List<JobOutcomePolicy> getEnabledJobOutcomePolicies(String organizationId)
                                                    throws IOException,
                                                           UnauthorizedException

Gets a list of enabled Job Outcome policies in an organization

Parameters:

organizationId - The organization ID

Returns:

The list of enabled Job Outcome Policies

Throws:

IOException

UnauthorizedException

getEnabledJoboutcomePoliciesByApplication

public List<JobOutcomePolicy> getEnabledJoboutcomePoliciesByApplication(String organizationId,
                                                                        String appId)
                                                                 throws IOException,
                                                                        UnauthorizedException

Gets a list of enabeld Job Outcome Policies in an organization that applies to an application

Parameters:

organizationId - The organization ID

appId - The Application ID

Returns:

the list of enabled Job Outcome Policies that apply to the application

Throws:

IOException

UnauthorizedException

getRules

public Rules getRules(String organizationId)
               throws IOException,
                      UnauthorizedException

Get the rules for an organization

Parameters:

organizationId - the ID of the organization

Returns:

Traces object that contains the list of Trace's

Throws:

UnauthorizedException - if the Contrast account failed to authorize

IOException - if there was a communication problem

getAgent

public byte[] getAgent(AgentType type,
                       String organizationId,
                       String profileName)
                throws IOException,
                       UnauthorizedException

Download a contrast.jar agent associated with this account. The user should save this byte array to a file named 'contrast.jar'. This signature takes a parameter which contains the name of the saved engine profile to download.

Parameters:

type - the type of agent you want to download; Java, Java 1.5, .NET, or Node

profileName - the name of the saved engine profile to download,

organizationId - the ID of the organization,

Returns:

a byte[] array of the contrast.jar file contents, which the user should convert to a new File

Throws:

IOException - if there was a communication problem

UnauthorizedException - if authentication fails

getAgent

public byte[] getAgent(AgentType type,
                       String organizationId)
                throws IOException,
                       UnauthorizedException

Download a contrast.jar agent associated with this account. The user should save this byte array to a file named 'contrast.jar'. This signature takes a parameter which contains the name of the saved engine profile to download.

This uses 'default' as the profile name.

Parameters:

type - the type of agent you want to download; Java, Java 1.5, .NET, or Node

organizationId - the ID of the organization,

Returns:

a byte[] array of the contrast.jar file contents, which the user should convert to a new File

Throws:

IOException - if there was a communication problem

UnauthorizedException - if authentication fails

makeRequestWithBody

public InputStream makeRequestWithBody(HttpMethod method,
                                       String path,
                                       String body,
                                       MediaType mediaType)
                                throws IOException,
                                       UnauthorizedException

Throws:

IOException

UnauthorizedException

makeRequest

public InputStream makeRequest(HttpMethod method,
                               String path)
                        throws IOException,
                               UnauthorizedException

Throws:

IOException

UnauthorizedException

makeRequestWithResponse

public MakeRequestResponse makeRequestWithResponse(HttpMethod method,
                                                   String path)
                                            throws IOException,
                                                   UnauthorizedException

Throws:

IOException

UnauthorizedException

downloadFile

public void downloadFile(HttpMethod method,
                         String path,
                         String saveDir)
                  throws IOException,
                         UnauthorizedException

Throws:

IOException

UnauthorizedException

makeConnection

public HttpURLConnection makeConnection(String url,
                                        String method)
                                 throws IOException

Throws:

IOException

setConnectionTimeout

public void setConnectionTimeout(int timeout)

Sets a custom connection timeout for all SDK requests. This value must be set before a call to makeConnection is done.

Parameters:

timeout - Timeout value in milliseconds.

setReadTimeout

public void setReadTimeout(int timeout)

Set a custom read timeout for all SDK requests. This value must be set before calling makeConnection method in order to take effect.

Parameters:

timeout - TImeout value in milliseconds