> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oleria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Secret expiry

> Find secrets approaching expiration and notify the owner with enough runway to rotate them, escalating if nothing happens.

Instead of tracking expiration dates manually, the **Secret expiry** workflow template finds secrets approaching expiration and notifies the owner with enough runway to rotate them, escalating to the owner's manager, or an alternate reviewer if nothing happens - so an expiring secret never slips through unnoticed.

## How this workflow is built

**1. Trigger**

This workflow runs on a fixed daily schedule - the frequency can't be changed. Set what time of day it runs, in your local time zone, shown next to the time field - there's no separate time zone picker.

**2. Filter Records**

Choose which application instances this workflow checks for secrets nearing expiry - **Across all application instances**, or specific application instances you select.

**3. Configurations**

**Notify before secret expires**

Oleria notifies the secret's owner in two stages before it expires:

* **Reminder**: a first notice 30-90 days before expiry (default 30 days).
* **Warning**: a second notice closer to expiry, 1-30 days before expiry (default 7 days) - the Warning must be fewer days before expiry than the Reminder.

Secrets with no owner skip both notices and go straight to escalation.

**Escalation**

Set how many days before expiry to escalate - 1-7 days (default 2). This must be fewer days before expiry than the Warning, so escalation always lands after the warning notice.

If the secret hasn't been rotated by that point, escalate the notification to the owner's manager. If the manager isn't available, or the secret has no owner, Oleria escalates to the **Alternate reviewer** you configure instead.

**4. Notifications**

Email notifications are always on - you can't turn them off. If your workspace has Slack or Microsoft Teams connected, you can also turn on notifications in that one chat channel. A workspace connects only one messaging system at a time, so it's never both.

## Reviewing runs

Select the workflow's **Runs** tab to see its execution history - when it ran, which secrets it found, and who was notified. See [Workflow templates](https://docs.oleria.com/posture/workflows-overview.md#workflow-templates) for how to start one from scratch.

## Contact us

For questions, contact us at [support@oleria.com](mailto:support@oleria.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.