Skip to main content

Cipher Suites

developer
GET/v1/domain/ciphers

Analyzes TLS cipher suite configuration for a domain by detecting the CDN/server infrastructure and reporting its known cipher suites. For sites behind Cloudflare, AWS CloudFront, Fastly, or Akamai, the endpoint returns the CDN's published default cipher suite configuration. For other servers, it provides a Mozilla Intermediate reference profile. Each cipher is graded and classified with forward secrecy, AEAD support, security level, and Mozilla compatibility assessment.

What It Does

Connects to the domain over TLS, detects the CDN or server infrastructure from response headers, then reports the appropriate cipher suite profile. For detected CDNs (Cloudflare, CloudFront, Fastly, Akamai), it uses the CDN's published default cipher suites. Each cipher is classified by protocol version, key exchange, authentication, encryption, MAC, AEAD support, forward secrecy, security level (recommended/secure/weak/insecure), and includes the OpenSSL name for cross-referencing. Returns overall grade, Mozilla Modern/Intermediate compatibility, and actionable recommendations.

Why It's Useful

Cipher suite configuration determines the actual encryption strength of TLS connections. Weak ciphers (RC4, DES, export ciphers) can be exploited even with modern TLS versions, and missing forward secrecy means a compromised server key decrypts all past traffic. Regular cipher auditing against Mozilla SSL Configuration Generator (modern/intermediate profiles) and NIST SP 800-52r2 is required for PCI-DSS and SOC 2 compliance.

Use Cases

Security Engineer

Security Hardening Verification

After configuring cipher suites, verify only strong ciphers are enabled and properly ordered.

Confirm cipher hardening is effective and no weak ciphers remain.

Auditor

Compliance Assessment

Verify cipher suite configuration meets compliance requirements (e.g., NIST guidelines).

Document cipher compliance for regulatory audits.

Penetration Tester

Vulnerability Assessment

Identify weak cipher suites that could be exploited in downgrade attacks.

Find cryptographic weaknesses during security assessments.

Parameters

NameTypeRequiredDescription
domainstringRequiredThe domain to analyze cipher suites forExample: example.com
portnumberOptionalPort to connect to (default: 443)Example: 443

Response Fields

FieldTypeDescription
domainstringThe queried domain
portnumberThe port used for connection
overallGradestringOverall cipher suite security grade (A+ through F)
ciphersarrayCipher suites with name, grade, protocol, openSslName, keyExchange, authentication, encryption, mac, isAEAD, forwardSecrecy, securityLevel, keySize, and issues
bestCipherstringName of the strongest cipher suite
worstCipherstringName of the weakest cipher suite
issuesarraySecurity issues found with the cipher configuration
recommendationsarrayActionable cipher suite improvement suggestions
serverInfoobjectDetected CDN and server information (cdn, server)
analysisMethodstringHow the cipher data was obtained: cdn-detected or reference
tlsVersionsarrayTLS versions supported by the cipher profile
supportsForwardSecrecybooleanWhether any cipher provides perfect forward secrecy
supportsAEADbooleanWhether any cipher uses authenticated encryption (AEAD)
mozillaCompatibilityobjectCompatibility with Mozilla Modern and Intermediate TLS profiles
countnumberTotal number of cipher suites
timestampstringISO 8601 timestamp of the analysis

Code Examples

cURL
curl "https://api.edgedns.dev/v1/domain/ciphers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "domain=example.com"
JavaScript
const response = await fetch(
  'https://api.edgedns.dev/v1/domain/ciphers?domain=example.com',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data);
Python
import requests

response = requests.get(
    'https://api.edgedns.dev/v1/domain/ciphers',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
    'domain': 'example.com'
    }
)

data = response.json()
print(data)

Read the full Cipher Suites guide

Why it matters, real-world use cases, parameters, response fields, and how to call it from Claude, ChatGPT, or Gemini via MCP.

Read the guide →

Related Endpoints

External References

Learn more about the standards and protocols behind this endpoint.

Try This Endpoint

Test the Cipher Suites endpoint live in the playground.