package checker import ( "time" sdk "git.happydns.org/checker-sdk-go/checker" ) // Version is the checker version reported in CheckerDefinition.Version. var Version = "built-in" // Definition returns the CheckerDefinition for the PTR checker. func (p *ptrProvider) Definition() *sdk.CheckerDefinition { def := &sdk.CheckerDefinition{ ID: "ptr", Name: "PTR / Reverse DNS", Version: Version, Availability: sdk.CheckerAvailability{ ApplyToService: true, LimitToServices: []string{"svcs.PTR"}, }, ObservationKeys: []sdk.ObservationKey{ObservationKeyPTR}, Options: sdk.CheckerOptionsDocumentation{ UserOpts: []sdk.CheckerOptionDocumentation{ { Id: "requireForwardMatch", Type: "bool", Label: "Require forward-confirmed reverse DNS (FCrDNS)", Description: "When enabled, a PTR whose target does not resolve back to the original IP is reported as critical (otherwise as warning). Mail servers and many SSH setups require FCrDNS.", Default: true, }, { Id: "allowMultiplePTR", Type: "bool", Label: "Allow multiple PTR records on the same IP", Description: "When disabled, more than one PTR at the same owner name is reported as warning (RFC 1912 ยง2.1 recommends a single PTR per IP).", Default: false, }, { Id: "minTTL", Type: "uint", Label: "Minimum PTR TTL (seconds)", Description: "PTR records with a TTL below this threshold are flagged as warning. Very short TTLs degrade resolver cache efficiency.", Default: float64(300), }, { Id: "flagGenericPTR", Type: "bool", Label: "Flag generic-looking PTR hostnames", Description: "When enabled, PTR targets that embed the dotted IP or match common ISP auto-generated patterns are reported as warning.", Default: true, }, }, ServiceOpts: []sdk.CheckerOptionDocumentation{ { Id: "service_type", Label: "Service type", AutoFill: sdk.AutoFillServiceType, }, { Id: "service", Label: "Service", AutoFill: sdk.AutoFillService, }, { Id: "domain_name", Label: "Reverse zone", AutoFill: sdk.AutoFillDomainName, }, { Id: "subdomain", Label: "PTR record", AutoFill: sdk.AutoFillSubdomain, }, }, }, Rules: Rules(), HasHTMLReport: true, Interval: &sdk.CheckIntervalSpec{ Min: 5 * time.Minute, Max: 24 * time.Hour, Default: 1 * time.Hour, }, } def.BuildRulesInfo() return def }