# How scraper keys work

Come up with a random passphrase:

`not this, this is a bogus passphrase for documentation`

Run that through the `hash-api-key` subcommand of any `ptth_relay` instance:

`ptth_relay hash-api-key`

You'll get a hash like this:

`RUWt1hQQuHIRjftOdgeZf0PG/DtAmIaMqot/nwBAZXQ=`

Make sure that gets into the relay's config file, `ptth_relay.toml`:

```
[[scraper_keys]]
name = "shudder_mummy"
not_before = "2021-08-27T19:20:25-05:00"
not_after = "2031-08-27T19:20:25-05:00"
hash = "RUWt1hQQuHIRjftOdgeZf0PG/DtAmIaMqot/nwBAZXQ="
```

Use curl to like, try it out:

```
curl \
--header "X-ApiKey: not this, this is a bogus passphrase for documentation" \
http://localhost:4000/scraper/v1/test
```