Remediation Reports in the v3/beta APIs

[matt_caito]

Is there a plan to replace the functionality to grab the content of Certification Campaign Remediation reports? I opened a ticket to support in 2022 and they provided me an undocumented way to grab that data through the cc API. Does anyone know if there is an equivalent to the below in the v3 or beta APIs since the cc is being decomissioned? The script I created to grab this data is a HUGE time saver.

1. Using your preferred API client, run the following:
   GET https://{org-name}.api.identitynow.com/cc/api/campaign/getReports?campaignId={id}
2. You will see a response similar to the one below. The taskResult ID is actually the ReportID. You need this for step 2.
   [ { "created": 1583526951293, "currentDate": 1614030204839, "name": "Campaign Status Report", "status": "Success", "taskResultId": "2c91808gd7..." }, { "created": 1583526951646, "currentDate": 1614030204841, "name": "Certification Signoff Report", "status": "Success", "taskResultId": "2c91808s4709..." }, { "created": 1583526952006, "currentDate": 1614030204844, "name": "Campaign Composition Report", "status": "Success", "taskResultId": "2c9180847d09..." }
3. Using the taskResultId from the response you received in step 1 as the ReportId, run the following:
   GET https://{org-name}.api.identitynow.com/cc/api/report/get/{ReportId}?format=pdf
   In the header give name as the report name.
   Example:
   key: name value: "Campaign Status Report"
   Alternatively, you can give in the URL like this:
   https://{org-name}.api.identitynow.com/cc/api/report/get/{ReportId}?format=pdf&name=Campaign%20Status%Report

[colin_mckibben]

Welcome to the Developer Community Matt.

To download a campaign report using the public APIs, please see this post.

GET /api/report/get/{reportId}

This endpoint has been replaced by Download a campaign report Use get-active-campaigns | SailPoint Developer Community to find a completed campaign. Use get-campaign-reports | SailPoint Developer Community to get the ID of one of the reports generated for the campaign. Use get-report-result | SailPoint Developer Community to check the status of the report. It must be complete before you can download it. Download the CSV report using get-report | SailPoint Developer Community using a request …

[matt_caito]

Thanks you so much for this information! I’ll get our script updated and test these new endpoints!

[KevinHarrington]

EDIT: Nevermind the below - I’ll open a new thread rather than resurrecting an old one.

This process does not seem to work for getting the .pdf versions of the reports. Is there a documented process to download those via API?

[matt_caito]

Yeah - I’m not sure. I’ve never tried PDF since the process we have internall is PowerShell script that parse the csv return and produces output that we use to track.