# Security

Source: https://developers.novilabs.com/platform/security/

> How to handle Novi credentials, keep access narrow, rotate, and what each product lets a token or agent see and change.

## Handle credentials

- Keep tokens and keys in an environment variable or a secret manager. Never in code, a URL, a shared notebook or a support email.
- Copy a credential when it is shown. Novi API tokens and Snowflake programmatic access tokens are shown once. A Novi UDM Data private key comes as a link that works for 72 hours, and Novi keeps no copy.
- Novi API tokens start with `novi_pat_`, so secret scanners can find one committed by mistake.
- Call the APIs from a server, script or notebook. Browser code on your own web pages can't call the Novi Forecasts API.

## Treat links as secrets too

| Link | Lifetime | Who can use it |
| --- | --- | --- |
| Novi UDM Data bulk file link | 2 hours. A download that has started continues | Anyone with the link |
| Forecasts export file, signed copy | 15 minutes | It works without credentials, so anyone with it can download |
| Novi UDM Data private key link | 72 hours | Not published yet. Treat it as a secret |

## Keep access narrow

| Product | What a credential can do |
| --- | --- |
| Novi UDM Data (v4) | A Snowflake role. Restrict a programmatic access token to one role with `ROLE_RESTRICTION` |
| Novi Forecasts API | A Novi API token acts as one person with that person's full access. No token can create or manage tokens |
| MCP sign-in | One product at your company, through its MCP server only. It does not work on other hosts, products or the REST APIs |
| Novi EVA REST API | The key acts for your EVA organization |

- **Access MCP** is its own permission. Your company's Novi administrator grants it through a role, and removing it cuts off every assistant sign-in.
- Read-only service tokens not tied to a person are [Planned].

## Rotate

| Credential | How |
| --- | --- |
| Novi API token | Pick a lifetime from 1 to 365 days. Create a new token, switch to it, then revoke the old one on the API tokens page. A revoked token stops working within two minutes |
| Snowflake programmatic access token | `ALTER USER REMOVE PROGRAMMATIC ACCESS TOKEN`, then `ADD` a new one with `DAYS_TO_EXPIRY` |
| MCP sign-in | Sign in again when the assistant asks |
| Key pair, EVA Developer API Token | Not published yet. Ask support@novilabs.com |

Details: [Authentication](https://developers.novilabs.com/start/authentication/).

## What agents can change

| MCP server | Tools that change anything |
| --- | --- |
| Novi EVA | None. Every tool is read-only |
| Novi Forecasts | Tools read, or start a plan or an export. `save_forecast_source` saves only after asking you. No tool deletes |
| Novi M&A Intelligence | Only your own comps basket |

## Your subscription applies on every channel

An API or an agent sees what your subscription covers, and no more.

- **Novi UDM Data:** every delivery path shows only the basins in your subscription. Views keyed by a well or wellbore filter rows for you.
- **Novi EVA REST:** a value outside your subscription comes back as `"Subscription Required"`.
- **Novi EVA MCP:** column search covers only columns you are licensed for. A request outside your subscription returns `ACCESS_DENIED`.
- **Novi Forecasts API:** each company's plans, exports and saved records are its own. Nothing you send can reach another company's records.

## Compliance

Novi Labs lists SOC 2 Type 2 on novilabs.com.
