Fastly Setup
This guide covers setting up your Fastly account and Compute service for Trusted Server.
Create a Fastly Account
- Go to manage.fastly.com and create an account if you don't have one
Create an API Token
- Log in to the Fastly control panel
- Go to Account > API tokens > Personal tokens
- Click Create token
- Configure the token:
- Name the token (e.g., "Trusted Server Deploy")
- Choose User Token
- Choose Global API Access
- Choose what makes sense for your organization in terms of Service Access
- Click Create Token
- Copy the key to a secure location - you will not be able to see it again
Create a Compute Service
- Click Compute in the navigation
- Click Create Service
- Click Create Empty Service (below the main options)
- Configure the service:
- Add your domain of the website you'll be testing or using
- Click Update
Configure Origins
Origins are the backend servers that Trusted Server will communicate with (ad servers, SSPs, etc.).
- In your Compute service, click on the Origins section
- For each backend you need to add:
- Enter the FQDN or IP address
- Click Add
- Enter a Name in the first field - this name will be referenced in your code (e.g.,
my_ad_integration_1) - Configure port numbers and TLS settings as needed
TIP
After saving origin information, you can select port numbers and toggle TLS on/off.
Configure Fastly CLI Profile
After installing the Fastly CLI, create a profile with your API token:
fastly profile createFollow the interactive prompts to paste your API token.
Domain Configuration
TIP
With a dev account, Fastly gives you a test domain by default (e.g., xxx.edgecompute.app). You can use this for testing before configuring your own domain.
Using Your Own Domain
When you're ready to use your own domain:
- In the Fastly control panel, add your domain to the service
- Create a CNAME record at your DNS provider pointing to your Fastly domain
- Fastly provides 2 free TLS certificates (non-wildcard) per account
TLS Requirements
- Fastly Compute only accepts client traffic via TLS (HTTPS)
- Origins and backends can be non-TLS if needed
Create Config and Secret Stores
For features like request signing, you'll need to create Fastly stores:
Config Store
Used for storing public configuration (e.g., public keys, key metadata):
fastly config-store create --name jwks_storeSecret Store
Used for storing sensitive data (e.g., private signing keys):
fastly secret-store create --name signing_keysNote the store IDs - you'll need them for your trusted-server.toml configuration.
Next Steps
- Return to Getting Started to continue setup
- See Configuration for detailed configuration options
- See Request Signing for setting up cryptographic signing