microsoft/power-platform-skills / plugins/power-pages/skills/manage-firewall
manage-firewall
UnverifiedInspects and configures the web application firewall (WAF) in front of a Power Pages production site. Lists the current state, recommends enabling protection when it is off, and walks the user through adding, updating, or removing custom rules — IP blocks, country blocks, path blocks, and rate limits. Use when the user wants to turn on WAF, block traffic by IP or country, rate-limit login or signup pages, protect pages from brute-force attempts, restrict access to specific paths, review the current firewall configuration, or asks "is my site protected against bots / common web attacks?" — even if they say "add rate limit" or "protect login page" without mentioning "firewall" or "WAF".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 17.5 KB |
| references/commands.md | markdown | 11.4 KB |
| references/rule-reference.md | markdown | 8.5 KB |
| scripts/delete-rules.js | script | 1.8 KB |
| scripts/disable.js | script | 2.8 KB |
| scripts/enable.js | script | 3.0 KB |
| scripts/get-rules.js | script | 1.7 KB |
| scripts/get-status.js | script | 1.6 KB |
| scripts/set-rules.js | script | 2.8 KB |
| scripts/transform-firewall.js | script | 6.4 KB |
scripts/disable.js
View on GitHub#!/usr/bin/env node
const {
resolveContext,
request,
pollUntil,
parseCliArgs,
parseTimeoutMs,
fail,
hasErrorCode,
runCli,
} = require('../../../scripts/lib/power-platform-api');
const DEFAULT_TIMEOUT_MIN = 15;
const POLL_INTERVAL_MS = 30_000;
const HELP = `disable.js — Turns off the web application firewall for a site.
Usage:
node disable.js --portalId <portal-id> [--timeoutMinutes <n>]
Flags:
--portalId Power Platform API portal identifier (resolved during prerequisites)
--timeoutMinutes Maximum wait time (default: ${DEFAULT_TIMEOUT_MIN})
--help Show this help message
Exit codes:
0 Disabled
2 Sign-in required
3 Polling timed out
4 Unsupported (trial site or region restriction)
1 Other failure
Example:
node disable.js --portalId <portal-id>
node disable.js --portalId <portal-id> --timeoutMinutes <minutes>
`;
async function main() {
if (process.argv.includes('--help')) {
process.stdout.write(HELP);
return;
}
const args = parseCliArgs(process.argv);
const { portalId } = args;
if (!portalId) {
fail('Usage: node disable.js --portalId <portal-id> [--timeoutMinutes <n>]', 1);
}
const timeoutMs = parseTimeoutMs(args.timeoutMinutes, DEFAULT_TIMEOUT_MIN);
const ctx = resolveContext();
if (ctx.error) fail(ctx.error, 2);
const start = await request({
context: ctx,
method: 'POST',
path: `/websites/${portalId}/disableWaf`,
});
if (hasErrorCode(start, 'B022', 'B023')) {
fail(`Firewall not available for this site: ${start.error?.message || ''}`, 4);
}
if (hasErrorCode(start, 'B003')) {
process.stderr.write('A firewall change is already in progress; will wait for it to settle.\n');
} else if (start.statusCode !== 202) {
fail(`Disable firewall failed (${start.statusCode}): ${start.error?.message || ''}`, 1);
}
const poll = await pollUntil({
fetchStatus: async () => {
const r = await request({
context: ctx,
method: 'GET',
path: `/websites/${portalId}/getWafStatus`,
});
if (!r.ok) return { ok: false, error: r.error?.message || `${r.statusCode}` };
const raw = typeof r.body === 'string' ? r.body : r.body?.status;
const status = String(raw || '').toLowerCase();
if (status === 'failed') {
return { ok: false, error: 'disable operation reached the "Failed" terminal state' };
}
return { ok: true, body: status };
},
isDone: (status) => status === 'disabled',
timeoutMs,
intervalMs: POLL_INTERVAL_MS,
});
if (!poll.ok && poll.error === 'timeout') {
fail('Disable did not complete before timeout.', 3);
}
if (!poll.ok) fail(`Polling failed: ${poll.error}`, 1);
process.stdout.write(
JSON.stringify({ status: 'disabled', attempts: poll.attempts }) + '\n'
);
}
runCli(module, main);
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |