Security
How to handle Novi credentials, keep access narrow, rotate, and what each product lets a token or agent see and change.
Handle credentials
Section titled “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
Section titled “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
Section titled “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_ |
| 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
Section titled “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_ |
| 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.
What agents can change
Section titled “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_ saves only after asking you. No tool deletes |
| Novi M&A Intelligence | Only your own comps basket |
Your subscription applies on every channel
Section titled “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
Section titled “Compliance”Novi Labs lists SOC 2 Type 2 on novilabs.com.