web-agent-bridge 3.4.0 → 3.8.1
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 +84 -84
- package/README.ar.md +1563 -1304
- package/README.md +137 -298
- package/bin/agent-runner.js +474 -474
- package/bin/cli.js +237 -237
- package/bin/wab-init.js +244 -223
- package/bin/wab.js +80 -80
- package/examples/azure-dns-wab.js +83 -83
- package/examples/bidi-agent.js +119 -119
- package/examples/cloudflare-wab-dns.js +121 -121
- package/examples/cpanel-wab-dns.js +114 -114
- package/examples/cross-site-agent.js +91 -91
- package/examples/dns-discovery-agent.js +166 -166
- package/examples/gcp-dns-wab.js +76 -76
- package/examples/governance-agent.js +169 -169
- package/examples/mcp-agent.js +94 -94
- package/examples/next-app-router/README.md +44 -44
- package/examples/plesk-wab-dns.js +103 -103
- package/examples/puppeteer-agent.js +108 -108
- package/examples/route53-wab-dns.js +144 -144
- package/examples/saas-dashboard/README.md +55 -55
- package/examples/safe-mode-agent.js +96 -96
- package/examples/self-discovery.js +106 -0
- package/examples/shopify-hydrogen/README.md +74 -74
- package/examples/vision-agent.js +171 -171
- package/examples/wab-sign.js +74 -74
- package/examples/wab-verify.js +60 -60
- package/examples/wordpress-elementor/README.md +77 -77
- package/package.json +93 -93
- package/public/.well-known/agent-tools.json +180 -180
- package/public/.well-known/ai-assets.json +59 -59
- package/public/.well-known/security.txt +8 -8
- package/public/.well-known/wab.json +28 -28
- package/public/activate.html +448 -368
- package/public/adopt.html +236 -0
- package/public/adoption-metrics.html +188 -188
- package/public/agent-workspace.html +359 -349
- package/public/ai.html +198 -198
- package/public/api.html +397 -413
- package/public/azure-dns-integration.html +289 -289
- package/public/browser.html +486 -486
- package/public/cloudflare-integration.html +380 -380
- package/public/commander-dashboard.html +243 -243
- package/public/cookies.html +210 -210
- package/public/cpanel-integration.html +398 -398
- package/public/css/agent-workspace.css +1713 -1713
- package/public/css/premium.css +317 -317
- package/public/css/styles.css +1401 -1263
- package/public/dashboard-shieldlink.html +295 -0
- package/public/dashboard.html +711 -707
- package/public/dns.html +436 -436
- package/public/docs.html +588 -588
- package/public/enterprise-mesh.ar.html +80 -0
- package/public/enterprise-mesh.html +81 -0
- package/public/feed.xml +89 -89
- package/public/gcp-dns-integration.html +318 -318
- package/public/governance.ar.html +70 -0
- package/public/governance.html +69 -0
- package/public/growth.html +465 -465
- package/public/index.html +1372 -1266
- package/public/integrations.html +556 -556
- package/public/js/activate.js +449 -145
- package/public/js/agent-workspace.js +1740 -1740
- package/public/js/auth-nav.js +117 -65
- package/public/js/auth-redirect.js +12 -12
- package/public/js/cookie-consent.js +56 -56
- package/public/js/dns.js +438 -438
- package/public/js/wab-demo-page.js +721 -721
- package/public/js/ws-client.js +74 -74
- package/public/l-preview.html +242 -0
- package/public/llms-full.txt +360 -360
- package/public/llms.txt +125 -125
- package/public/login.html +85 -85
- package/public/mesh-dashboard.html +328 -328
- package/public/milestones.html +346 -0
- package/public/one-click.html +779 -0
- package/public/openapi.json +669 -669
- package/public/partners.ar.html +145 -0
- package/public/partners.html +143 -0
- package/public/phone-shield.html +281 -281
- package/public/plesk-integration.html +375 -375
- package/public/premium-dashboard.html +2489 -2489
- package/public/premium.html +793 -793
- package/public/privacy.html +297 -297
- package/public/provider-onboarding.html +172 -172
- package/public/provider-sandbox.html +134 -134
- package/public/providers.html +359 -359
- package/public/refusals.html +172 -0
- package/public/register.html +105 -105
- package/public/registrar-integrations.html +141 -141
- package/public/ring4.html +292 -0
- package/public/robots.txt +99 -99
- package/public/route53-integration.html +531 -531
- package/public/score.html +263 -0
- package/public/script/wab-consent.d.ts +36 -36
- package/public/script/wab-consent.js +104 -104
- package/public/script/wab-schema.js +131 -131
- package/public/script/wab.d.ts +108 -108
- package/public/script/wab.min.js +580 -580
- package/public/security.txt +8 -8
- package/public/shieldlink.html +244 -0
- package/public/shieldqr.html +231 -231
- package/public/sitemap.xml +13 -1
- package/public/terms.html +256 -256
- package/public/trust-graph-api.ar.html +92 -0
- package/public/trust-graph-api.html +91 -0
- package/public/wab-features.html +560 -0
- package/public/wab-trust.html +200 -200
- package/public/wab-truth.html +375 -0
- package/public/wab-vs-protocols.html +210 -210
- package/public/whitepaper.html +449 -449
- package/script/ai-agent-bridge.js +1754 -1754
- package/sdk/README.md +99 -99
- package/sdk/agent-mesh.js +449 -449
- package/sdk/auto-discovery.js +301 -288
- package/sdk/commander.js +262 -262
- package/sdk/governance.js +262 -262
- package/sdk/index.d.ts +464 -464
- package/sdk/index.js +649 -649
- package/sdk/multi-agent.js +318 -318
- package/sdk/safe-mode.js +221 -221
- package/sdk/safety-shield.js +219 -219
- package/sdk/schema-discovery.js +83 -83
- package/server/adapters/index.js +520 -520
- package/server/config/plans.js +412 -367
- package/server/config/secrets.js +102 -102
- package/server/control-plane/index.js +301 -301
- package/server/data-plane/index.js +354 -354
- package/server/index.js +790 -670
- package/server/llm/index.js +404 -404
- package/server/middleware/adminAuth.js +35 -35
- package/server/middleware/api-tier.js +170 -0
- package/server/middleware/auth.js +50 -50
- package/server/middleware/featureGate.js +88 -88
- package/server/middleware/rateLimits.js +100 -100
- package/server/middleware/sensitiveAction.js +157 -157
- package/server/middleware/wab-trust.js +141 -0
- package/server/migrations/001_add_analytics_indexes.sql +7 -7
- package/server/migrations/002_premium_features.sql +418 -418
- package/server/migrations/003_ads_integer_cents.sql +33 -33
- package/server/migrations/004_agent_os.sql +158 -158
- package/server/migrations/005_marketplace_metering.sql +126 -126
- package/server/migrations/006_growth_suite.sql +138 -0
- package/server/migrations/007_governance.sql +106 -106
- package/server/migrations/008_plans.sql +144 -144
- package/server/migrations/009_shieldqr.sql +30 -30
- package/server/migrations/010_extended_trust.sql +33 -33
- package/server/migrations/011_outreach.sql +47 -0
- package/server/migrations/012_shieldlink.sql +116 -0
- package/server/migrations/013_ct_monitor.sql +13 -0
- package/server/migrations/014_wab_advanced_features.sql +128 -0
- package/server/migrations/015_wab_truth_layer.sql +101 -0
- package/server/migrations/016_ring4_external_trust.sql +84 -0
- package/server/migrations/017_ring4_extensions.sql +69 -0
- package/server/migrations/018_commercial_foundations.sql +167 -0
- package/server/migrations/019_unify_tier_constraints.sql +133 -0
- package/server/models/adapters/index.js +33 -33
- package/server/models/adapters/mysql.js +183 -183
- package/server/models/adapters/postgresql.js +172 -172
- package/server/models/adapters/sqlite.js +7 -7
- package/server/models/db.js +740 -740
- package/server/observability/failure-analysis.js +337 -337
- package/server/observability/index.js +394 -394
- package/server/protocol/capabilities.js +223 -223
- package/server/protocol/index.js +243 -243
- package/server/protocol/schema.js +584 -584
- package/server/registry/certification.js +271 -271
- package/server/registry/index.js +326 -326
- package/server/routes/activate.js +478 -0
- package/server/routes/admin-outreach.js +239 -0
- package/server/routes/admin-plans.js +76 -76
- package/server/routes/admin-premium.js +674 -673
- package/server/routes/admin-shieldlink.js +137 -0
- package/server/routes/admin-shieldqr.js +90 -90
- package/server/routes/admin-trust-monitor.js +139 -83
- package/server/routes/admin.js +550 -549
- package/server/routes/adopt.js +61 -0
- package/server/routes/ads.js +130 -130
- package/server/routes/agent-workspace.js +540 -540
- package/server/routes/api-keys.js +127 -0
- package/server/routes/api.js +150 -150
- package/server/routes/auth.js +71 -71
- package/server/routes/billing.js +57 -57
- package/server/routes/commander.js +316 -316
- package/server/routes/customer-shieldlink.js +133 -0
- package/server/routes/demo-showcase.js +332 -332
- package/server/routes/demo-store.js +154 -154
- package/server/routes/diagnose.js +373 -0
- package/server/routes/discovery.js +2348 -2348
- package/server/routes/enterprise-mesh.js +170 -0
- package/server/routes/gateway.js +173 -173
- package/server/routes/governance-saas.js +203 -0
- package/server/routes/governance.js +208 -208
- package/server/routes/growth.js +1048 -0
- package/server/routes/intent.js +328 -0
- package/server/routes/license.js +251 -251
- package/server/routes/mesh.js +469 -469
- package/server/routes/noscript.js +543 -543
- package/server/routes/partners.js +201 -0
- package/server/routes/plans.js +33 -33
- package/server/routes/premium-v2.js +686 -686
- package/server/routes/premium.js +724 -724
- package/server/routes/providers.js +650 -650
- package/server/routes/reputation.js +411 -0
- package/server/routes/ring4.js +885 -0
- package/server/routes/runtime.js +2148 -2148
- package/server/routes/shieldlink.js +70 -0
- package/server/routes/shieldqr.js +88 -88
- package/server/routes/sovereign.js +465 -465
- package/server/routes/truth-layer.js +670 -0
- package/server/routes/universal.js +200 -200
- package/server/routes/unsubscribe.js +51 -0
- package/server/routes/wab-api.js +850 -850
- package/server/routes/wab-cache.js +282 -0
- package/server/runtime/container-worker.js +111 -111
- package/server/runtime/container.js +448 -448
- package/server/runtime/distributed-worker.js +362 -362
- package/server/runtime/event-bus.js +210 -210
- package/server/runtime/index.js +253 -253
- package/server/runtime/queue.js +599 -599
- package/server/runtime/replay.js +666 -666
- package/server/runtime/sandbox.js +266 -266
- package/server/runtime/scheduler.js +534 -534
- package/server/runtime/session-engine.js +293 -293
- package/server/runtime/state-manager.js +188 -188
- package/server/secrets/wab-signing-key.pem +3 -0
- package/server/secrets/wab-signing-pub.pem +3 -0
- package/server/security/cross-site-redactor.js +196 -196
- package/server/security/dry-run.js +180 -180
- package/server/security/human-gate-rate-limit.js +147 -147
- package/server/security/human-gate-transports.js +178 -178
- package/server/security/human-gate.js +281 -281
- package/server/security/index.js +368 -368
- package/server/security/intent-engine.js +245 -245
- package/server/security/reward-guard.js +171 -171
- package/server/security/rollback-store.js +239 -239
- package/server/security/token-scope.js +404 -404
- package/server/security/url-policy.js +139 -139
- package/server/services/adoption-agent.js +182 -0
- package/server/services/agent-chat.js +506 -506
- package/server/services/agent-learning.js +601 -601
- package/server/services/agent-memory.js +625 -625
- package/server/services/agent-mesh.js +555 -555
- package/server/services/agent-symphony.js +717 -717
- package/server/services/agent-tasks.js +1807 -1807
- package/server/services/api-key-engine.js +292 -292
- package/server/services/cluster.js +894 -894
- package/server/services/commander.js +738 -738
- package/server/services/edge-compute.js +440 -440
- package/server/services/email.js +233 -233
- package/server/services/fairness-engine.js +409 -0
- package/server/services/fairness.js +420 -0
- package/server/services/governance.js +466 -466
- package/server/services/hosted-runtime.js +205 -205
- package/server/services/lfd.js +635 -635
- package/server/services/local-ai.js +389 -389
- package/server/services/marketplace.js +270 -270
- package/server/services/metering.js +182 -182
- package/server/services/modules/affiliate-intelligence.js +93 -93
- package/server/services/modules/agent-firewall.js +90 -90
- package/server/services/modules/bounty.js +89 -89
- package/server/services/modules/collective-bargaining.js +92 -92
- package/server/services/modules/dark-pattern.js +66 -66
- package/server/services/modules/gov-intelligence.js +45 -45
- package/server/services/modules/neural.js +55 -55
- package/server/services/modules/notary.js +49 -49
- package/server/services/modules/price-time-machine.js +86 -86
- package/server/services/modules/protocol.js +104 -104
- package/server/services/negotiation.js +439 -439
- package/server/services/outreach-agent.js +312 -0
- package/server/services/plans.js +214 -214
- package/server/services/plugins.js +771 -771
- package/server/services/price-intelligence.js +566 -566
- package/server/services/price-shield.js +1137 -1137
- package/server/services/provider-clients.js +740 -740
- package/server/services/reputation.js +465 -465
- package/server/services/search-engine.js +357 -357
- package/server/services/security.js +513 -513
- package/server/services/self-healing.js +843 -843
- package/server/services/shieldlink.js +492 -0
- package/server/services/shieldqr.js +322 -322
- package/server/services/sovereign-shield.js +542 -542
- package/server/services/ssl-ct-monitor.js +224 -0
- package/server/services/ssl-inspector.js +42 -42
- package/server/services/ssl-monitor.js +167 -167
- package/server/services/stripe.js +206 -205
- package/server/services/swarm.js +788 -788
- package/server/services/universal-scraper.js +662 -662
- package/server/services/verification.js +481 -481
- package/server/services/vision.js +1163 -1163
- package/server/services/wab-crypto.js +178 -178
- package/server/utils/cache.js +125 -125
- package/server/utils/migrate.js +81 -81
- package/server/utils/safe-fetch.js +228 -228
- package/server/utils/secureFields.js +50 -50
- package/server/ws.js +161 -161
- package/templates/artisan-marketplace.yaml +104 -104
- package/templates/book-price-scout.yaml +98 -98
- package/templates/electronics-price-tracker.yaml +108 -108
- package/templates/flight-deal-hunter.yaml +113 -113
- package/templates/freelancer-direct.yaml +116 -116
- package/templates/grocery-price-compare.yaml +93 -93
- package/templates/hotel-direct-booking.yaml +113 -113
- package/templates/local-services.yaml +98 -98
- package/templates/olive-oil-tunisia.yaml +88 -88
- package/templates/organic-farm-fresh.yaml +101 -101
- package/templates/restaurant-direct.yaml +97 -97
- package/templates/ring4/banking-sovereign.yaml +55 -0
- package/templates/ring4/ecommerce-sovereign.yaml +58 -0
- package/templates/ring4/healthcare-sovereign.yaml +60 -0
|
@@ -1,375 +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>
|
|
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>
|