Primeros pasos con los SDK

Descarga el SDK en tu proyecto. Los ficheros son públicos y no necesitan token.

curl -fsSLO https://dash.openwaf.dev/v1/sdk/openwaf.ts

curl -fsSLO https://dash.openwaf.dev/v1/sdk/openwaf.py

Guarda el fichero en el repositorio junto a tu código. Para actualizarlo, vuelve a descargarlo; lo explica Cómo se generan los SDK.

Crea un token de API en el panel, en Tokens de API. Solo lectura basta para esta guía; usa Técnico para hacer cambios. Los tokens empiezan por owf_.

Configura el cliente con el entorno, para que el token no esté en el código:

export OPENWAF_API_URL=https://dash.openwaf.dev
read -rs OPENWAF_TOKEN && export OPENWAF_TOKEN

Lista tus zonas.

import { OpenWAF } from "./openwaf.ts";

const owf = new OpenWAF();
const { items = [] } = await owf.listZones();
for (const z of items) {
  console.log([z.name, z.status, "v" + z.config_version].join("\t"));
}

bun list-zones.ts        # o: node --experimental-strip-types list-zones.ts

from openwaf import OpenWAF

owf = OpenWAF()
for z in owf.list_zones()["items"]:
    print(z["name"], z["status"], "v%d" % z["config_version"], sep="\t")

python3 list_zones.py