Skip to main content

Fastly

Fastly is a global edge cloud platform and content delivery network (CDN) that provides fast, secure, and scalable content delivery, application acceleration, and edge computing capabilities. This data integration enables comprehensive visibility and management of Fastly infrastructure, configurations, and network resources through queryable datasets.

CategoryCDN
DirectionQuery source
Sign-inFastly API Token
Query languagesSQLite
Tables13
Query templates60
Websitefastly.com

Before you start​

Huntbase signs in to Fastly with Fastly API Token. Create the credential in Fastly first, then keep it to hand for the Connect step.

  1. In the Fastly control panel, go to Account › API tokens › Personal tokens and click Create token. Enter your password when prompted.
  2. Enter a descriptive name and choose the token type and role.
  3. Under scope, select Read-only access (global:read).
  4. Under service access, limit the token to the service you want to query, and set an expiration.
  5. Click Create Token and copy the token immediately. It is never shown again.

Permissions:

  • global:read (read-only access to account information, configuration and stats)
Watch out for
  • Each connection covers a single Fastly service, so the token must have access to the service in Service ID.

For the vendor's own instructions, see Fastly API token documentation.

tip

Use a dedicated, read-only credential for Huntbase where the product allows it. Huntbase only needs to read.

Connect Fastly​

  1. Go to Connections and click New connection, or click New connection on the Fastly product page.
  2. On Product, pick Fastly and choose the Owner.
  3. On Details, give the connection a Name and, optionally, a Description.
  4. On Connect, fill in the settings and credentials described below.
  5. On Verify, review the summary and click Create & check.

For everything else on the setup page — saving a draft, I'll do this later, and what each check result means — see Connections.

Settings​

Where your Fastly lives:

FieldRequiredNotes
Service IDYes
Base URLNoLeave it empty to use https://api.fastly.com.
Service VersionNoLeave it empty to use the service's active version, or the latest version when none is active.

Credentials​

The only Method is Fastly API Token. Enter a Credential label (for example Production), then fill in:

FieldRequiredNotes
Fastly API TokenYesSecret — not shown again after you save it.

Query it​

Once connected, Fastly can serve these languages in a query tab, and Scout can use it when you ask in Auto:

LanguageUse it for
SQLiteSQL over the 13 tables listed below, alongside every other connected source.

Example: SQLite​

Fastly IP range basic info — List all IP ranges used in the Fastly network along with their IP version.

select
cidr,
version
from
fastly_ip_range;

Fastly ships with 60 query templates. Find them in Library › Queries — see Query templates.

Tables​

Fastly adds 13 tables. Browse their columns from Schema in the query bar's ⋯ menu.

All 13 tables
TableContains
fastly_aclACLs for the service version.
fastly_acl_entryACL entries for the service version.
fastly_backendBackends for the service version.
fastly_conditionConditions defined in the service version.
fastly_data_centerData centers in the Fastly network.
fastly_dictionaryDictionaries for the service version.
fastly_health_checkHealth checks for the service version.
fastly_ip_rangeAll IP ranges (v4 & v6) in the Fastly account.
fastly_poolPools in the Fastly account.
fastly_serviceServices in the Fastly account.
fastly_service_domainDomains for the service version.
fastly_service_versionService versions in the Fastly account.
fastly_tokenTokens in the Fastly account.

Next steps​