Skip to content

Conversation

@gyanaranjans
Copy link
Contributor

Description

This pull request introduces a new Domain Connect template for the Blink service, enabling automated DNS configuration for website hosting, subdomains, email, and domain verification. The template defines all required DNS records and variables for seamless integration

Type of change

Please mark options that are relevant.

  • New template
  • Bug fix (non-breaking change which fixes an issue in the template)
  • New feature (non-breaking change which adds functionality to the template)
  • Breaking change (fix or feature that would cause existing template behavior to be not backward compatible)

How Has This Been Tested?

Please mark the following checks done

  • Schema validated using JSON Schema template.schema
  • Template functionality checked using Online Editor
  • Template is checked using template linter
  • Template file name follows the pattern <providerId>.<serviceId>.json
  • resource URL provided with logoUrl is actually served by a webserver

Example variable values

Use Case 1: Apex Domain Setup (Website Hosting)

verification: abc123def456ghi789
ip1: 75.2.60.5
ip2: 99.83.231.61
target: proxy.blink.new

Resulting Records:

  • TXT _blinkblink-verify=abc123def456ghi789
  • A @75.2.60.5
  • A @99.83.231.61
  • CNAME wwwproxy.blink.new

Use Case 2: Subdomain Setup

verification: xyz789uvw456rst123
host: app
target: proxy.blink.new

Resulting Records:

  • TXT _blinkblink-verify=xyz789uvw456rst123
  • CNAME appproxy.blink.new

Use Case 3: SSL Certificate Validation (ACM)

acm_host: _abc123.example.com
acm_target: _abc123.acm-validations.aws

Resulting Records:

  • CNAME _abc123.example.com_abc123.acm-validations.aws

Use Case 4: Email Setup (Full Configuration)

mx1: mx1.mailprovider.com
mx2: mx2.mailprovider.com
spf: mailprovider.com
dkim_selector: blink
dkim_value: v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...
dmarc_email: [email protected]

Resulting Records:

  • MX @mx1.mailprovider.com (priority 10)
  • MX @mx2.mailprovider.com (priority 20)
  • SPFM @include:mailprovider.com
  • TXT blink._domainkeyv=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...
  • TXT _dmarcv=DMARC1; p=quarantine; rua=mailto:[email protected]

Complete Test Data Object

"testData": {
  "apex-domain": {
    "variables": {
      "verification": "abc123def456ghi789",
      "ip1": "75.2.60.5",
      "ip2": "99.83.231.61",
      "target": "proxy.blink.new"
    },
    "results": [
      {
        "type": "TXT",
        "host": "_blink",
        "ttl": 600,
        "data": "blink-verify=abc123def456ghi789"
      },
      {
        "type": "A",
        "host": "@",
        "ttl": 600,
        "pointsTo": "75.2.60.5"
      },
      {
        "type": "A",
        "host": "@",
        "ttl": 600,
        "pointsTo": "99.83.231.61"
      },
      {
        "type": "CNAME",
        "host": "www",
        "ttl": 600,
        "pointsTo": "proxy.blink.new"
      }
    ]
  },
  "subdomain": {
    "variables": {
      "verification": "xyz789uvw456rst123",
      "host": "app",
      "target": "proxy.blink.new"
    },
    "results": [
      {
        "type": "TXT",
        "host": "_blink",
        "ttl": 600,
        "data": "blink-verify=xyz789uvw456rst123"
      },
      {
        "type": "CNAME",
        "host": "app",
        "ttl": 600,
        "pointsTo": "proxy.blink.new"
      }
    ]
  },
  "acm-validation": {
    "variables": {
      "acm_host": "_abc123",
      "acm_target": "_abc123.acm-validations.aws"
    },
    "results": [
      {
        "type": "CNAME",
        "host": "_abc123",
        "ttl": 600,
        "pointsTo": "_abc123.acm-validations.aws"
      }
    ]
  },
  "email-setup": {
    "variables": {
      "mx1": "mx1.mailprovider.com",
      "mx2": "mx2.mailprovider.com",
      "spf": "mailprovider.com",
      "dkim_selector": "blink",
      "dkim_value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA",
      "dmarc_email": "[email protected]"
    },
    "results": [
      {
        "type": "MX",
        "host": "@",
        "ttl": 600,
        "pointsTo": "mx1.mailprovider.com",
        "priority": 10
      },
      {
        "type": "MX",
        "host": "@",
        "ttl": 600,
        "pointsTo": "mx2.mailprovider.com",
        "priority": 20
      },
      {
        "type": "SPFM",
        "host": "@",
        "spfRules": "include:mailprovider.com"
      },
      {
        "type": "TXT",
        "host": "blink._domainkey",
        "ttl": 600,
        "data": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA"
      },
      {
        "type": "TXT",
        "host": "_dmarc",
        "ttl": 600,
        "data": "v=DMARC1; p=quarantine; rua=mailto:[email protected]"
      }
    ]
  }
}

gyanaranjans and others added 2 commits January 8, 2026 14:46
This commit introduces a new Domain Connect template for Blink, enabling users to configure their domains for website hosting, subdomains, and email services. The template includes various DNS record configurations such as A, CNAME, MX, TXT, and SPF records.

## Type of change
- [x] New template

## How Has This Been Tested?
- [x] Schema validated using JSON Schema
- [x] Template functionality checked using Online Editor
- [x] Template is checked using template linter
- [x] Template file name follows the pattern `<providerId>.<serviceId>.json`

## Example variable values
- `ip1`: Primary A record IP
- `ip2`: Secondary A record IP
- `host`: Subdomain name
- `target`: CNAME destination
- `verification`: Domain verification token
- `mx1/mx2`: MX record servers
- `spf`: SPF include rule
- `dkim_selector/dkim_value`: DKIM key
- `dmarc_email`: DMARC reporting email address
@github-actions
Copy link

github-actions bot commented Jan 8, 2026

Linter OK:

Linter result for blink.new.domain-connect.json

@kerolasa kerolasa self-requested a review January 9, 2026 14:08
kerolasa
kerolasa previously approved these changes Jan 9, 2026
Copy link
Collaborator

@kerolasa kerolasa left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks pretty good. I left couple nits to the pull, please have a thought - or request a merge as-is.

@gyanaranjans
Copy link
Contributor Author

@kerolasa @pawel-kow Appreciate the review and approval. If everything now looks good from your side, would you mind merging this PR when you get a chance?

…iptions

This commit refines the variable descriptions in the Domain Connect template for Blink, enhancing clarity for users. Changes include specifying primary and optional secondary A record IPs, and updating the subdomain variable for better understanding.

## Type of change
- [x] Update to existing template

## How Has This Been Tested?
- [x] Schema validated using JSON Schema
- [x] Template functionality checked using Online Editor
- [x] Template is checked using template linter
- [x] Template file name follows the pattern `<providerId>.<serviceId>.json`
@kerolasa kerolasa requested review from kerolasa January 13, 2026 13:27
kerolasa
kerolasa previously approved these changes Jan 13, 2026
Copy link
Collaborator

@kerolasa kerolasa left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me

Copy link
Member

@pawel-kow pawel-kow left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm. thx

@pawel-kow pawel-kow added this pull request to the merge queue Jan 18, 2026
Merged via the queue into Domain-Connect:master with commit 9636607 Jan 18, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants