MrSphay/intelligence-terminal
1
0
Fork 0
Code Issues 10 Pull Requests Actions Packages Projects Releases Wiki Activity

Fix Cloudflare Radar permission docs and Layer 3 API contract

Browse Source 
P1-1: Permission instructions now correctly reference Account →
Account Analytics → Read, matching Cloudflare's Radar API docs.

P1-2: Layer 3 DDoS endpoint fixed to use /summary/{dimension}
(protocol, vector) and parse summary_0 response format per API
contract. Returns protocol breakdown and attack vector percentages.
This commit is contained in:
calesthio
2026-03-21 14:56:03 -07:00
parent 7afaa48922
commit 06429fedd8
2 changed files with 22 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
.env.example
View File

@@ -21,7 +21,7 @@ AISSTREAM_API_KEY=
ACLED_EMAIL=
# OAuth2 password grant (API keys deprecated Sept 2025)
ACLED_PASSWORD=
# Cloudflare Radar internet outages & traffic anomalies (free: dash.cloudflare.com/profile/api-tokens)
# Cloudflare Radar internet outages & traffic anomalies (free: dash.cloudflare.com/profile/api-tokens, Account Analytics Read)
CLOUDFLARE_API_TOKEN=
# === Server Configuration ===

28
apis/sources/cloudflare-radar.mjs
View File

@@ -1,7 +1,7 @@
// Cloudflare Radar — Internet traffic anomalies and outages
// Requires a free Cloudflare API token (CLOUDFLARE_API_TOKEN).
// Get one at: https://dash.cloudflare.com/profile/api-tokens
// Create a token with "Cloudflare Radar: Read" permissions.
// Create a custom token with Account → Account Analytics → Read permission.
//
// Monitors internet outages, traffic anomalies, and attack trends
// that correlate with conflict, censorship, and infrastructure disruption.
@@ -51,13 +51,27 @@ async function fetchAttackSummary() {
const headers = getAuthHeaders();
if (!headers) return { error: 'no_credentials' };
// Layer 3/4 DDoS attack summary
const url = `${RADAR_BASE}/attacks/layer3/summary?dateRange=7d&format=json`;
const data = await safeFetch(url, { timeout: 15000, headers });
// Layer 3 DDoS attack summaries by protocol and vector
// API requires a dimension: /summary/{dimension}
const [byProtocol, byVector] = await Promise.all([
safeFetch(`${RADAR_BASE}/attacks/layer3/summary/protocol?dateRange=7d&format=json`, { timeout: 15000, headers }),
safeFetch(`${RADAR_BASE}/attacks/layer3/summary/vector?dateRange=7d&format=json`, { timeout: 15000, headers }),
]);
if (data.error) return { error: data.error };
const result = {};
return data.result?.summary || data.result || null;
if (!byProtocol.error && byProtocol.result) {
result.byProtocol = byProtocol.result.summary_0 || byProtocol.result;
}
if (!byVector.error && byVector.result) {
result.byVector = byVector.result.summary_0 || byVector.result;
}
if (!result.byProtocol && !result.byVector) {
return { error: byProtocol.error || byVector.error || 'No attack data returned' };
}
return result;
}
async function fetchTrafficAnomalies() {
@@ -137,7 +151,7 @@ export async function briefing() {
source: 'Cloudflare-Radar',
timestamp: new Date().toISOString(),
status: 'no_credentials',
message: 'Set CLOUDFLARE_API_TOKEN in .env. Get a free token at https://dash.cloudflare.com/profile/api-tokens with "Cloudflare Radar: Read" permission.',
message: 'Set CLOUDFLARE_API_TOKEN in .env. Get a free token at https://dash.cloudflare.com/profile/api-tokens with Account → Account Analytics → Read permission.',
};
}