GetExternalRisks

Syntax

sub GetExternalRisks

Back to top

Description

This function is called for every change request, after FireFlow has finished running a risk check. It receives the change request as input, along with a list of devices on which a risk check should be run. The risk check is run on an external system, and the function then returns the risk check results. These results are displayed in FireFlow after the FireFlow risk check results, for example:

Back to top

Input Parameters

$ticket

A Perl hash reference containing a single key called flatTicket, which points to the flat ticket representation of the change request.

For details, see Flat Ticket Examples.
$firewall

A Perl array reference containing an array of device names on which a risk check should be run.

Note: These are the same devices on which the FireFlow risk check ran.

Back to top

Return Values

A Perl hash reference containing the following keys:

  • RiskList. An array of all the risks that were detected, sorted from high to low severity, where each risk is represented by a hash reference containing the risk's name, description, code, and severity.
  • profile. The risk check's profile.
  • high. The number of risks at the High severity level.
  • low. The number of risks at the Low severity level.
  • medium. The number of risks at the Medium severity level.
  • suspected high. The number of risks at the Suspected High severity level.

Note: If there are no risks at a certain severity level, the relevant key will have no value defined.

Back to top