Child pages
  • WHM API 1 Functions - validate_current_dkims
Skip to end of metadata
Go to start of metadata

Description

This function retrieves the Domain Keys Identified Mail (DKIM) records for one or more domains.

Important:

When you disable the MailSend role, the system disables this function. For more information, read our How to Use Server Profiles documentation.

Examples


 JSON API
https://hostname.example.com:2087/cpsess##########/json-api/validate_current_dkims?api.version=1&domain=example.com


Note:

This example calls the UAPI function via a cPanel session. For more information, read our Guide to UAPI documentation. 

 Command Line
whmapi1 validate_current_dkims domain=example.com


Notes:

  • You must URI-encode values.
  • For more information and additional output options, read our Guide to WHM API 1 documentation or run the whmapi1 --help command.
  • If you run CloudLinux™, you must use the full path of the whmapi1 command:

    /usr/local/cpanel/bin/whmapi1

 Output (JSON)
{  
   "data":{  
      "records":[  
         {  
            "state": "VALID",
            "expected": "v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDw5nw4NP1RsWXlfmiMzByDfOT16QCZO\/xJtrPZKskZF8\/sU0zWGTqKUOErlyJfoJzMDUv3\/zzjGswc2nEmYqxxoQZaBkN4QaS6MvJQxysAr+sK8C248\/r9zMperQdhJedUVejtpFQHJwgqpHy1tQMxY37L7sQjdxmQ5WnQ1acXiwIDAQAB\\",
            "domain": "default._domainkey.example.com",
            "records": [
                {
                    "state": "VALID",
                    "current": "v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDw5nw4NP1RsWXlfmiMzByDfOT16QCZO\/xJtrPZKskZF8\/sU0zWGTqKUOErlyJfoJzMDUv3\/zzjGswc2nEmYqxxoQZaBkN4QaS6MvJQxysAr+sK8C248\/r9zMperQdhJedUVejtpFQHJwgqpHy1tQMxY37L7sQjdxmQ5WnQ1acXiwIDAQAB\\"
                }
            ]
        }
    ],
    "metadata": {
       "command": "validate_current_dkims",
	   "reason": "OK",
	   "version": 1,
	   "result": 1
    }
  }
}


Note:

Use WHM's API Shell interface (WHM >> Home >> Development >> API Shell) to directly test WHM API calls.

Parameters

ParameterTypeDescriptionPossible valuesExample
domainstring

Required

The domain for which to check the DKIM records.

Note:

To validate multiple domains, duplicate the parameter. For example, use the domain=example.com, domain=example1.com, and domain=example2.com parameters.

A valid domain that you own on the server.example.com

Returns

ReturnTypeDescriptionPossible valuesExample
recordsarray of hashes

An array that contains information about the domain's DKIM records.

Each hash contains the domain, state, expected returns and the records array of hashes.

                

domain

string

The domain used to check the DKIM record, prepended with the default._domainkey. string.

This function returns this value in the records array.

The given domain, prepended with the default._domainkey string.

default._domainkey.example.com

state

string

The domain's DKIM record status.

This function returns this value in the records array.

  • VALID — The DKIM record is valid.
  • MALFORMED — A single DKIM record exists, but the record does not match the expected DKIM specifications.
  • MISMATCH — A DKIM record exists, but it does not match the expected public key.
  • MISSING — No DKIM record exists for the domain in the DNS.
  • MULTIPLE — Multiple DKIM records exist for the domain in the DNS.
  • NOPUB — No key exists on the local server for the domain.
VALID

expected

string

The DKIM record's contents.

This function returns this value in the records array.

A valid string.
 Click to view...
v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDw5nw4NP1RsWXlfmiMzByDfOT16QCZO\/xJtrPZKskZF8\/sU0zWGTqKUOErlyJfoJzMDUv3\/zzjGswc2nEmYqxxoQZaBkN4QaS6MvJQxysAr+sK8C248\/r9zMperQdhJedUVejtpFQHJwgqpHy1tQMxY37L7sQjdxmQ5WnQ1acXiwIDAQAB

records

array of hashes

The domain's DNS DKIM TXT records.

This function returns this value in the records array.

Each hash contains the current and state returns.

current

string

The domain's DKIM TXT record data contents.

This function returns this value in the records array.

The full contents of the domain's DKIM TXT record.
 Click to view...
v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDw5nw4NP1RsWXlfmiMzByDfOT16QCZO\/xJtrPZKskZF8\/sU0zWGTqKUOErlyJfoJzMDUv3\/zzjGswc2nEmYqxxoQZaBkN4QaS6MvJQxysAr+sK8C248\/r9zMperQdhJedUVejtpFQHJwgqpHy1tQMxY37L7sQjdxmQ5WnQ1acXiwIDAQAB

state

string

The DKIM TXT record's status.

This function returns this value in the records array.

  • VALID — The DKIM TXT record matches the local server's public key.
  • MISMATCH — The DKIM TXT record does not match the DKIM private key stored on the server.
  • PERMFAIL — Multiple DKIM TXT records exist in in the domain's DNS or there is a DKIM TXT record misconfiguration.

VALID