Mail::DKIM::PublicKey - Represents a DKIM key

NAME  VERSION  CONSTRUCTOR  fetch() − retrieve a public key record from DNS  METHODS  granularity() − get or set the granularity (g=) field  AUTHORS  THANKS  COPYRIGHT AND LICENSE 

---

NAME

Mail::DKIM::PublicKey − Represents a DKIM key

VERSION

version 1.20230911

CONSTRUCTOR

fetch() − retrieve a public key record from DNS

my $public_key = Mail::DKIM::PublicKey−>fetch(
Protocol => 'dns',
Selector => 'brisbane',
Domain => 'example.com',
);

If the public key is found, a Mail::DKIM::PublicKey object is returned, representing the information found in DNS. If the public key does not exist in DNS, then "undef" is returned. If a DNS error occurs while fetching the key, then this method will "die". If the public key was found, but is not valid (e.g. it is "revoked"), then this method will "die".

METHODS

granularity() − get or set the granularity (g=) field

my $g = $public_key−>granularity;
$public_key−>granularity('*');

Granularity of the key. The value must match the Local-part of the effective "i=" tag of the DKIM-Signature header field. The granularity is a literal value, or a pattern with a single ’*’ wildcard character that matches zero or more characters.

If no granularity is defined, then the default value, ’*’, will be returned.

AUTHORS

	•		Jason Long <[email protected]>
	•		Marc Bradshaw <[email protected]>
	•		Bron Gondwana <[email protected]> (ARC)

THANKS

Work on ensuring that this module passes the ARC test suite was generously sponsored by Valimail (https://www.valimail.com/)

COPYRIGHT AND LICENSE

	•		Copyright (C) 2013 by Messiah College
	•		Copyright (C) 2010 by Jason Long
	•		Copyright (C) 2017 by Standcore LLC
	•		Copyright (C) 2020 by FastMail Pty Ltd

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.

---