DocumentaciónHelp

Analyze an external report

Upload a report in PDF, DOCX or TXT, accept the AI analysis terms and wait for SofIA Governance to extract its findings.

On this page

The analysis takes two steps: first you choose the document and then you accept the AI analysis terms. SofIA Governance then processes the report in the background; it usually takes less than a minute.

Before you start

  • You need the Administrator or Editor role. With Read only, the Analyze report button is disabled.

  • The report must be in PDF, DOCX (Word) or TXT, and have selectable text. A PDF scanned as an image, without text recognition, can't be read.

  • For your company's name and domains to be anonymized properly, check that Company → Company details has Company name, Legal name, Email and Website filled in. See What is anonymized before the analysis.

Steps

  1. Go to Operations → External reports.

  2. Press Analyze report. If it is your first one, you can also use Analyze my first report.

  3. In Analyze external report, Step 1 of 2 · Document:

    • In Document, choose the file. You'll see its name and size with a check mark.

    • In Name, SofIA Governance suggests the file name; change it to a clear one, for example "Ethical hacking September 2026".

    • In Report type, choose Ethical hacking, Pentest, Audit, SOC report, Vulnerability scan or Other. It starts at Ethical hacking.

    • At the bottom you'll see a reminder of which data is replaced with placeholders before the analysis.

  4. Press Continue. The button is enabled when you choose a valid file.

  5. In Step 2 of 2 · AI analysis terms, read the terms. They explain what is done with the document: the text is extracted and anonymized, only the anonymized text goes to the indicated AI service, and the result and the original stay in your company's private space. Below you'll see the version of the terms.

  6. Check I accept the AI analysis terms (version …).

  7. Press Analyze. If you want to change the document, press Back.

The terms are shown and accepted for each analysis. SofIA Governance stores who accepted them, the version, the date and from where, and shows it in the analysis details.

What happens next

  • You'll see Analyzing the report. We'll let you know here when it's done. and the report appears first in the list with the Processing status.

  • Above the list, 1 report is being analyzed. appears. The list updates automatically every few seconds while there are reports in progress; you don't need to reload the page.

  • When it finishes, the status changes to Completed and you'll see the number of findings by severity and the standards detected. See Review the analysis results.

You can keep working on other screens in the meantime: the analysis continues even if you leave External reports.

If something goes wrong

Message

What to do

Unsupported format. Upload a PDF, DOCX or TXT.

Convert the report to one of those formats. If it is an old .doc, save it as .docx.

AI analysis is not configured

Your SofIA Governance installation doesn't have the AI service enabled. Ask the platform administrator to enable it.

Error status with The document has no readable text (is it a scan without OCR?).

The PDF is an image. Ask whoever produced the report for a version with text, or run it through a text recognition (OCR) program.

Error status with The report has too many findings for one analysis: split it into parts.

A section of the report contains more findings than fit in one response. Split the report, for example by chapter or by system, and analyze each part separately.

Error status with The analysis response could not be interpreted.

It was a one-off analysis failure. Delete the failed analysis and upload the report again.

Error status with The report could not be analyzed. Try again.

Delete the failed analysis and upload it again.

You must accept the AI analysis terms before continuing.

Check the acceptance box in step 2. If the terms changed version while you had the window open, close it and start again.

A long report is analyzed in parts of about 180,000 characters of text each, and the findings from all of them are combined into a single analysis; the Summary includes one paragraph per part (Part 1:, Part 2:…). The limit is about 900,000 characters: if the report is longer, the rest isn't analyzed and the Summary starts with Warning: the report is too long and only its first … characters were analyzed. In that case, split the document and upload the remaining part as another analysis.

Related

Search SofIA Governance

Type at least 2 characters to search SofIA Governance.

↑↓ to navigate · Enter to open · Esc to close