# TLS/SSL Certificate Expiry & Integrity Auditor (`deepaksheoran172/tls-certificate-expiry-auditor`) Actor

Audit web domains in bulk for SSL/TLS certificate expiration dates (<30d warning), issuer authorities, and SAN coverage. Export security reports to JSON & CSV. Zero proxies. PPE ($0.003/record with 10 free preview items).

- **URL**: https://apify.com/deepaksheoran172/tls-certificate-expiry-auditor.md
- **Developed by:** [Deepak Sheoran](https://apify.com/deepaksheoran172) (community)
- **Categories:** SEO tools, Developer tools, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 tls certificate expiry & trust audits

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## TLS/SSL Certificate Expiry & Integrity Auditor — Apify Actor

[![Actor Status](https://apify.com/actor-badge?actor=deepaksheoran172/tls-certificate-expiry-auditor)](https://apify.com/deepaksheoran172/tls-certificate-expiry-auditor)
[![Apify Store](https://img.shields.io/badge/Apify-Store%20Listing-blue.svg)](https://apify.com/deepaksheoran172/tls-certificate-expiry-auditor)
[![Pricing](https://img.shields.io/badge/Pricing-PAY_PER_EVENT-green.svg)](https://apify.com/deepaksheoran172/tls-certificate-expiry-auditor)

***

### 1. Product Introduction

**TLS/SSL Certificate Expiry & Integrity Auditor** is a production-grade Apify Actor designed to deliver high-velocity, reliable, and structured data processing for modern software pipelines.

- **Primary Goal:** Perform direct cryptographic TLS socket handshakes to inspect X.509 certificate validity, issuer chains, and exact days to expiration.
- **Target Audience:** DevOps, Security, and Compliance Teams.
- **Required Inputs:** Plain JSON configuration providing target identifiers, domains, URLs, or search criteria.
- **Primary Deliverables:** Fully sanitized, RFC-compliant JSON and CSV records pushed directly to the default Apify Dataset.
- **Business Value:** Replaces hours of brittle manual scripts, expensive SaaS subscriptions, or manual verification with deterministic, serverless cloud execution.

***

### 2. Why This Actor Is Useful

Extracting, validating, and monitoring modern web and cloud signals requires robust handling of dirty data, network transient faults, and rate limits. Traditional scrapers crash when encountering malformed payloads, unannounced layout updates, or transient HTTP 429/503 errors.

This Actor solves these challenges through:

1. **Deterministic Data Normalization:** Enforces strict RFC standards, UTC ISO-8601 timestamps, and clean schema mappings.
2. **Automated Error Recovery:** Implements bounded exponential backoff with jitter and respects upstream rate limits.
3. **Zero Financial Leakage:** Adheres to strict zero-cost billing guarantees—you are never billed for diagnostic errors, empty outputs, or upstream network outages.
4. **Immediate Pipeline Readiness:** Direct integration with Zapier, Make.com, Python SDK, cURL, and Model Context Protocol (MCP) AI agents.

***

### 3. Key Features

- **Asynchronous Scalability:** High-throughput async engine optimized for low memory footprint (4096 MB) and rapid execution.
- **Network Resilience:** Automatic retry logic with backoff for HTTP 408, 429, 500, 502, 503, and 504 responses.
- **SSRF & Security Isolation:** Strict protection against Server-Side Request Forgery, loopback IP probing, and private subnet traversal.
- **Spreadsheet Formula Neutralization:** Automatically escapes spreadsheet formula prefixes (`=`, `+`, `-`, `@`) to protect downstream Excel and Google Sheets users.
- **Comprehensive Data Contracts:** Strict schema validation across `input_schema.json`, `dataset_schema.json`, and `output_schema.json`.
- **Informative Live Logging:** Clear, structured runtime progress logs without exposing sensitive tokens, credentials, or private headers.

***

### 4. Target Use Cases

- **B2B Growth & Lead Operations:** Automate enrichment pipelines, qualify outbound domain lists, and feed clean records to CRMs.
- **Engineering & DevOps Teams:** Monitor external dependencies, endpoints, infrastructure health, and configuration changes automatically.
- **Agencies & Consultancies:** Deliver client audits, competitive intelligence decks, and catalog migrations without manual spreadsheet wrangling.
- **Compliance & Security Officers:** Validate public-facing security headers, TLS configurations, and industry disclosures continuously.
- **Autonomous AI Agents & MCP:** Acts as a specialized tool for Claude, ChatGPT, and custom LLM workflows via the Model Context Protocol.

***

### 5. Complete Input Reference

Configure the Actor using the parameters below. Default values are pre-tuned for optimal reliability.

| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `domain` | `string` | No | `google.com` | Fully qualified target domain hostname without protocol prefix (for example 'stripe.com', 'github.com', or 'cloudflare.com') to audit. |
| `port` | `integer` | No | `443` | Configures TLS Port for the extraction execution. Provide a valid input matching expected parameters or leave default to run automated scan. |
| `webhookUrl` | `string` | No | \`\` | Optional Slack, Discord, or Zapier webhook URL to receive instant notification upon execution. |
| `enableDeltaMode` | `boolean` | No | `False` | When enabled, compares findings against previously seen IDs in Key-Value store and only returns newly discovered items. |
| `maxItems` | `integer` | No | `1` | Maximum total records to extract and deliver to the output dataset during this run (for example 50 or 100 records) to govern compute time and data volume. |

#### Sample Input JSON

```json
{
  "domain": "google.com",
  "port": 443,
  "webhookUrl": "",
  "enableDeltaMode": false,
  "maxItems": 1
}
```

***

### 6. Complete Output Reference

The Actor pushes structured records to the default Apify Dataset. All fields conform strictly to the declared dataset schema.

| Field | Type | Description |
|---|---|---|
| `type` | `string` | type |
| `properties` | `string` | properties |

#### Sample Output Record (JSON)

```json
{
  "type": "sample_type",
  "properties": "sample_properties"
}
```

***

### 7. Step-by-Step Tutorial

1. **Navigate to Apify Store:** Open [tls-certificate-expiry-auditor](https://apify.com/deepaksheoran172/tls-certificate-expiry-auditor) in your browser.
2. **Configure Input:** Enter your target parameters into the input form or paste your custom JSON payload.
3. **Start the Run:** Click the green **Start** button. The serverless container provisions within seconds.
4. **Monitor Execution:** Inspect the real-time execution log to track progress, item counts, and status indicators.
5. **Access Results:** When execution concludes, navigate to the **Dataset** tab to view, filter, or download records in JSON, CSV, Excel, XML, or HTML formats.
6. **Set up Automation:** Create an Apify Task or configure a recurring daily/weekly schedule to keep datasets continuously updated.

***

### 8. API & Automation Integration

#### Apify Python SDK

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run_input = {
  "domain": "google.com",
  "port": 443,
  "webhookUrl": "",
  "enableDeltaMode": false,
  "maxItems": 1
}

run = client.actor("deepaksheoran172/tls-certificate-expiry-auditor").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

#### cURL REST API

```bash
curl -X POST "https://api.apify.com/v2/acts/deepaksheoran172~tls-certificate-expiry-auditor/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "domain": "google.com",
  "port": 443,
  "webhookUrl": "",
  "enableDeltaMode": false,
  "maxItems": 1
}'
```

#### Webhooks & Integrations

Connect completed runs directly to Zapier, Make.com, or custom HTTP webhooks to pipe new dataset items into Airtable, HubSpot, Google Sheets, or Slack in real time.

***

### 9. Pricing & Cost Transparency

This Actor operates on transparent **Pay-Per-Event (PPE)** pricing:

- **Billing Model:** Pay-Per-Event (`PAY_PER_EVENT`)

- **Charge Event:** Primary billable outcome (`$0.003/event (Tiered)`)

- **Free Preview / Allowance:** Every account receives initial free allowances to test schemas and sample output before scale runs.

- **Compute Surcharge:** Zero additional compute unit charges on standard PPE execution.

- **No Charge on Error:** If a run terminates due to an upstream outage or invalid target, zero billable events are recorded.

- **Predictable Unit Economics:** Know your exact per-item cost before launching large batch jobs.

***

### 10. Performance & Operational Limits

- **Memory Allocation:** Standard runtime is configured for 4096 MB RAM.
- **Execution Timeout:** Default maximum execution time is 3600 seconds per run.
- **Concurrency & Backpressure:** Internal worker queues enforce bounded concurrency to maintain network hygiene and prevent upstream IP throttling.
- **Batch Processing Recommendation:** For ultra-large enterprise lists, chunk jobs into batches of 500–1,000 items per Actor run for optimal checkpointing.

***

### 11. Error Handling & Troubleshooting

The Actor uses explicit internal outcome statuses to report execution health:

| Status Code | Meaning | Remediation Action |
|---|---|---|
| `SUCCEEDED` | Processing completed normally with valid dataset records. | Results ready for downstream consumption. |
| `NO_RESULTS` | Target was queried successfully, but no matching records were found. | Verify target identifier, domain spelling, or query keywords. |
| `INVALID_INPUT` | Provided input failed schema validation or required parameters were missing. | Check input JSON against the Input Reference table. |
| `UPSTREAM_UNAVAILABLE` | Target source or third-party API returned 5xx errors or connection timeout. | The run aborts safely without billing; retry after a few minutes. |
| `RATE_LIMITED` | Upstream service returned HTTP 429 Too Many Requests. | Built-in backoff handles retries; if persistent, reduce batch size. |

***

### 12. Security & Compliance

- **Least Privilege Access:** Runs under restricted Apify platform permissions (`LIMITED_PERMISSIONS`) to prevent unauthorized account access.
- **Data Protection:** Does not store, cache, or resell proprietary target credentials.
- **SSRF Defense:** Prevents requests to internal metadata services (e.g., AWS IMDS `169.254.169.254`), localhost, and private subnets.
- **Disclaimer:** This Actor is an independent software tool developed for legitimate business automation, compliance auditing, and data extraction. It is not affiliated with, endorsed by, sponsored by, or associated with any third-party platform or service mentioned. All trademarks, service marks, and trade names referenced belong to their respective owners.

***

### 13. Frequently Asked Questions (FAQ)

##### Do I need to provide proxies?

No. Standard execution runs seamlessly on Apify cloud infrastructure without requiring external proxy configurations.

##### Can I run this Actor on a schedule?

Yes. Use Apify Tasks to schedule runs daily, weekly, or via cron syntax, and pipe results directly to downstream storage.

##### What happens if the target website or API is down?

The Actor gracefully terminates with status `UPSTREAM_UNAVAILABLE` and emits zero billable charge events.

##### How do I export records to Google Sheets or Excel?

From the dataset tab in the Apify Console, click **Export** and select **CSV** or **Excel**. All records include formula injection protection.

##### Can I use this Actor inside an AI Agent workflow?

Yes. The Actor conforms to Model Context Protocol (MCP) standards and can be triggered programmatically by autonomous AI frameworks.

***

### 14. Related Portfolio Actors

Extend your automation workflows with these complementary tools:

- [Website Contact Extractor](https://apify.com/deepaksheoran172/website-contact-extractor) — Complementary actor for upstream ingestion or downstream pipeline automation.
- [Store Catalog Redirect Extractor](https://apify.com/deepaksheoran172/store-catalog-redirect-extractor) — Complementary actor for upstream ingestion or downstream pipeline automation.
- [B2B Decision Maker Email Finder](https://apify.com/deepaksheoran172/b2b-decision-maker-email-finder) — Complementary actor for upstream ingestion or downstream pipeline automation.

***

### 15. Actor Status & Verification

- **Official Apify Status:** [![Actor Status](https://apify.com/actor-badge?actor=deepaksheoran172/tls-certificate-expiry-auditor)](https://apify.com/deepaksheoran172/tls-certificate-expiry-auditor)
- **Maintenance Policy:** Active 24/7 reliability monitoring. Schema updates and upstream adaptations deployed proactively.
- **Creator Support:** Questions or feature requests? Contact via Apify Console or open an issue on the Actor's Issues tab.

# Actor input Schema

## `domain` (type: `string`):

Fully qualified target domain hostname without protocol prefix (for example 'stripe.com', 'github.com', or 'cloudflare.com') to audit.

## `port` (type: `integer`):

Configures TLS Port for the extraction execution. Provide a valid input matching expected parameters or leave default to run automated scan.

## `webhookUrl` (type: `string`):

Optional Slack, Discord, or Zapier webhook URL to receive instant notification upon execution.

## `enableDeltaMode` (type: `boolean`):

When enabled, compares findings against previously seen IDs in Key-Value store and only returns newly discovered items.

## `maxItems` (type: `integer`):

Maximum total records to extract and deliver to the output dataset during this run (for example 50 or 100 records) to govern compute time and data volume.

## Actor input object example

```json
{
  "domain": "google.com",
  "port": 443,
  "webhookUrl": "",
  "enableDeltaMode": false,
  "maxItems": 1
}
```

# Actor output Schema

## `results` (type: `string`):

Direct URL to live dataset items containing extracted records.

## `datasetItems` (type: `string`):

Direct JSON/CSV download endpoint for extracted dataset records.

## `summaryJson` (type: `string`):

JSON execution metrics and billing audit record.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "domain": "google.com",
    "port": 443,
    "webhookUrl": "",
    "enableDeltaMode": false,
    "maxItems": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("deepaksheoran172/tls-certificate-expiry-auditor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "domain": "google.com",
    "port": 443,
    "webhookUrl": "",
    "enableDeltaMode": False,
    "maxItems": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("deepaksheoran172/tls-certificate-expiry-auditor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "domain": "google.com",
  "port": 443,
  "webhookUrl": "",
  "enableDeltaMode": false,
  "maxItems": 1
}' |
apify call deepaksheoran172/tls-certificate-expiry-auditor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,deepaksheoran172/tls-certificate-expiry-auditor"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Vv0sJZL44xgSAn2Zm/builds/NxRbTEcru7UQZFNV2/openapi.json
