web-agent-bridge 3.3.0 → 3.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +12 -0
- package/README.ar.md +18 -0
- package/README.md +198 -1664
- package/bin/wab-init.js +223 -0
- package/examples/azure-dns-wab.js +83 -0
- package/examples/cloudflare-wab-dns.js +121 -0
- package/examples/cpanel-wab-dns.js +114 -0
- package/examples/dns-discovery-agent.js +166 -0
- package/examples/gcp-dns-wab.js +76 -0
- package/examples/governance-agent.js +169 -0
- package/examples/plesk-wab-dns.js +103 -0
- package/examples/route53-wab-dns.js +144 -0
- package/examples/safe-mode-agent.js +96 -0
- package/examples/wab-sign.js +74 -0
- package/examples/wab-verify.js +60 -0
- package/package.json +5 -5
- package/public/.well-known/wab.json +28 -0
- package/public/activate.html +368 -0
- package/public/adoption-metrics.html +188 -0
- package/public/api.html +1 -1
- package/public/azure-dns-integration.html +289 -0
- package/public/cloudflare-integration.html +380 -0
- package/public/cpanel-integration.html +398 -0
- package/public/css/styles.css +28 -0
- package/public/dashboard.html +1 -0
- package/public/dns.html +101 -172
- package/public/docs.html +1 -0
- package/public/gcp-dns-integration.html +318 -0
- package/public/growth.html +4 -2
- package/public/index.html +227 -31
- package/public/integrations.html +1 -1
- package/public/js/activate.js +145 -0
- package/public/js/auth-nav.js +34 -0
- package/public/js/dns.js +438 -0
- package/public/openapi.json +89 -0
- package/public/plesk-integration.html +375 -0
- package/public/premium.html +1 -1
- package/public/provider-onboarding.html +172 -0
- package/public/provider-sandbox.html +134 -0
- package/public/providers.html +359 -0
- package/public/registrar-integrations.html +141 -0
- package/public/robots.txt +12 -0
- package/public/route53-integration.html +531 -0
- package/public/shieldqr.html +231 -0
- package/public/sitemap.xml +6 -0
- package/public/wab-trust.html +200 -0
- package/public/wab-vs-protocols.html +210 -0
- package/public/whitepaper.html +449 -0
- package/sdk/auto-discovery.js +288 -0
- package/sdk/governance.js +262 -0
- package/sdk/index.js +13 -0
- package/sdk/package.json +2 -2
- package/sdk/safe-mode.js +221 -0
- package/server/index.js +144 -5
- package/server/migrations/007_governance.sql +106 -0
- package/server/migrations/008_plans.sql +144 -0
- package/server/migrations/009_shieldqr.sql +30 -0
- package/server/migrations/010_extended_trust.sql +33 -0
- package/server/models/adapters/mysql.js +1 -1
- package/server/models/adapters/postgresql.js +1 -1
- package/server/models/db.js +60 -1
- package/server/routes/admin-plans.js +76 -0
- package/server/routes/admin-premium.js +4 -2
- package/server/routes/admin-shieldqr.js +90 -0
- package/server/routes/admin-trust-monitor.js +83 -0
- package/server/routes/admin.js +289 -1
- package/server/routes/billing.js +16 -4
- package/server/routes/discovery.js +1933 -2
- package/server/routes/governance.js +208 -0
- package/server/routes/plans.js +33 -0
- package/server/routes/providers.js +650 -0
- package/server/routes/shieldqr.js +88 -0
- package/server/services/email.js +29 -0
- package/server/services/governance.js +466 -0
- package/server/services/plans.js +214 -0
- package/server/services/premium.js +1 -1
- package/server/services/provider-clients.js +740 -0
- package/server/services/shieldqr.js +322 -0
- package/server/services/ssl-inspector.js +42 -0
- package/server/services/ssl-monitor.js +167 -0
- package/server/services/stripe.js +18 -5
- package/server/services/vision.js +1 -1
- package/server/services/wab-crypto.js +178 -0
|
@@ -0,0 +1,375 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
6
|
+
<title>WAB DNS — Plesk Integration</title>
|
|
7
|
+
<link rel="stylesheet" href="/css/main.css">
|
|
8
|
+
<style>
|
|
9
|
+
body { font-family: system-ui, sans-serif; background: #0f172a; color: #e2e8f0; margin: 0; padding: 0; }
|
|
10
|
+
.page { max-width: 880px; margin: 0 auto; padding: 40px 20px 80px; }
|
|
11
|
+
h1 { font-size: 1.7rem; margin-bottom: 6px; }
|
|
12
|
+
.sub { color: #94a3b8; margin-bottom: 32px; font-size: .97rem; }
|
|
13
|
+
.card { background: #1e293b; border-radius: 10px; padding: 24px; margin-bottom: 24px; }
|
|
14
|
+
h2 { font-size: 1.1rem; margin: 0 0 14px; }
|
|
15
|
+
label { display: block; font-size: .85rem; color: #94a3b8; margin-bottom: 4px; margin-top: 14px; }
|
|
16
|
+
label:first-child { margin-top: 0; }
|
|
17
|
+
input[type=text], input[type=password], input[type=number] {
|
|
18
|
+
width: 100%; box-sizing: border-box; background: #0f172a; border: 1px solid #334155;
|
|
19
|
+
color: #e2e8f0; border-radius: 6px; padding: 9px 12px; font-size: .93rem;
|
|
20
|
+
}
|
|
21
|
+
input:focus { outline: 2px solid #6366f1; border-color: transparent; }
|
|
22
|
+
.row { display: flex; gap: 12px; }
|
|
23
|
+
.row > * { flex: 1; }
|
|
24
|
+
.actions { display: flex; gap: 10px; margin-top: 20px; flex-wrap: wrap; }
|
|
25
|
+
.btn { padding: 9px 20px; border-radius: 7px; border: none; cursor: pointer; font-size: .92rem; font-weight: 600; transition: opacity .15s; }
|
|
26
|
+
.btn:hover { opacity: .85; }
|
|
27
|
+
.btn:disabled { opacity: .45; cursor: not-allowed; }
|
|
28
|
+
.btn-enable { background: #06b6d4; color: #000; }
|
|
29
|
+
.btn-disable { background: #ef4444; color: #fff; }
|
|
30
|
+
.btn-verify { background: #6366f1; color: #fff; }
|
|
31
|
+
.btn-secondary { background: #334155; color: #e2e8f0; }
|
|
32
|
+
#statusBar { margin-top: 18px; min-height: 36px; padding: 10px 14px; border-radius: 7px; background: #0f172a; font-size: .88rem; color: #94a3b8; display: none; }
|
|
33
|
+
#statusBar.ok { display: block; color: #4ade80; border: 1px solid #166534; }
|
|
34
|
+
#statusBar.err { display: block; color: #f87171; border: 1px solid #7f1d1d; }
|
|
35
|
+
#statusBar.info { display: block; color: #93c5fd; border: 1px solid #1e3a5f; }
|
|
36
|
+
pre { background: #0f172a; border-radius: 7px; padding: 14px 16px; font-size: .82rem; color: #94a3b8; overflow-x: auto; white-space: pre-wrap; word-break: break-word; margin: 14px 0 0; }
|
|
37
|
+
code { background: #0f172a; padding: 1px 5px; border-radius: 4px; font-size: .88em; }
|
|
38
|
+
.tab-bar { display: flex; gap: 4px; margin-bottom: 14px; }
|
|
39
|
+
.tab { padding: 5px 14px; border-radius: 6px; cursor: pointer; font-size: .84rem; background: #0f172a; color: #94a3b8; border: 1px solid #334155; }
|
|
40
|
+
.tab.active { background: #6366f1; color: #fff; border-color: transparent; }
|
|
41
|
+
.tab-panel { display: none; }
|
|
42
|
+
.tab-panel.active { display: block; }
|
|
43
|
+
.step { display: flex; gap: 14px; margin-bottom: 18px; }
|
|
44
|
+
.step-num { flex-shrink: 0; width: 28px; height: 28px; border-radius: 50%; background: #334155; color: #e2e8f0; font-size: .82rem; font-weight: 700; display: flex; align-items: center; justify-content: center; }
|
|
45
|
+
.step-body { flex: 1; padding-top: 3px; }
|
|
46
|
+
.warning-box { background: #431407; border: 1px solid #9a3412; border-radius: 8px; padding: 12px 16px; font-size: .87rem; color: #fdba74; margin-bottom: 18px; }
|
|
47
|
+
a { color: #818cf8; }
|
|
48
|
+
</style>
|
|
49
|
+
</head>
|
|
50
|
+
<body>
|
|
51
|
+
<div class="page">
|
|
52
|
+
<h1>Plesk × WAB DNS Discovery</h1>
|
|
53
|
+
<p class="sub">
|
|
54
|
+
Enable or disable the WAB DNS Discovery TXT record on any Plesk-managed domain via the
|
|
55
|
+
<a href="https://docs.plesk.com/en-US/obsidian/api-rpc/" target="_blank" rel="noopener">Plesk REST API</a>.
|
|
56
|
+
</p>
|
|
57
|
+
|
|
58
|
+
<div class="warning-box">
|
|
59
|
+
⚠ <strong>Security note:</strong> Plesk credentials and host details are used only client-side to call the Plesk REST API directly.
|
|
60
|
+
Always use a dedicated <strong>API Key</strong> (Server → Tools & Settings → API Keys) instead of admin password.
|
|
61
|
+
</div>
|
|
62
|
+
|
|
63
|
+
<!-- ── STEP 1: credentials ── -->
|
|
64
|
+
<div class="card">
|
|
65
|
+
<h2>1. Plesk Server Credentials</h2>
|
|
66
|
+
<div class="row">
|
|
67
|
+
<div>
|
|
68
|
+
<label>Plesk Host (FQDN or IP)</label>
|
|
69
|
+
<input type="text" id="pkHost" placeholder="plesk.example.com">
|
|
70
|
+
</div>
|
|
71
|
+
<div>
|
|
72
|
+
<label>Port</label>
|
|
73
|
+
<input type="number" id="pkPort" value="8443" min="1" max="65535" style="max-width:120px">
|
|
74
|
+
</div>
|
|
75
|
+
</div>
|
|
76
|
+
<label>Authentication mode</label>
|
|
77
|
+
<div style="display:flex;gap:14px;margin-top:6px;font-size:.9rem;color:#cbd5e1">
|
|
78
|
+
<label style="margin:0"><input type="radio" name="pkAuthMode" value="apikey" checked> API Key (recommended)</label>
|
|
79
|
+
<label style="margin:0"><input type="radio" name="pkAuthMode" value="basic"> Username + Password</label>
|
|
80
|
+
</div>
|
|
81
|
+
<div id="pkApiKeyBlock">
|
|
82
|
+
<label>Plesk API Key</label>
|
|
83
|
+
<input type="password" id="pkApiKey" placeholder="Paste API key" autocomplete="off">
|
|
84
|
+
</div>
|
|
85
|
+
<div id="pkBasicBlock" style="display:none">
|
|
86
|
+
<div class="row">
|
|
87
|
+
<div>
|
|
88
|
+
<label>Username</label>
|
|
89
|
+
<input type="text" id="pkUser" placeholder="admin" autocomplete="off">
|
|
90
|
+
</div>
|
|
91
|
+
<div>
|
|
92
|
+
<label>Password</label>
|
|
93
|
+
<input type="password" id="pkPass" autocomplete="off">
|
|
94
|
+
</div>
|
|
95
|
+
</div>
|
|
96
|
+
</div>
|
|
97
|
+
</div>
|
|
98
|
+
|
|
99
|
+
<!-- ── STEP 2: domain ── -->
|
|
100
|
+
<div class="card">
|
|
101
|
+
<h2>2. Domain</h2>
|
|
102
|
+
<div class="row">
|
|
103
|
+
<div>
|
|
104
|
+
<label>Domain</label>
|
|
105
|
+
<input type="text" id="pkDomain" placeholder="example.com">
|
|
106
|
+
</div>
|
|
107
|
+
<div>
|
|
108
|
+
<label>Endpoint URL <span style="color:#64748b;font-weight:400">(blank = auto)</span></label>
|
|
109
|
+
<input type="text" id="pkEndpoint" placeholder="https://example.com/.well-known/wab.json">
|
|
110
|
+
</div>
|
|
111
|
+
</div>
|
|
112
|
+
</div>
|
|
113
|
+
|
|
114
|
+
<!-- ── STEP 3: actions ── -->
|
|
115
|
+
<div class="card">
|
|
116
|
+
<h2>3. Actions</h2>
|
|
117
|
+
<div class="actions">
|
|
118
|
+
<button class="btn btn-enable" id="btnEnable" onclick="pkAction('enable')">✓ Enable WAB Discovery</button>
|
|
119
|
+
<button class="btn btn-disable" id="btnDisable" onclick="pkAction('disable')">✗ Disable WAB Discovery</button>
|
|
120
|
+
<button class="btn btn-verify" id="btnVerify" onclick="pkVerify()">⟳ Verify Status</button>
|
|
121
|
+
<button class="btn btn-secondary" onclick="window.open('/provider-sandbox','_blank')">Open Sandbox</button>
|
|
122
|
+
</div>
|
|
123
|
+
<div id="statusBar"></div>
|
|
124
|
+
<pre id="jsonOut" style="display:none"></pre>
|
|
125
|
+
</div>
|
|
126
|
+
|
|
127
|
+
<!-- ── HOW IT WORKS ── -->
|
|
128
|
+
<div class="card">
|
|
129
|
+
<h2>How it works</h2>
|
|
130
|
+
<div class="step"><div class="step-num">1</div><div class="step-body">Fetch WAB record template (<code>GET /api/discovery/provider/record-template</code>) for TXT value.</div></div>
|
|
131
|
+
<div class="step"><div class="step-num">2</div><div class="step-body">Resolve the Plesk site ID via <code>GET /api/v2/domains?name=…</code>.</div></div>
|
|
132
|
+
<div class="step"><div class="step-num">3</div><div class="step-body">Call <code>GET /api/v2/dns/records?domain=…</code> to look up existing <code>_wab</code> TXT records.</div></div>
|
|
133
|
+
<div class="step"><div class="step-num">4</div><div class="step-body"><strong>Enable:</strong> if missing, <code>POST /api/v2/dns/records</code>; if exists with different value, <code>DELETE</code> + <code>POST</code> (Plesk doesn't support TXT update in place).<br>
|
|
134
|
+
<strong>Disable:</strong> <code>DELETE /api/v2/dns/records/{id}</code>.</div></div>
|
|
135
|
+
<div class="step"><div class="step-num">5</div><div class="step-body">Confirm via <code>/api/discovery/provider/status</code>. Run <code>dns-on</code> for the domain if updates aren't propagating.</div></div>
|
|
136
|
+
</div>
|
|
137
|
+
|
|
138
|
+
<!-- ── CODE SNIPPETS ── -->
|
|
139
|
+
<div class="card">
|
|
140
|
+
<h2>Code Snippets</h2>
|
|
141
|
+
<div class="tab-bar">
|
|
142
|
+
<div class="tab active" onclick="switchTab('nodejs')">Node.js</div>
|
|
143
|
+
<div class="tab" onclick="switchTab('curl')">cURL</div>
|
|
144
|
+
<div class="tab" onclick="switchTab('python')">Python</div>
|
|
145
|
+
</div>
|
|
146
|
+
<div id="tab-nodejs" class="tab-panel active">
|
|
147
|
+
<pre>// npm install node-fetch@2
|
|
148
|
+
const fetch = require('node-fetch');
|
|
149
|
+
|
|
150
|
+
const HOST = 'plesk.example.com';
|
|
151
|
+
const PORT = 8443;
|
|
152
|
+
const APIKEY = process.env.PLESK_API_KEY;
|
|
153
|
+
const DOMAIN = 'example.com';
|
|
154
|
+
const TXT_VAL = `v=wab1; endpoint=https://${DOMAIN}/.well-known/wab.json`;
|
|
155
|
+
|
|
156
|
+
const headers = { 'X-API-Key': APIKEY, 'Content-Type': 'application/json' };
|
|
157
|
+
const base = `https://${HOST}:${PORT}/api/v2`;
|
|
158
|
+
|
|
159
|
+
async function getDomainId() {
|
|
160
|
+
const r = await fetch(`${base}/domains?name=${DOMAIN}`, { headers });
|
|
161
|
+
const j = await r.json();
|
|
162
|
+
return j[0] && j[0].id;
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
async function listWabRecords() {
|
|
166
|
+
const r = await fetch(`${base}/dns/records?domain=${DOMAIN}&type=TXT`, { headers });
|
|
167
|
+
const j = await r.json();
|
|
168
|
+
return (j || []).filter(rec => rec.host === `_wab.${DOMAIN}.` || rec.host === `_wab.${DOMAIN}`);
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
async function enableWAB() {
|
|
172
|
+
const records = await listWabRecords();
|
|
173
|
+
if (records.length) {
|
|
174
|
+
// remove old, then add new (Plesk REST API doesn't allow in-place TXT edit)
|
|
175
|
+
await fetch(`${base}/dns/records/${records[0].id}`, { method: 'DELETE', headers });
|
|
176
|
+
}
|
|
177
|
+
await fetch(`${base}/dns/records`, {
|
|
178
|
+
method: 'POST', headers,
|
|
179
|
+
body: JSON.stringify({ domain: DOMAIN, type: 'TXT', host: `_wab.${DOMAIN}`, value: TXT_VAL })
|
|
180
|
+
});
|
|
181
|
+
console.log('WAB Discovery ENABLED');
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
async function disableWAB() {
|
|
185
|
+
const records = await listWabRecords();
|
|
186
|
+
if (!records.length) return console.log('Already disabled.');
|
|
187
|
+
await fetch(`${base}/dns/records/${records[0].id}`, { method: 'DELETE', headers });
|
|
188
|
+
console.log('WAB Discovery DISABLED');
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
enableWAB().catch(console.error);
|
|
192
|
+
</pre>
|
|
193
|
+
</div>
|
|
194
|
+
<div id="tab-curl" class="tab-panel">
|
|
195
|
+
<pre># Plesk API Key auth
|
|
196
|
+
KEY="your-api-key"
|
|
197
|
+
HOST="plesk.example.com:8443"
|
|
198
|
+
DOMAIN="example.com"
|
|
199
|
+
TXT='v=wab1; endpoint=https://example.com/.well-known/wab.json'
|
|
200
|
+
|
|
201
|
+
# 1. List existing _wab TXT records
|
|
202
|
+
curl -sk -H "X-API-Key: $KEY" "https://$HOST/api/v2/dns/records?domain=$DOMAIN&type=TXT"
|
|
203
|
+
|
|
204
|
+
# 2. Add (enable)
|
|
205
|
+
curl -sk -X POST -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
|
|
206
|
+
"https://$HOST/api/v2/dns/records" \
|
|
207
|
+
-d "{\"domain\":\"$DOMAIN\",\"type\":\"TXT\",\"host\":\"_wab.$DOMAIN\",\"value\":\"$TXT\"}"
|
|
208
|
+
|
|
209
|
+
# 3. Delete (disable) — replace REC_ID
|
|
210
|
+
curl -sk -X DELETE -H "X-API-Key: $KEY" "https://$HOST/api/v2/dns/records/REC_ID"
|
|
211
|
+
</pre>
|
|
212
|
+
</div>
|
|
213
|
+
<div id="tab-python" class="tab-panel">
|
|
214
|
+
<pre>import os, requests
|
|
215
|
+
|
|
216
|
+
HOST = 'plesk.example.com'
|
|
217
|
+
PORT = 8443
|
|
218
|
+
APIKEY = os.environ['PLESK_API_KEY']
|
|
219
|
+
DOMAIN = 'example.com'
|
|
220
|
+
TXT_VAL = f'v=wab1; endpoint=https://{DOMAIN}/.well-known/wab.json'
|
|
221
|
+
HEADERS = {'X-API-Key': APIKEY, 'Content-Type': 'application/json'}
|
|
222
|
+
BASE = f'https://{HOST}:{PORT}/api/v2'
|
|
223
|
+
|
|
224
|
+
def list_wab():
|
|
225
|
+
r = requests.get(f'{BASE}/dns/records', params={'domain': DOMAIN, 'type': 'TXT'}, headers=HEADERS, verify=False)
|
|
226
|
+
return [rec for rec in r.json() if rec['host'].rstrip('.') == f'_wab.{DOMAIN}']
|
|
227
|
+
|
|
228
|
+
def enable_wab():
|
|
229
|
+
for rec in list_wab():
|
|
230
|
+
requests.delete(f'{BASE}/dns/records/{rec["id"]}', headers=HEADERS, verify=False)
|
|
231
|
+
requests.post(f'{BASE}/dns/records',
|
|
232
|
+
json={'domain': DOMAIN, 'type': 'TXT', 'host': f'_wab.{DOMAIN}', 'value': TXT_VAL},
|
|
233
|
+
headers=HEADERS, verify=False)
|
|
234
|
+
print('WAB ENABLED')
|
|
235
|
+
|
|
236
|
+
def disable_wab():
|
|
237
|
+
recs = list_wab()
|
|
238
|
+
if not recs: return print('Already disabled')
|
|
239
|
+
requests.delete(f'{BASE}/dns/records/{recs[0]["id"]}', headers=HEADERS, verify=False)
|
|
240
|
+
print('WAB DISABLED')
|
|
241
|
+
|
|
242
|
+
enable_wab()
|
|
243
|
+
</pre>
|
|
244
|
+
</div>
|
|
245
|
+
</div>
|
|
246
|
+
|
|
247
|
+
<p style="text-align:center;margin-top:30px;font-size:.85rem;color:#475569">
|
|
248
|
+
<a href="/provider-onboarding">← Provider Onboarding</a> ·
|
|
249
|
+
<a href="/cloudflare-integration">Cloudflare</a> ·
|
|
250
|
+
<a href="/cpanel-integration">cPanel</a> ·
|
|
251
|
+
<a href="/route53-integration">Route 53</a> ·
|
|
252
|
+
<a href="/dns">DNS Discovery</a>
|
|
253
|
+
</p>
|
|
254
|
+
</div>
|
|
255
|
+
|
|
256
|
+
<script>
|
|
257
|
+
function switchTab(name) {
|
|
258
|
+
document.querySelectorAll('.tab').forEach(t => t.classList.remove('active'));
|
|
259
|
+
document.querySelectorAll('.tab-panel').forEach(p => p.classList.remove('active'));
|
|
260
|
+
document.querySelector(`#tab-${name}`).classList.add('active');
|
|
261
|
+
event.target.classList.add('active');
|
|
262
|
+
}
|
|
263
|
+
|
|
264
|
+
document.querySelectorAll('input[name=pkAuthMode]').forEach(r =>
|
|
265
|
+
r.addEventListener('change', e => {
|
|
266
|
+
document.getElementById('pkApiKeyBlock').style.display = e.target.value === 'apikey' ? '' : 'none';
|
|
267
|
+
document.getElementById('pkBasicBlock').style.display = e.target.value === 'basic' ? '' : 'none';
|
|
268
|
+
})
|
|
269
|
+
);
|
|
270
|
+
|
|
271
|
+
function setStatus(msg, type) { const b = document.getElementById('statusBar'); b.textContent = msg; b.className = type; }
|
|
272
|
+
function showJson(o) { const p = document.getElementById('jsonOut'); p.textContent = JSON.stringify(o, null, 2); p.style.display = 'block'; }
|
|
273
|
+
|
|
274
|
+
function getInputs() {
|
|
275
|
+
const mode = document.querySelector('input[name=pkAuthMode]:checked').value;
|
|
276
|
+
return {
|
|
277
|
+
host: document.getElementById('pkHost').value.trim().replace(/^https?:\/\//, '').replace(/\/$/, ''),
|
|
278
|
+
port: document.getElementById('pkPort').value.trim() || '8443',
|
|
279
|
+
mode,
|
|
280
|
+
apikey: document.getElementById('pkApiKey').value.trim(),
|
|
281
|
+
user: document.getElementById('pkUser').value.trim(),
|
|
282
|
+
pass: document.getElementById('pkPass').value.trim(),
|
|
283
|
+
domain: document.getElementById('pkDomain').value.trim().toLowerCase().replace(/^https?:\/\//, '').replace(/\/$/, ''),
|
|
284
|
+
ep: document.getElementById('pkEndpoint').value.trim(),
|
|
285
|
+
};
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
function pkHeaders(inp) {
|
|
289
|
+
const h = { 'Content-Type': 'application/json' };
|
|
290
|
+
if (inp.mode === 'apikey') h['X-API-Key'] = inp.apikey;
|
|
291
|
+
else h['Authorization'] = 'Basic ' + btoa(`${inp.user}:${inp.pass}`);
|
|
292
|
+
return h;
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
async function pkRequest(inp, method, path, body) {
|
|
296
|
+
const url = `https://${inp.host}:${inp.port}/api/v2${path}`;
|
|
297
|
+
const opts = { method, headers: pkHeaders(inp), mode: 'cors' };
|
|
298
|
+
if (body) opts.body = JSON.stringify(body);
|
|
299
|
+
const r = await fetch(url, opts);
|
|
300
|
+
const t = await r.text();
|
|
301
|
+
if (!r.ok) throw new Error(`Plesk ${r.status}: ${t.slice(0, 300)}`);
|
|
302
|
+
try { return JSON.parse(t); } catch { return t; }
|
|
303
|
+
}
|
|
304
|
+
|
|
305
|
+
async function pkAction(action) {
|
|
306
|
+
const inp = getInputs();
|
|
307
|
+
if (!inp.host) return setStatus('Please enter Plesk host.', 'err');
|
|
308
|
+
if (!inp.domain) return setStatus('Please enter the domain.', 'err');
|
|
309
|
+
if (inp.mode === 'apikey' && !inp.apikey) return setStatus('Please enter Plesk API Key.', 'err');
|
|
310
|
+
if (inp.mode === 'basic' && (!inp.user || !inp.pass)) return setStatus('Please enter username and password.', 'err');
|
|
311
|
+
|
|
312
|
+
document.getElementById('btnEnable').disabled = true;
|
|
313
|
+
document.getElementById('btnDisable').disabled = true;
|
|
314
|
+
try {
|
|
315
|
+
const ep = inp.ep || `https://${inp.domain}/.well-known/wab.json`;
|
|
316
|
+
setStatus('Fetching WAB record template…', 'info');
|
|
317
|
+
const tpl = await (await fetch(`/api/discovery/provider/record-template?domain=${encodeURIComponent(inp.domain)}&endpoint=${encodeURIComponent(ep)}`)).json();
|
|
318
|
+
const txtVal = tpl.record && tpl.record.value;
|
|
319
|
+
if (!txtVal) throw new Error('Could not fetch WAB record template.');
|
|
320
|
+
|
|
321
|
+
setStatus('Listing existing _wab TXT records…', 'info');
|
|
322
|
+
const all = await pkRequest(inp, 'GET', `/dns/records?domain=${encodeURIComponent(inp.domain)}&type=TXT`);
|
|
323
|
+
const existing = (all || []).filter(rec => {
|
|
324
|
+
const h = (rec.host || '').replace(/\.$/, '');
|
|
325
|
+
return h === `_wab.${inp.domain}` || h === '_wab';
|
|
326
|
+
});
|
|
327
|
+
|
|
328
|
+
if (action === 'enable') {
|
|
329
|
+
// Plesk doesn't support in-place TXT edit; delete then create
|
|
330
|
+
for (const rec of existing) {
|
|
331
|
+
setStatus(`Deleting old record id=${rec.id}…`, 'info');
|
|
332
|
+
await pkRequest(inp, 'DELETE', `/dns/records/${rec.id}`);
|
|
333
|
+
}
|
|
334
|
+
setStatus('Creating new _wab TXT record…', 'info');
|
|
335
|
+
const out = await pkRequest(inp, 'POST', '/dns/records', {
|
|
336
|
+
domain: inp.domain, type: 'TXT', host: `_wab.${inp.domain}`, value: txtVal
|
|
337
|
+
});
|
|
338
|
+
setStatus(`✓ _wab TXT record created for ${inp.domain}. WAB Discovery is ENABLED.`, 'ok');
|
|
339
|
+
showJson(out);
|
|
340
|
+
} else {
|
|
341
|
+
if (!existing.length) {
|
|
342
|
+
setStatus(`No _wab TXT record found for ${inp.domain} — already disabled.`, 'ok');
|
|
343
|
+
showJson({ note: 'no record found', domain: inp.domain });
|
|
344
|
+
return;
|
|
345
|
+
}
|
|
346
|
+
for (const rec of existing) {
|
|
347
|
+
setStatus(`Deleting record id=${rec.id}…`, 'info');
|
|
348
|
+
await pkRequest(inp, 'DELETE', `/dns/records/${rec.id}`);
|
|
349
|
+
}
|
|
350
|
+
setStatus(`✓ _wab TXT record deleted for ${inp.domain}. WAB Discovery is DISABLED.`, 'ok');
|
|
351
|
+
showJson({ deleted: existing.map(r => r.id), domain: inp.domain });
|
|
352
|
+
}
|
|
353
|
+
} catch (err) {
|
|
354
|
+
setStatus(`Error: ${err.message}`, 'err');
|
|
355
|
+
} finally {
|
|
356
|
+
document.getElementById('btnEnable').disabled = false;
|
|
357
|
+
document.getElementById('btnDisable').disabled = false;
|
|
358
|
+
}
|
|
359
|
+
}
|
|
360
|
+
|
|
361
|
+
async function pkVerify() {
|
|
362
|
+
const { domain } = getInputs();
|
|
363
|
+
if (!domain) return setStatus('Please enter a domain.', 'err');
|
|
364
|
+
setStatus('Checking WAB status…', 'info');
|
|
365
|
+
try {
|
|
366
|
+
const j = await (await fetch(`/api/discovery/provider/status?domain=${encodeURIComponent(domain)}`)).json();
|
|
367
|
+
if (j.status === 'enabled') setStatus(`✓ ${domain} — ENABLED.`, 'ok');
|
|
368
|
+
else if (j.status === 'partial') setStatus(`⚠ ${domain} — partial (DNS ok, endpoint issue).`, 'info');
|
|
369
|
+
else setStatus(`✗ ${domain} — DISABLED.`, 'err');
|
|
370
|
+
showJson(j);
|
|
371
|
+
} catch (err) { setStatus(`Verify error: ${err.message}`, 'err'); }
|
|
372
|
+
}
|
|
373
|
+
</script>
|
|
374
|
+
</body>
|
|
375
|
+
</html>
|
package/public/premium.html
CHANGED
|
@@ -33,7 +33,7 @@
|
|
|
33
33
|
<a href="/dashboard" class="btn btn-ghost" data-wab-auth="signed-in" style="display:none">Dashboard</a>
|
|
34
34
|
<a href="/register" class="btn btn-primary btn-sm" data-wab-auth="guest">Get Started</a>
|
|
35
35
|
</div>
|
|
36
|
-
<button class="mobile-menu-btn"
|
|
36
|
+
<button class="mobile-menu-btn" >☰</button>
|
|
37
37
|
</div>
|
|
38
38
|
</nav>
|
|
39
39
|
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="en" dir="ltr">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
+
<title>WAB DNS Discovery Provider Onboarding</title>
|
|
7
|
+
<meta name="description" content="Integrate WAB DNS Discovery into DNS providers and registrars with one-click enable/disable flow.">
|
|
8
|
+
<link rel="stylesheet" href="/css/styles.css?v=3.3.0">
|
|
9
|
+
<style>
|
|
10
|
+
body { background:#0a1222; color:#e6edf8; }
|
|
11
|
+
.hero { padding:110px 24px 40px; text-align:center; }
|
|
12
|
+
.hero h1 { font-size:clamp(1.9rem,4vw,3rem); margin-bottom:10px; }
|
|
13
|
+
.hero p { color:#9fb1d3; max-width:820px; margin:0 auto; line-height:1.7; }
|
|
14
|
+
.wrap { max-width:1100px; margin:0 auto; padding:0 20px 70px; }
|
|
15
|
+
.grid { display:grid; gap:14px; grid-template-columns:repeat(auto-fit,minmax(280px,1fr)); }
|
|
16
|
+
.card { background:linear-gradient(180deg,rgba(17,24,39,.9),rgba(12,18,31,.96)); border:1px solid rgba(148,163,184,.2); border-radius:14px; padding:16px; }
|
|
17
|
+
.card h3 { margin:0 0 8px; color:#fcd34d; }
|
|
18
|
+
.card p, .card li { color:#c7d2ea; line-height:1.65; font-size:.93rem; }
|
|
19
|
+
.card ul { margin:6px 0 0 20px; }
|
|
20
|
+
.badge { display:inline-block; margin:6px 0; padding:4px 9px; border-radius:999px; font-size:.73rem; font-weight:700; color:#fde68a; border:1px solid rgba(250,204,21,.45); background:rgba(250,204,21,.12); }
|
|
21
|
+
pre, code { font-family:Consolas, Menlo, Monaco, monospace; }
|
|
22
|
+
pre { background:#020617; border:1px solid rgba(148,163,184,.25); border-radius:10px; padding:11px; color:#c4b5fd; overflow:auto; font-size:.82rem; line-height:1.5; }
|
|
23
|
+
.actions { display:flex; flex-wrap:wrap; gap:10px; margin-top:12px; }
|
|
24
|
+
.actions a { text-decoration:none; }
|
|
25
|
+
.btn-mini { display:inline-block; padding:8px 12px; border-radius:9px; font-size:.83rem; font-weight:700; }
|
|
26
|
+
.btn-primary { background:linear-gradient(135deg,#f59e0b,#b45309); color:#fff; }
|
|
27
|
+
.btn-secondary { background:rgba(148,163,184,.16); border:1px solid rgba(148,163,184,.35); color:#e6edf8; }
|
|
28
|
+
</style>
|
|
29
|
+
</head>
|
|
30
|
+
<body>
|
|
31
|
+
<section class="hero">
|
|
32
|
+
<h1>Provider Onboarding: One-Click WAB DNS Discovery</h1>
|
|
33
|
+
<p>
|
|
34
|
+
Add WAB DNS Discovery to your DNS platform or registrar panel so domain owners can enable or disable AI discoverability
|
|
35
|
+
with a single toggle, just like SSL activation.
|
|
36
|
+
</p>
|
|
37
|
+
</section>
|
|
38
|
+
|
|
39
|
+
<div class="wrap">
|
|
40
|
+
<div class="grid">
|
|
41
|
+
<div class="card">
|
|
42
|
+
<h3>1) Fetch Protocol Manifest</h3>
|
|
43
|
+
<span class="badge">Machine contract</span>
|
|
44
|
+
<pre>GET /api/discovery/provider/manifest</pre>
|
|
45
|
+
<p>Use this endpoint to lock integration against a stable protocol definition.</p>
|
|
46
|
+
</div>
|
|
47
|
+
|
|
48
|
+
<div class="card">
|
|
49
|
+
<h3>2) Build TXT Record Template</h3>
|
|
50
|
+
<span class="badge">Per-domain payload</span>
|
|
51
|
+
<pre>GET /api/discovery/provider/record-template?domain=example.com</pre>
|
|
52
|
+
<p>Returns ready-to-write values for DNS API calls in your enable-toggle flow.</p>
|
|
53
|
+
</div>
|
|
54
|
+
|
|
55
|
+
<div class="card">
|
|
56
|
+
<h3>3) Verify Status</h3>
|
|
57
|
+
<span class="badge">UI state source</span>
|
|
58
|
+
<pre>GET /api/discovery/provider/status?domain=example.com</pre>
|
|
59
|
+
<p>Map status to your UI toggle badges:</p>
|
|
60
|
+
<ul>
|
|
61
|
+
<li>enabled: DNS + endpoint verified</li>
|
|
62
|
+
<li>partial: DNS found, endpoint issue</li>
|
|
63
|
+
<li>disabled: no valid TXT record</li>
|
|
64
|
+
</ul>
|
|
65
|
+
</div>
|
|
66
|
+
|
|
67
|
+
<div class="card">
|
|
68
|
+
<h3>4) Batch Verification + Callback</h3>
|
|
69
|
+
<span class="badge">Registrar dashboards</span>
|
|
70
|
+
<pre>POST /api/discovery/provider/verify-batch
|
|
71
|
+
{
|
|
72
|
+
"domains": ["example.com", "shop.example.com"],
|
|
73
|
+
"include_agent_run": false,
|
|
74
|
+
"callback_url": "https://provider.example/webhooks/wab",
|
|
75
|
+
"callback_secret": "shared-secret"
|
|
76
|
+
}</pre>
|
|
77
|
+
<p>
|
|
78
|
+
Optional callback pushes final result to your webhook endpoint with request id and optional HMAC signature.
|
|
79
|
+
</p>
|
|
80
|
+
</div>
|
|
81
|
+
|
|
82
|
+
<div class="card">
|
|
83
|
+
<h3>5) Webhook Signature Verification</h3>
|
|
84
|
+
<span class="badge">Security</span>
|
|
85
|
+
<p>
|
|
86
|
+
Verify the <code>x-wab-signature</code> header on your callback endpoint to confirm the request came from WAB.
|
|
87
|
+
The signature is <code>HMAC-SHA256(requestBody, callbackSecret)</code> encoded as hex.
|
|
88
|
+
</p>
|
|
89
|
+
<p><strong>Node.js</strong></p>
|
|
90
|
+
<pre>const crypto = require('crypto');
|
|
91
|
+
|
|
92
|
+
function verifyWabSignature(rawBody, receivedSig, secret) {
|
|
93
|
+
const expected = crypto
|
|
94
|
+
.createHmac('sha256', secret)
|
|
95
|
+
.update(rawBody) // raw Buffer or string
|
|
96
|
+
.digest('hex');
|
|
97
|
+
// constant-time compare to prevent timing attacks
|
|
98
|
+
return crypto.timingSafeEqual(
|
|
99
|
+
Buffer.from(expected, 'utf8'),
|
|
100
|
+
Buffer.from(receivedSig, 'utf8')
|
|
101
|
+
);
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
// Express example
|
|
105
|
+
app.post('/webhooks/wab', express.raw({ type: '*/*' }), (req, res) => {
|
|
106
|
+
const sig = req.headers['x-wab-signature'];
|
|
107
|
+
if (!verifyWabSignature(req.body, sig, process.env.WAB_CALLBACK_SECRET)) {
|
|
108
|
+
return res.status(401).send('Invalid signature');
|
|
109
|
+
}
|
|
110
|
+
const payload = JSON.parse(req.body.toString());
|
|
111
|
+
// … process payload
|
|
112
|
+
res.sendStatus(200);
|
|
113
|
+
});</pre>
|
|
114
|
+
<p><strong>Python (Flask)</strong></p>
|
|
115
|
+
<pre>import hmac, hashlib
|
|
116
|
+
from flask import Flask, request, abort
|
|
117
|
+
|
|
118
|
+
app = Flask(__name__)
|
|
119
|
+
WAB_SECRET = os.environ['WAB_CALLBACK_SECRET']
|
|
120
|
+
|
|
121
|
+
@app.route('/webhooks/wab', methods=['POST'])
|
|
122
|
+
def wab_webhook():
|
|
123
|
+
sig = request.headers.get('x-wab-signature', '')
|
|
124
|
+
expected = hmac.new(
|
|
125
|
+
WAB_SECRET.encode(), request.data, hashlib.sha256
|
|
126
|
+
).hexdigest()
|
|
127
|
+
if not hmac.compare_digest(expected, sig):
|
|
128
|
+
abort(401)
|
|
129
|
+
payload = request.get_json(force=True)
|
|
130
|
+
# … process payload
|
|
131
|
+
return '', 200</pre>
|
|
132
|
+
</div>
|
|
133
|
+
|
|
134
|
+
<div class="card">
|
|
135
|
+
<h3>Enable/Disable Flow</h3>
|
|
136
|
+
<span class="badge">One-click UX</span>
|
|
137
|
+
<ul>
|
|
138
|
+
<li>Enable: write TXT, verify, show enabled</li>
|
|
139
|
+
<li>Disable: delete TXT, verify, show disabled</li>
|
|
140
|
+
<li>Retry verification until propagation converges</li>
|
|
141
|
+
</ul>
|
|
142
|
+
</div>
|
|
143
|
+
|
|
144
|
+
<div class="card">
|
|
145
|
+
<h3>Integration Endpoints</h3>
|
|
146
|
+
<pre>/api/discovery/provider/manifest
|
|
147
|
+
/api/discovery/provider/record-template
|
|
148
|
+
/api/discovery/provider/enable-plan
|
|
149
|
+
/api/discovery/provider/status
|
|
150
|
+
/api/discovery/provider/verify-batch</pre>
|
|
151
|
+
<div class="actions">
|
|
152
|
+
<a class="btn-mini btn-primary" href="/api/discovery/provider/manifest" target="_blank" rel="noopener">Open Manifest</a>
|
|
153
|
+
<a class="btn-mini btn-secondary" href="/api/discovery/provider/record-template?domain=webagentbridge.com" target="_blank" rel="noopener">Open Template Example</a>
|
|
154
|
+
<a class="btn-mini btn-secondary" href="/provider-sandbox">Open Provider Sandbox</a>
|
|
155
|
+
<a class="btn-mini btn-primary" href="/cloudflare-integration">Cloudflare One-Click</a>
|
|
156
|
+
<a class="btn-mini btn-primary" href="/cpanel-integration">cPanel One-Click</a>
|
|
157
|
+
<a class="btn-mini btn-primary" href="/route53-integration">Route 53 One-Click</a>
|
|
158
|
+
<a class="btn-mini btn-primary" href="/plesk-integration">Plesk One-Click</a>
|
|
159
|
+
<a class="btn-mini btn-primary" href="/gcp-dns-integration">Google Cloud DNS</a>
|
|
160
|
+
<a class="btn-mini btn-primary" href="/azure-dns-integration">Azure DNS One-Click</a>
|
|
161
|
+
<a class="btn-mini btn-primary" href="/registrar-integrations">GoDaddy / Namecheap CLI</a>
|
|
162
|
+
<a class="btn-mini btn-secondary" href="/adoption-metrics">Adoption Metrics</a>
|
|
163
|
+
<a class="btn-mini btn-primary" href="/wab-trust">Trust Layer (v1.3)</a>
|
|
164
|
+
<a class="btn-mini btn-secondary" href="/wab-vs-protocols">WAB vs Other Protocols</a>
|
|
165
|
+
<a class="btn-mini btn-secondary" href="/downloads/wab-dns-provider.postman_collection.json" target="_blank" rel="noopener">Download Postman Collection</a>
|
|
166
|
+
<a class="btn-mini btn-secondary" href="/dns">Open DNS Page</a>
|
|
167
|
+
</div>
|
|
168
|
+
</div>
|
|
169
|
+
</div>
|
|
170
|
+
</div>
|
|
171
|
+
</body>
|
|
172
|
+
</html>
|