Overview
SPOG.AI integrates with Tucows OpenSRS to centralize domain inventory and lifecycle visibility. The implemented connector imports domains, expiration dates, lock status, nameservers, automatic-renewal status, and let-expire status into the SPOG.AI CMDB.
Key Features
| Capability | Description |
| Domain Inventory | Imports OpenSRS domains returned for the connector expiry window. |
| Expiration Tracking | Collects domain expiration dates for lifecycle visibility. |
| Renewal Visibility | Tracks automatic-renewal and let-expire status. |
| Protection and DNS Context | Collects domain lock status and nameserver metadata. |
| CMDB Enrichment | Normalizes domain records and removes stale Tucows enrichment after a successful synchronization. |
How the Integration Works
The SPOG Appliance sends signed OpenSRS XCP XML requests over HTTPS using the reseller username and API key. It retrieves domains by expiration date, pages through the results, requests status details for each domain, and enriches domain records with expiration, lock, nameserver, auto-renew, and let-expire attributes.
Prerequisites
- Before configuring the integration, ensure the following prerequisites are met:
- Tenant Admin authorization in SPOG.AI and permission to create integrations.
- An active Tucows OpenSRS reseller account with API access enabled.
- OpenSRS reseller username, API key, and API endpoint URL.
- The SPOG Appliance public egress IP allowlisted in OpenSRS where required.
- Outbound HTTPS access from the SPOG Appliance to the OpenSRS API endpoint.
Configuration
1. Prepare OpenSRS API Access
- Configure API access in the Tucows Reseller Dashboard.
- Open the API Settings or OpenSRS API Configuration page.
- Record the reseller username and generate or retrieve the API key.
- Allowlist the SPOG Appliance public egress IP when IP restrictions are enabled.
2. Record the API Endpoint
- Identify the endpoint for the applicable OpenSRS environment.
- Use the production endpoint assigned to the reseller account, such as https://rr-n1-tor.opensrs.net/.
- Confirm the endpoint accepts signed XCP XML requests from the appliance network.
3. Configure and Link the Integration
- Add the Tucows integration in SPOG.AI.
- Enter the API endpoint, reseller username, and API key.
- Run Test Connection, save the integration, and link it to the required appliance.
Configuration Fields
Use the fields below when creating the integration in SPOG.AI.
| Field | Requirement | Description |
| host | Mandatory | OpenSRS API endpoint URL, such as https://rr-n1-tor.opensrs.net/. |
| reseller_username | Mandatory | OpenSRS reseller username sent in the X-Username header. |
| api_key | Mandatory | OpenSRS API key used to generate the X-Signature request header. |
Security and Connectivity
- Use a dedicated, least-privileged reseller credential for domain inventory.
- Store the API key in a secrets vault, rotate it periodically, and revoke it immediately if compromised.
- Restrict API access through OpenSRS IP allowlisting where supported.
- Allow outbound HTTPS port 443 to the configured OpenSRS endpoint and require TLS 1.2 or later.
- Note: the current connector disables certificate verification on the domain-list request and logs request headers and provider responses; remediate these issues before production deployment.
Validation and Data Coverage
Run Test Connection or start a synchronization, then confirm Tucows domains appear in SPOG.AI with expiration, lock, nameserver, auto-renew, and let-expire data. Authentication or permission failures indicate an invalid reseller username, API key, or IP allowlist; timeouts usually indicate DNS, proxy, firewall, or endpoint issues.
Data Coverage
| Category | Data Collected |
| Domains | Domains returned by the OpenSRS get_domains_by_expiredate action for the connector window. |
| Lifecycle | Expiration date, automatic-renewal status, and let-expire status. |
| Protection | Domain lock status returned by the OpenSRS status query. |
| Nameservers | Nameserver metadata returned with domain status. |
| Not Implemented | DNS zone or record ingestion, registrar and ownership details, DNS health checks, drift detection, write operations, and automated incident creation are not performed by the current connector. |
Uninstalling the Integration
- Delete the Tucows integration in SPOG.AI and unlink it from the appliance.
- Revoke or replace the OpenSRS API key when it is no longer required.
- Remove obsolete IP allowlist, firewall, or proxy rules.