Trusted Server

ℹ️ At this time, Trusted Server is designed to work with Fastly. Follow these steps to configure Fastly Compute and deploy it.

Fastly

• Create account at Fastly if you don’t have one - manage.fastly.com

• Log in to the Fastly control panel.

  • Go to Account > API tokens > Personal tokens.
  • Click Create token
  • Name the Token
  • Choose User Token
  • Choose Global API Access
  • Choose what makes sense for your Org in terms of Service Access
  • Copy key to a secure location because you will not be able to see it again

• Create new Compute Service

  • Click Compute and Create Service
  • Click “Create Empty Service” (below main options)
  • Add your domain of the website you’ll be testing or using and click update
  • Click on “Origins” section and add your ad-server / ssp partner information as hostnames (note after you save this information you can select port numbers and TLS on/off)
  • IMPORTANT: when you enter the FQDN or IP ADDR information and click Add you need to enter a “Name” in the first field that will be referenced in your code so something like “my_ad_partner_1”

⚠️ Fastly gives you a test domain to play on but obviously you’re free to create a CNAME to your domain when you’re ready. Note that Fastly compute ONLY accepts client traffic from TLS

Installation

Brew

⚠️ Follow the prompts before and afterwards (to configure system path, etc)

Install Brew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Fastly CLI

Install Fastly CLI

brew install fastly/tap/fastly

Verify Installation and Version

fastly version

Create profile and follow interactive prompt for pasting your API Token created earlier:

fastly profile create

Rust

Install Rust with asdf

brew install asdf
asdf plugin add rust
asdf install rust 1.83.0
asdf reshim

Fix path for Bash

Edit ~/.bash_profile to add path for asdf shims:

export PATH="${ASDF_DATA_DIR:-$HOME/.asdf}/shims:$PATH"

Fix path for ZSH

Edit ~/.zshrc to add path for asdf shims:

export PATH="${ASDF_DATA_DIR:-$HOME/.asdf}/shims:$PATH"

Other shells

See https://asdf-vm.com/guide/getting-started.html#_2-configure-asdf

Configure Build and

Clone Project

git clone [email protected]:IABTechLab/trusted-server.git

Configure

Edit configuration files

ℹ️ Note that you’ll have to edit the following files for your setup:

• fastly.toml (service ID, author, description)
• potsi.toml (KV store ID names)

Build

cargo build

Deploy to Fastly

fastly compute publish

Devleopment

Install viceroy for running tests

cargo install viceroy

Run Fastly server locally

Review configuration for local_server

fastly -i compute serve

Tests

cargo test

⚠️ if test fails viceroy will not display line number of the failed test. Rerun it with cargo test_details.

Additional Rust Commands

• cargo fmt: Ensure uniform code formatting
• cargo clippy: Ensure idiomatic code
• cargo check: Ensure compilation succeeds on Linux, MacOS, Windows and WebAssembly
• cargo bench: Run all benchmarks