Difference between revisions of "DKIM (Rest API)"

From Rackspace Email & Apps API
Jump to: navigation, search
Line 55: Line 55:
 
}
 
}
 
</pre>
 
</pre>
 +
  
 
=== Get Domain's Current DKIM Status ===
 
=== Get Domain's Current DKIM Status ===
Line 101: Line 102:
 
}
 
}
 
</pre>
 
</pre>
 +
  
 
=== Disable DKIM on a Domain ===
 
=== Disable DKIM on a Domain ===
Line 134: Line 136:
 
DELETE '/customers/customer_id/domains/domain_name/dkim/disable',
 
DELETE '/customers/customer_id/domains/domain_name/dkim/disable',
 
</pre>
 
</pre>
 +
  
 
=== Complete and Verify Enabling DKIM or Rotating Domain Keys ===
 
=== Complete and Verify Enabling DKIM or Rotating Domain Keys ===
Line 166: Line 169:
 
''Example'':
 
''Example'':
 
<pre>
 
<pre>
POST '/customers/customer_id/domains/domain_name/dkim/verification',
+
POST '/customers/customer_id/domains/domain_name/dkim/verification'
{
 
  "hostedBy": "external",
 
  "verificationSuccessful": false,
 
  "reason": "dnsKey mismatch",
 
  "subdomain": "20170209._domainkey",
 
  "dnsKey": "v=DKIM22; k=rsa; p=IAmABadKey",
 
  "expectedDnsKey": "v=DKIM1; k=rsa; p=DNSKeyGoesHere"
 
}
 
 
</pre>
 
</pre>

Revision as of 07:25, 7 February 2019

v1 - Current

Authentication and Authorization

Authentication

Users of this API must be successfully authenticated. See Rest API - Authentication for instructions.

Authorization

Authenticated users must have access to both the customer ID and the domain name that they provide.


Enable DKIM or Rotate Keys

URL:

[POST] https://cp.rackspace.com/customers/{customer_id}/domains/{domain_name}/dkim/enable


Description:

Enables DKIM or rotates keys by generating a new certificate for message signing. Process needs to be completed using DKIM verification route.


Parameters:

Field Name Data Type Description
customer_id string ID of customer who owns domain_name
domain_name string Domain to act on


Example:

POST '/customers/customer_id/domains/domain_name/dkim/enable'


Status Code 200 Result Example:

{
  "hostedBy": "external",
  "tatus": "pendingVerification",
  "subdomain": "20170209._domainkey",
  "dnsKey": "v=DKIM1; k=rsa; p=DNSKeyGoesHere"
}


Get Domain's Current DKIM Status

URL:

[GET] https://cp.rackspace.com/customers/{customer_id}/domains/{domain_name}/dkim/status


Description:

Returns the status of DKIM configuration for a domain.


Parameters:

Field Name Data Type Description
customer_id string ID of customer who owns domain_name
domain_name string Domain to act on


Examples:

GET '/customers/customer_id/domains/domain_name/dkim/status'


Status Code 200 Result Example:

{
  "hostedBy": "external",
  "status": "pendingVerification",
  "selector": "20170209",
  "subdomain": "20170209._domainkey",
  "publicKey": "-----BEGIN PUBLIC KEY-----PublicKeyGoesHere-----END PUBLIC KEY-----",
  "dnsKey": "v=DKIM1; k=rsa; p=DNSKeyGoesHere"
}


Disable DKIM on a Domain

URL:

[DELETE] https://cp.rackspace.com/customers/{customer_id}/domains/{domain_name}/dkim/disable


Description:

Disables DKIM for a domain by revoking all existing certificates.


Parameters:

Field Name Data Type Description
customer_id string ID of customer who owns domain_name
domain_name string Domain to act on


Example:

DELETE '/customers/customer_id/domains/domain_name/dkim/disable',


Complete and Verify Enabling DKIM or Rotating Domain Keys

URL:

[POST] https://cp.rackspace.com/customers/{customer_id}/domains/{domain_name}/dkim/verification


Description:

Verifies that a DNS record has been created with the selector/public key for DKIM as been added for a domain. If the record has been successfully verified, the certificate is enabled, and any other existing certificates are deleted.


Parameters:

Field Name Data Type Description
customer_id string ID of customer who owns domain_name
domain_name string Domain to act on


Example:

POST '/customers/customer_id/domains/domain_name/dkim/verification'