James Ritchie
0d4e3e70c1
* tasks no longer inside a group in the side menu (and added “cron”) * Delay using a timezone * Added React Not Defined error to the troubleshooting page * Improved the React common problem * Link to v2 docs * New Development section and entry in Common Problems * Concurrently running the terminal * Fixed the .env weirdness * Added section on creating PATs for Github actions * Improved the Machine spec and limits page * Quick start steps now have nice images * Added a diagram for the lifecycle functions * Added note about onFailure * CRON -> cron/Cron * Updated the cli-dev steps for the concurrently package * Fixed capital letter * Updated diagram text * Removed dead page
47 lines
1.4 KiB
Plaintext
47 lines
1.4 KiB
Plaintext
---
|
|
title: "API keys"
|
|
description: "How to authenticate with Trigger.dev so you can trigger tasks."
|
|
---
|
|
|
|
### Authentication and your secret keys
|
|
|
|
When you [trigger a task](/triggering) from your backend code, you need to set the `TRIGGER_SECRET_KEY` environment variable.
|
|
|
|
Each environment has its own secret key. You can find the value on the API keys page in the Trigger.dev dashboard:
|
|
|
|
|
|
|
|
### Automatically Configuring the SDK
|
|
|
|
To automatically configure the SDK with your secret key, you can set the `TRIGGER_SECRET_KEY` environment variable. The SDK will automatically use this value when calling API methods (like `trigger`).
|
|
|
|
```bash .env
|
|
TRIGGER_SECRET_KEY="tr_dev_…"
|
|
```
|
|
|
|
You can do the same if you are self-hosting and need to change the default URL by using `TRIGGER_API_URL`.
|
|
|
|
```bash .env
|
|
TRIGGER_API_URL="https://trigger.example.com"
|
|
```
|
|
|
|
The default URL is `https://api.trigger.dev`.
|
|
|
|
### Manually Configuring the SDK
|
|
|
|
If you prefer to manually configure the SDK, you can call the `configure` method:
|
|
|
|
```ts
|
|
import { configure } from "@trigger.dev/sdk/v3";
|
|
import { myTask } from "./trigger/myTasks";
|
|
|
|
configure({
|
|
secretKey: "tr_dev_1234", // WARNING: Never actually hardcode your secret key like this
|
|
baseURL: "https://mytrigger.example.com", // Optional
|
|
});
|
|
|
|
async function triggerTask() {
|
|
await myTask.trigger({ userId: "1234" }); // This will use the secret key and base URL you configured
|
|
}
|
|
```
|