Source: https://fyno.docs.pageloop.ai/documentation/settings/workspace-settings/security/secure-allowlist-endpoints

# Secure Allowlist Endpoints

The **Secure Allowlist Endpoints** feature adds an additional security layer to verify that API requests originated from Fyno.

When enabled, Fyno generates an HMAC signature using a secret key and includes it in every supported outbound API request. Your application can validate this signature to verify the authenticity and integrity of the request payload.
![](/images/secure-allowlist-endpoints.png)
The signature is included in the request header:

```text
X-Fyno-Hmac-Signature
```

> [!NOTE]
>
> Depending on the application or framework being used, the header may appear as either `X-Fyno-Hmac-Signature` or `x-fyno-hmac-signature`.

### Enable Secure Allowlist Endpoints

1. Navigate to **Workspace Settings** → **Security**.
2. Locate **Secure Allowlist Endpoints** and toggle it on.
3. Click **View / Edit Secret Key**.
4. Use the generated secret key or enable **Override Secret Key** to provide your own custom key.
5. Save the configuration.

### How It Works

When Fyno sends a supported API request:
![](/images/hmac-secret-key.png)

1. Fyno generates an HMAC signature using your configured secret key and the request payload.
2. The signature is created using the **SHA-256** hashing algorithm.
3. The generated signature is added to the request header as `X-Fyno-Hmac-Signature`.
4. Your application can generate the same signature using the shared secret key and compare it with the received signature.
5. If both signatures match, the request can be considered authentic and untampered.

### Supported Requests

Secure Allowlist Endpoints are supported for:

- **HTTP POST** requests only
- `application/json`
- `application/x-www-form-urlencoded`

### Supported Use Cases

You can use this feature for:

- API calls made from Workflows
- Delivery reports (DLRs) sent from Fyno to your endpoints
- Any supported outbound webhook integrations requiring request verification

> [!NOTE]
>
> Secure Allowlist Endpoints are supported only for POST requests with `application/json` and `application/x-www-form-urlencoded` content types.
