---
updatedAt: 2025-08-25T23:00:07.000Z
agentTools:
  projectIndex: https://docs.doppler.com/llms.txt
---

# Access Logs

Understanding who has accessed a secret, when they accessed it, and what medium they accessed it through is necessary to be confident in your security posture.

## Overview

Secret Access Logs allow workplaces to understand which [actors](access-logs#actors) have accessed a secret. Users with the appropriate permissions can see the actor, access method, the first time it was read, and the most recent time it was read.

## Access Logs by Secret

For any secret, you can view the access log by clicking the **Access Log** icon in the secret row.

<Image align="center" width="80% " src="https://files.readme.io/c733a8327c2dee1c32f5ce3744d4246252d2e1d17e70f1610d8cd6c7435b04c8-Access_Logs-1.png" />

When the button is clicked, the access log pane will slide out.

<Image align="center" className="border" border={true} width="50% " src="https://files.readme.io/4ad391a1847fdcc033fcc5126b90d3cac39401b5ed59e9b182a020e9875d67ee-Access_Logs.png" />

<br />

## Access

Doppler maintains the first and most recent time an actor accessed a secret. Access is defined as any time an actor makes a request to Doppler to view a secret and a payload containing the secret is returned. Secrets with blank values are not tracked.

<Callout icon="📘" theme="info">
  Doppler optimistically marks the secret as accessed as soon as the payload is returned, whether it reaches the actor or not.
</Callout>

If the request does not receive a response payload containing the secret value(s), such as in the case of Kubernetes Operator when it receives a 'no update' response, an access event is not recorded.

### Click to reveal secret value

In the Doppler dashboard, a secret's value is not fetched and displayed until the user performs an intent to view the secret. An intent is performed by clicking the secret's value input

<Image align="center" alt="Click to reveal a secret" width="100% " src="https://files.readme.io/4fdb09f730b4a4a348bcf57fb3291eae96c8b429a89cc2ea0af18bac21b714d4-Click_to_reveal_secret_1.gif" />

## Viewers

A viewer can be any actor authorized to view a secret. Each actor is distinctly represented and filterable in the Access Log table. Actors include:

* Users
* Service Tokens
* Personal Access Tokens
* CLI Tokens
* Terraform Provider via token
* Kubernetes Operator via token
* API via token

## Versions

Any time a secret's name or value is mutated, a new [version](versioning) is created. The access logs are available across all versions within the scope of your plan's access history limits.

## Access History

The viewable amount of access history is bound by the plan you are on. See the [pricing page](https://www.doppler.com/pricing) for plan specifics.