As of December 31st, 2023 ThreadFix 2.X has reached End of Life and is no longer supported. For any further information please contact the Success and Implementation team.

Add Remote Provider Application Mapping - API

/rest/{version}/remoteprovider/remoteProviderApplication/{remoteProviderApplicationId}/addMapping


Descriptor

Value

HTTP Method

POST

Description

Maps a ThreadFix application to the Remote Provider application.

Required Permission

Manage Remote Providers

Version Introduced2.5.0
Changes in 2.7.5Added "policyStatuses" to the REST call response.
Changes in 2.7.5Added "testEnvironment", "releaseFrequency", and "isInternal" to the REST call response.


Request Header Parameters

Parameter

Value

Required

Description

Accept

String

Yes

A value of ‘application/json’ must be provided.


Request Parameters

Parameter

Value

Required

Description

applicationId

Integer

Yes

ID for the ThreadFix application to map to the Remote Provider application.

reportUrl

URL

No

The version URL to use for Black Duck remote provider applications.

Refer to the Get Remote Provider Application Versions API call to obtain the reportUrl value for the version that you need to map.


Sample Calls:


curl --insecure -H 'Accept: application/json' -H "Authorization: APIKEY {apikey}" -X POST --data "applicationId={appid}&reportUrl=https://{hostname}.blackducksoftware.com/api/projects/{projectid}/versions/{versionid}/vulnerable-bom-components" http://localhost:8080/threadfix/rest/latest/remoteprovider/remoteProviderApplication/{remoteproviderid}/addMapping


Sample Output:


{
    "message": "",
    "success": true,
    "responseCode": -1,
    "object": {
        "id": 4,
        "nativeId": "Test Project",
        "nativeName": "Test Project",
        "customName": null,
        "versionsUrl": "https://{hostname}.blackducksoftware.com/api/projects/{projectid}/versions",
        "remoteProviderEntity": {
            "id": 2,
            "name": "BD",
            "remoteProviderType": {
                "name": "Black Duck",
                "id": 10
            }
        },
        "application": {
            "id": 1,
            "name": "Test App",
            "url": null,
            "applicationCriticality": {
                "id": 2,
                "name": "Medium"
            },
			"policyStatuses": [
                {
                    "id": 3
                }
            ],
            "description": null,
            "releaseFrequency": "UNKNOWN",
            "testEnvironment": null,
            "isInternal": false,
            "team": {
                "name": "delete team",
                "id": 9
            }
            "team": {
                "name": "Test Team",
                "id": 1
            }
        },
        "lastImportTime": null,
        "lastImportAttemptTime": null,
        "lastImportStatus": "NOT_ATTEMPTED"
    }
}

www.threadfix.it | www.coalfire.com
Copyright © 2024 Coalfire. All rights reserved.

This Information Security Policy is CoalFire - Public: Distribution of this material is not limited.