Retrieve Endpoint Analyze
AI-generatedOverview
The node "SSL Checker" provides functionality to check SSL/TLS certificates and analyze endpoints using different methods. It supports three main operations:
- Quick Check Certificate: Performs a quick certificate check using the ssl-checker.io API.
- Full Scan Certificate: Conducts a full SSL scan of a domain using the SSL Labs API, waiting until the scan is complete.
- Retrieve Endpoint Analyze: Retrieves detailed endpoint analysis data from SSL Labs for a specific target domain and endpoint.
This node is useful for security engineers, DevOps, or anyone needing to verify SSL certificate status, perform in-depth SSL scans, or gather endpoint-specific SSL information programmatically within an n8n workflow.
Practical Examples
- Quickly verify if a website's SSL certificate is valid and view its details.
- Perform a comprehensive SSL scan on a domain to assess overall SSL health and configuration.
- Retrieve detailed SSL endpoint data (e.g., for a specific IP address) to diagnose issues or monitor SSL configurations.
Properties
| Name | Meaning |
|---|---|
| Operation | The type of SSL check to perform. Options: Quick Check Certificate, Full Scan Certificate, Retrieve Endpoint Analyze. |
| Target Domain | The domain name to be checked or scanned (e.g., "google.com"). |
| Target Endpoint | (Only for "Retrieve Endpoint Analyze") The specific endpoint (IP or hostname) to analyze. |
| Options | Additional options: - Put Result in Field: The output JSON field name where results are stored (default: "ssl"). |
Output
The node outputs JSON data containing the results of the selected operation under the specified result field (default "ssl"). For the "Retrieve Endpoint Analyze" operation, the data is nested under a subfield named <result_field>.analyze (e.g., ssl.analyze).
- Quick Check Certificate: JSON object with certificate details returned by ssl-checker.io.
- Full Scan Certificate: JSON object representing the full SSL Labs scan report once the scan is ready.
- Retrieve Endpoint Analyze: JSON object with detailed endpoint SSL analysis from SSL Labs.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for SSL Labs API to perform full scans and endpoint analyses.
- Uses public API at ssl-checker.io for quick certificate checks (no authentication required).
- Network access to
https://api.ssllabs.comandhttps://ssl-checker.ioendpoints. - The node internally handles polling for scan readiness when performing full scans.
Troubleshooting
- Timeouts or long waits during full scans: The full scan operation polls the SSL Labs API until the scan status is "READY" or "ERROR". Depending on the domain, this can take several minutes. Ensure your workflow timeout settings accommodate this delay.
- Invalid or missing API credentials: The SSL Labs API requires valid credentials (email and other info). If credentials are incorrect or missing, requests will fail.
- Incorrect domain or endpoint input: Providing invalid domain names or endpoints may cause API errors or empty results.
- Network connectivity issues: Ensure the n8n instance has internet access to reach external APIs.
- Error messages from SSL Labs API: These usually indicate issues with the request parameters or rate limiting. Verify inputs and consider retrying after some time.
Links and References
- SSL Labs API Documentation
- ssl-checker.io API
- n8n HTTP Request Node Documentation (for understanding underlying HTTP calls)