Documentation

Everything you need to get started with com.bond

Quick Start Guide

Get your verified .com.bond subdomain up and running in minutes.

Step 1: Sign Up

Create your com.bond account with your business email. You'll need:

  • A valid .com domain that you own
  • Access to your domain's DNS settings
  • Your company information

Step 2: Add Verification Record

Add the following TXT record to your domain's DNS:

Type: TXT Host: _com-bond-verify Value: combond-verify-[your-unique-code] TTL: 300

Step 3: Verify Domain

Click "Verify Now" in your dashboard. Verification typically completes within 5 minutes.

Step 4: Create Subdomains

Once verified, you can create subdomains like:

  • yourcompany.com.bond/api
  • yourcompany.com.bond/docs
  • yourcompany.com.bond/status

Domain Verification

DNS TXT Record Method

The primary verification method uses a DNS TXT record. This proves you have control over the domain.

Note: Keep the verification TXT record in place. We periodically re-verify domain ownership for security.

Alternative Verification Methods

For enterprise customers, we also support:

  • HTML File Upload: Upload a verification file to your domain root
  • Meta Tag: Add a verification meta tag to your homepage
  • Domain Registrar API: Direct verification through supported registrars

Troubleshooting Verification

If verification fails:

  • Ensure the TXT record is added to the root domain, not a subdomain
  • Wait for DNS propagation (up to 48 hours, typically 5-10 minutes)
  • Check for typos in the verification code
  • Verify you have the correct DNS provider

Managing Subdomains

Creating Subdomains

From your dashboard, click "New Subdomain" and choose:

  • Subdomain prefix: e.g., "api", "docs", "status"
  • Service type: Static site, API proxy, status page, etc.
  • Configuration: Service-specific settings

Subdomain Types

Static Sites

Host documentation, marketing pages, or microsites:

  • Deploy via Git, ZIP upload, or API
  • Automatic SSL certificates
  • Global CDN distribution
  • Custom headers and redirects

API Proxy

Create verified API endpoints:

  • Route to your backend services
  • Automatic rate limiting
  • Request/response transformation
  • Built-in analytics

Status Pages

Professional status monitoring:

  • Component monitoring
  • Incident management
  • Subscriber notifications
  • Historical uptime data

Security Features

SSL/TLS Certificates

All subdomains automatically receive:

  • Free SSL certificates via Let's Encrypt
  • Automatic renewal
  • TLS 1.3 support
  • HSTS enforcement

Access Control

Protect your subdomains with:

  • IP Allowlisting: Restrict access by IP address
  • Basic Auth: Username/password protection
  • JWT Validation: Token-based authentication
  • SSO Integration: SAML/OAuth support (Enterprise)

DDoS Protection

All subdomains include:

  • Always-on DDoS mitigation
  • Rate limiting per IP
  • Geographic filtering options
  • Bot detection and blocking

Analytics & Monitoring

Built-in Analytics

Track performance and usage:

  • Request volume and response times
  • Geographic distribution
  • Error rates and status codes
  • Bandwidth usage

Real-time Monitoring

Set up alerts for:

  • Uptime monitoring (1-minute intervals)
  • Performance degradation
  • SSL certificate issues
  • Traffic anomalies

Integration Options

Export data to your tools:

  • Webhook notifications
  • Datadog integration
  • Splunk forwarding
  • Custom API access

Best Practices

Subdomain Naming

  • Use descriptive prefixes (api, docs, status)
  • Consider regional prefixes (eu, us, asia)
  • Avoid generic terms (www, app)
  • Keep names short and memorable

Security Recommendations

  • Enable 2FA on your com.bond account
  • Rotate API keys regularly
  • Use IP allowlisting for sensitive endpoints
  • Monitor access logs for anomalies

Performance Optimization

  • Enable caching for static content
  • Use compression for text assets
  • Optimize images before upload
  • Leverage CDN geographic distribution

Troubleshooting

Common Issues

Subdomain Not Accessible

  • Check domain verification status
  • Verify subdomain is active in dashboard
  • Clear DNS cache locally
  • Check for typos in subdomain name

SSL Certificate Errors

  • Certificate provisioning can take up to 15 minutes
  • Ensure subdomain is correctly configured
  • Check for CAA records blocking issuance
  • Contact support if issues persist

Performance Issues

  • Check analytics for traffic spikes
  • Review caching configuration
  • Verify origin server performance
  • Consider upgrading plan for more resources

API Quick Reference

Basic API operations for managing your subdomains:

Authentication

curl -H "Authorization: Bearer YOUR_API_KEY" \ https://com.bond/api/v1/subdomains

List Subdomains

GET /v1/subdomains Response: { "subdomains": [ { "id": "sub_123", "prefix": "api", "domain": "example.com.bond", "type": "proxy", "status": "active" } ] }

Create Subdomain

POST /v1/subdomains { "prefix": "docs", "type": "static", "config": { "index": "index.html" } }

For complete API documentation, see our API Reference.

Need Help?

We're here to assist you: