Page tree
Skip to end of metadata
Go to start of metadata

 

Description

This function returns an IP address's fraud risk score. This function uses the number of charge backs, the number of fraudulent sign-ups, and other information to generate this score.

Examples 


 Browser-based Calls
XML
https://manage2.cpanel.net/XMLsecverify.cgi?ip=127.0.0.1
JSON
https://manage2.cpanel.net/XMLsecverify.cgi?output=json&ip=127.0.0.1
YAML
https://manage2.cpanel.net/XMLsecverify.cgi?output=yaml&ip=127.0.0.1
 cPanel Licensing PHP Class
<?php 
include("cpl.inc.php");
$cpl = new cPanelLicensing("barney@example.com,"12345luggage"); 
$lisc = $cpl->fetchLicenseRiskData(array(
	"ip" => 127.0.0.1
	)
); 
?>
 cPanel Licensing Perl Module
use cPanelLicensing;
    my $licenseManager = new cPanelLicensing(
		user => 'barney\@example.com', 
		pass => '12345luggage',
);
    $licensemanager->fetchLicenseRiskData(
		'ip' => '127.0.0.1'
	);
 Output (JSON)
 {  
   "version":1,
   "status":1,
   "reason":"Risk Data Fetched",
   "clientreportingurl":"http://verify.cpanel.net/security/?code=ELeLcLNcPA",
   "riskscore.main.score":0,
   "riskscore.directorder.score":0,
   "riskscore.aggregate.score":0
}
 Output (XML)
<XMLsecverify clientreportingurl="http://verify.cpanel.net/security/?code=ELeLcLNcPA" reason="Risk Data Fetched" riskscore.aggregate.score="0" riskscore.directorder.score="0" riskscore.main.score="0" status="1" version="1"/>
 Output (YAML)
--- 
clientreportingurl: http://verify.cpanel.net/security/?code=ELeLcLNcPA
reason: Risk Data Fetched
riskscore.aggregate.score: 0
riskscore.directorder.score: 0
riskscore.main.score: 0
status: 1
version: 1

Parameters

ParameterTypeDescriptionPossible valuesExample
ipstring

Required

The license's IP address.

A valid IP address on the server.

The List License Information function returns a list of possible values.

127.0.0.1

 

Returns

ReturnTypeDescriptionPossible valuesExample
reasonstringInformation about the license check.A string value.Risk Data Fetched
statusBooleanWhether the function succeeded.
  • 1 — Success.

  • 0 — Failure.
1
clientreportingurlstringThe URL to send clients who wish to request removal from the database.A valid URL.
 Click to view...
http://verify.cpanel.net/security/?code=ELeLcLNcPA
versionfloatInternal information that the Manage2 API uses to identify the version.A numeric value.0.5
riskscore.main.scoreintegerThe fraud risk score, based on the license's history.
  • High integer — High fraud risk.
  • Low integer — Low fraud risk.
  • Negative integer — Positive order history.
0
riskscore.aggregate.scoreintegerThe fraud risk score, based on the license's history and cPanel Store's order databases.
  • High integer — High fraud risk.
  • Low integer — Low fraud risk.
  • Negative integer — Positive order history.
0
riskscore.directorder.scoreintegerThe fraud risk score, based on the cPanel Store's order databases.
  • High integer — High fraud risk.
  • Low integer — Low fraud risk.
  • Negative integer — Positive order history.
0