La semplicità è la massima sofisticazione

In Transparent Edge, il nostro impegno consiste nel mettere a disposizione dei nostri clienti i mezzi tecnici e umani necessari per garantire sia le prestazioni che la sicurezza dei loro siti web e applicazioni. E questo 2026, che ha appena iniziato a muovere i primi passi, non fa assolutamente eccezione.

Qualsiasi tecnologia sufficientemente avanzata è indistinguibile dalla magia—o almeno questo è ciò che affermava nel 1962 Arthur C. Clarke, il celebre scrittore di fantascienza e autore, tra le altre, di opere notevoli come 2001: Odissea nello spazio. Sono trascorsi più di sessant'anni da allora e quell'affermazione detiene attualmente, semmai, una rilevanza ancora maggiore a seguito della vertiginosa rivoluzione che l'intelligenza artificiale sta portando oggi. Come un'esplosione, è irrotta sulla scena scuotendo le fondamenta del nostro settore. In breve, il povero HAL 9000, l'IA che governava la Discovery One in 2001:…, è stato sorpassato da ChatGPT, Claude, Copilot e Gemini; ciò che fino a poco tempo fa non era altro che fantascienza è diventato, in modo inesorabile e quasi irriverente, realtà.

In Transparent Edge non siamo affatto estranei a questa nuova realtà. A titolo di esempio, si consideri l'inclusione del nostro nuovissimo agente di IA per assistere i nostri clienti con raccomandazioni di codice VCL che, insieme al nostro easy setup recentemente incorporato, facilita il deployment di nuove configurazioni, minimizzando così la curva di apprendimento legata all'uso del DSL (domain-specific language) di Varnish Enterprise e contribuendo al miglioramento continuo del nostro prodotto, di cui la nostra dashboard è il volto più visibile.

In ogni caso, contrariamente a quanto si potrebbe pensare e con il permesso di Arthur C. Clarke, la vera magia non risiede nella tecnologia ma nel talento umano—e in Transparent Edge ne sappiamo molto. Sotto questa premessa, gioca un ruolo cruciale il know-how dei nostri team di front-end e user experience, responsabili dello sviluppo della nostra dashboard, come pure, soprattutto e in modo speciale, del nostro team di back-end, responsabile dello sviluppo della nostra API: un'API su cui si fonda la nostra dashboard, alimentandola con dati e logica. Come direbbe Winston Churchill: mai così tanti hanno dovuto così tanto a così pochi. Perché se la nostra dashboard è il volto visibile, la nostra API è il cervello che orchestra la nostra infrastruttura, i nostri servizi. Un'API che, peraltro, Transparent Edge mette a disposizione dei propri clienti.

Così, fino ad ora, i nostri clienti avevano la possibilità di interagire con la nostra API, consumandone gli endpoint, per svolgere compiti come: analizzare il traffico in tempo reale, consultare dati storici, effettuare il provisioning di nuovi site o backend, regolare la configurazione, gestire i certificati digitali, amministrare gli utenti, invalidare i contenuti e molto altro. Inoltre, Transparent Edge offre da tempo l'integrazione con strumenti come Terraform tramite il nostro provider dedicato, Prometheus o WordPress attraverso il plugin W3 Total Cache.

Cos'è TE-API?

Oggi Transparent Edge offre anche un nuovo strumento gratuito da riga di comando o CLI (command line interface): TE-API. TE-API è sviluppato in Python ed è progettato per incapsulare, strutturare e unificare la nostra API, consentendo un'interazione con tutti i servizi che offre in modo incredibilmente semplice, sicuro ed efficiente. Inoltre, grazie alla specifica OpenAPI, TE-API sarà sempre aggiornato con tutti gli endpoint disponibili.

Questo strumento gestisce autonomamente l'autenticazione degli utenti attraverso lo standard OAuth2 di autorizzazione delegata, il che significa che non è più necessario richiedere preventivamente un token consumando l'endpoint '/v1/oauth2/access_token/'; ora è sufficiente configurare le credenziali in un file '.env' o definire le variabili d'ambiente 'TRANSPARENT_CLIENT_(ID|SECRET)' con tali credenziali… et voilà: TE-API si occuperà automagicamente (che Arthur C. Clarke ci perdoni…) dell'ottenimento e del successivo rinnovo del token corrispondente.

[alberto@MacBook-Air 189 16:00] ~ (21 files, 504K)
✔ (0 jobs) $ env | grep -E 'TRANSPARENT_CLIENT_(ID|SECRET)'
TRANSPARENT_CLIENT_ID=<...>
TRANSPARENT_CLIENT_SECRET=<...>

[alberto@MacBook-Air 455 16:00] ~ (21 files, 504K)
✔ (0 jobs) $ te-api
audit             autoprovisioning  bot-mitigation    companies         core              login             media             security          show-context      storage
authentication    billing           clear-company     completion        inventory         logs              notifications     set-company       statistics        users

[alberto@MacBook-Air 455 16:00] ~ (21 files, 504K)
✔ (0 jobs) $

Da qui, possiamo interagire con lo strumento seguendo una struttura gerarchica e intuitiva:
te-api [MODULO] [VERBO] [RISORSA] [OPZIONI];
ad esempio:

[alberto@MacBook-Air 246 16:00] ~ (21 files, 508K)
✔ (0 jobs) $ te-api companies get current-user | jq '(.first_name + " " + .last_name)'
"Alberto Suárez"

[alberto@MacBook-Air 266 16:00] ~ (21 files, 508K)
✔ (0 jobs) $ te-api companies get sites --company-id <...> | jq -r '.[] | .url' | sort
mi-sitio.es
otro-sitio.es
www.mi-nuevo-site.es
www.mi-sitio.es
www.my-site.com
www.other-site.com
www.otro-sitio.es

[alberto@MacBook-Air 276 16:00] ~ (21 files, 508K)
✔ (0 jobs) $ te-api companies create invalidate --company-id <...> --json-body '{ "urls": ["https://www.mi-sitio.es/"] }'
{
  "urls_to_send": [
    "https://www.mi-sitio.es/"
  ],
  "locked_urls": []
}

[alberto@MacBook-Air 245 16:00] ~ (21 files, 508K)
✔ (0 jobs) $ te-api companies get invalidate --company-id <...>
{
  "total": 1,
  "data": [
    {
      "id": 752974895,
      "user": "asuarez@transparentedge.eu",
      "urls": [
        "https://www.mi-sitio.es/"
      ],
      "invalidation_type": 1,
      "refetch": false,
      "date": "2026-03-19T15:10:15.487469Z",
      "soft": false
    }
  ]
}

[alberto@MacBook-Air 215 16:00] ~ (21 files, 508K)
✔ (0 jobs) $

E così, grazie a TE-API, eliminiamo in un colpo solo la tediosa necessità di costruire manualmente le richieste HTTP per consumare gli endpoint della nostra API, lasciando al suo posto un'interfaccia pulita e semplice. Ed è lì, nella semplicità, dove risiede la massima sofisticazione. Pura magia.

Alberto Suárez López è amministratore di sistemi in Transparent Edge.