Release note/20250331

From CDQ
Jump to navigation Jump to search
EDGL.png
Release date Date and time when a concept, e.g. a data quality rule, is released, i.e. when the status changes to <code>RELEASED</code>. 2025-03-31
Feature Affected feature(s)
Idea portal Ideas that have been introduced with the release no idea entry directly linked with this release note

Email Domain Guard Configurations and Fraud Case Checker

We are excited to announce the latest enhancements to Email Domain Guard, including the Fraud Case Checker and customizable configurations.

  • Fraud Case Checker: A new feature that identifies email addresses involved in reported and confirmed fraud cases via CDQ's Fraud Guard
  • Custom Configurations: Enhanced flexibility to set your own weighting factors and disable specific checkers for a tailored security approach.

Read more...



Why We Launched Fraud Case Checker

In today's digital landscape, email fraud is becoming increasingly sophisticated and prevalent. To combat this growing threat, we have introduced the Fraud Case Checker as part of our Email Domain Guard. This feature is designed to identify email addresses involved in reported and confirmed fraud cases via CDQ's Fraud Guard.

Customizable Configurations

In addition to the Fraud Case Checker, our Email Domain Guard now offers customizable configurations. You can set your own weighting factors and disable specific checkers according to your needs, ensuring a tailored approach to email security.

Key Features:

  1. Creating your own configuration - Set your own weights and thresholds for separate checkers.
  2. Updating existing configurations.
  3. Reading configuration by ID.
  4. Reading all configurations attached to your workspace.
  5. Deleting configurations.

Get Started with Email Domain Guard with you own Configuration

Step 1: Authentication

Use your CDQ API key to authenticate API requests.

Step 2: Creating New Configuration

Make a POST request to the API endpoint with the configuration template in the request body.

Endpoint: 

 https://api.cdq.com/email-analysis/rest/configurations/emailverification

Request Headers: 

{
  "Content-Type": "application/json",
  "X-API-KEY": << your API Key >>
}

Request Body: 

{
	"name": "My configuration",
	"configuration": {
		"disposableMailChecker": {
			"isEnabled": true,
			"isRiskCalculationEnabled": true,
			
			"disposableFactorWeight": 100
		},
		"dnsblChecker": {
			"isEnabled": true,
			"isRiskCalculationEnabled": true,
			
			"dnsblFactorWeight": 50
		},
		"freemailChecker": {
			"isEnabled": true,
			"isRiskCalculationEnabled": true,
			
			"freemailFactorWeight": 40
		},
		"roleCategoryChecker": {
			"isEnabled": true
		},
		"whoisChecker": {
			"isEnabled": true,
			"isRiskCalculationEnabled": true,
			
			"newBornDomainFactorWeight": 85,
			"youngDomainFactorWeight": 10,
			"oldDomainFactorWeight": 10,
			"notPublicFactorWeight": 65,
			"youngDomainAgeThreshold": 365,
			"oldDomainAgeThreshold": 1095
		},
		"sharedEmailChecker": {
			"isEnabled": true,
			"isRiskCalculationEnabled": true,
			
			"sharedEmailAddressFactorWeight": 50
		},
		"dataBreachChecker": {
			"isEnabled": true,
			"isRiskCalculationEnabled": true,
			
			"recentDataBreachFactorWeight": 20,
			"youngDataBreachFactorWeight": 10,
			"oldDataBreachFactorWeight": 5,
			"breachWithPasswordFactorWeight": 20,
			"breachWithMalwareFactorWeight": 20,
			"inflationaryBreachesFactorWeight": 10,
			"breachedDomainFactorWeight": 5,
			"youngDataBreachAgeThreshold": 365,
			"oldDataBreachAgeThreshold": 1095,
			"inflationaryBreachesCountThreshold": 25
		},
		"fraudCaseChecker": {
		 "isEnabled": true,
		 "isRiskCalculationEnabled": true
	 }
	}
}

Response Example: 

{
	"name": "My configuration",
	"configuration": {
		"disposableMailChecker": {
			"isEnabled": true,
			"isRiskCalculationEnabled": true,
			"disposableFactorWeight": 100
		},
		"dnsblChecker": {
			"isEnabled": true,
			"isRiskCalculationEnabled": true,
			"dnsblFactorWeight": 50
		},
		"freemailChecker": {
			"isEnabled": true,
			"isRiskCalculationEnabled": true,
			"freemailFactorWeight": 40
		},
		"roleCategoryChecker": {
			"isEnabled": true
		},
		"whoisChecker": {
			"isEnabled": true,
			"isRiskCalculationEnabled": true,
			"newBornDomainFactorWeight": 85,
			"youngDomainFactorWeight": 10,
			"oldDomainFactorWeight": 10,
			"notPublicFactorWeight": 65,
			"youngDomainAgeThreshold": 365,
			"oldDomainAgeThreshold": 1095
		},
		"sharedEmailChecker": {
			"isEnabled": true,
			"isRiskCalculationEnabled": true,
			"sharedEmailAddressFactorWeight": 50
		},
		"dataBreachChecker": {
			"isEnabled": true,
			"isRiskCalculationEnabled": true,
			"recentDataBreachFactorWeight": 20,
			"youngDataBreachFactorWeight": 10,
			"oldDataBreachFactorWeight": 5,
			"breachWithPasswordFactorWeight": 20,
			"breachWithMalwareFactorWeight": 20,
			"inflationaryBreachesFactorWeight": 10,
			"breachedDomainFactorWeight": 5,
			"youngDataBreachAgeThreshold": 365,
			"oldDataBreachAgeThreshold": 1095,
			"inflationaryBreachesCountThreshold": 25
		},
		"fraudCaseChecker": {
			"isEnabled": true,
			"isRiskCalculationEnabled": true
		}
	},
	"version": 4,
	"id": "67e55a52826f904dcbf63743",
	"createdAt": "2025-03-27T14:01:54.259Z",
	"modifiedAt": "2025-03-27T14:29:20.097Z",
	"createdBy": "b3e96bd8-96a6-48f5-b378-610d177be354",
	"defaultConfiguration": false,
	"relatedConfigurations": []
}

Configuration Template Structure explanation:

dnsblChecker - Disposable Mail Checker Identifies email addresses associated with disposable or temporary email services, helping to maintain data quality and authenticity by filtering out unreliable addresses.

dnsblChecker - DNS Blacklist Checker Checks if a domain’s IP addresses are listed on DNS-based Blackhole Lists (DNSBLs) to identify potential sources of spam or malicious activity.

freemailChecker - Freemail Checker Detects freemail addresses provided by public email service providers, assessing the quality and legitimacy of user-provided email addresses.

roleCategoryChecker - Role Category Checker Identifies and categorizes role-based email addresses (e.g., support@example.com) to enhance personalization and communication strategies.

whoisChecker - Whois Checker Retrieves and analyzes WHOIS information for a given domain, providing valuable details such as registration and expiration dates, and other relevant metadata.

sharedEmailChecker - Shared Email Checker Identifies shared email addresses among community members while ensuring privacy through anonymous data sharing and secure hashing.

dataBreachChecker - Data Breach Checker Analyzes email accounts and domains for potential data breaches using the "Have I Been Pwned" API, providing insights into the security status of the email address or domain.

fraudCaseChecker - Fraud Case Checker Identifies email addresses involved in any reported and confirmed fraud cases via CDQ's Fraud Guard.

Configuration Parameters:

 
"isEnabled": true,

If true, this checker will be enabled and used in your configuration. 

 
"isRiskCalculationEnabled": true,

If true, this checker will be used to calculate Risk Score. 

 
"disposableFactorWeight": 100,

Set a Factor Weight for this checker. 100 is the maximum Overall Risk Score. 

 
"youngDomainAgeThreshold": 365,

Defines the threshold for considering a domain as young. Default is 365 days (1 year).

Step 2: Verify Email by Email Domain Guard with you Configuration

Make a GET request to the API endpoint with the configuration ID in the URL. Endpoint: 

https://api.cdq.com/email-analysis/rest/emails/verify

Request Headers: 

{
  "Content-Type": "application/json",
  "X-API-KEY": << your API Key >>
}

Request Body: 

{
	"email": "developer-portal@cdq.com",
	"configurationId": "67bc591b8063ae6da21ff673"
}

Response Example: 

{
	"email": "developer-portal@cdq.com",
	"summary": {
		"isBreachedDomain": false,
		"isBreachedEmail": false,
		"isBlacklisted": false,
		"isPublicWhois": true,
		"isSharedEmail": false,
		"isValidFormat": true,
		"isFreemail": false,
		"isRoleBased": false
	},
	"status": {
		"code": 200,
		"technicalKey": "OK",
		"details": [
			{
				"id": 200000000,
				"message": "Successful request.",
				"technicalKey": "DEFAULT_OK",
				"jsonRecord": {}
			},
			{
				"id": 200600005,
				"message": "Domain age is older than 1095 days.",
				"technicalKey": "EMAIL_DOMAIN_OLDER_THAN",
				"jsonRecord": {}
			}
		]
	},
	"risk": {
		"score": 0,
		"classification": {
			"name": "Very low risk",
			"technicalKey": "VERY_LOW_RISK"
		}
	},
	"format": {
		"isValidFormat": true,
		"parts": {
			"localPart": "developer-portal",
			"topLevelDomain": "com",
			"baseDomain": "cdq",
			"domain": "cdq.com"
		}
	},
	"domain": {
		"isValidDomain": true
	},
	"sharing": {
		"isSharedEmail": false,
		"subscribers": 0
	},
	"role": {
		"isRoleBased": false
	},
	"freemail": {
		"isFreemail": false
	},
	"disposable": {},
	"whois": {
		"isPublicWhois": true,
		"entry": {
			"dates": {
				"creationDate": "1996-12-14T05:00:00",
				"updatedDate": "2024-11-08T23:48:45",
				"ageInDays": 10334,
				"ageInYears": 28.312328767123287
			},
			"registrar": {
				"name": "Amazon Registrar, Inc.",
				"email": "trustandsafety@support.aws.com"
			}
		}
	},
	"dnsBlacklist": {
		"isDnsBlacklisted": false,
		"dnsBlacklists": []
	},
	"breaches": {
		"isBreachedEmail": false,
		"isBreachedDomain": false
	},
	"fraudCases": {}
}

For more details on how to implement Email Domain Guard and integrate it into your existing systems, visit our Developer Portal.

Guide that will walk you through the process of using the Email Domain Guard API: How to verify e-mail address?

Please refer to the API documentation for detailed information: Email Analysis API

Retrieved from "https://meta.cdq.com/index.php?title=Release_note/20250331&oldid=713050"