Skip to main content

Access Token Expiry Notifications

Expired tokens break integrations without warning, so IOMETE can email token owners ahead of time.

A scheduler runs every day and sends alerts at two configurable thresholds: a warning level and a critical level, each measured in days before expiry.

Both personal and service account tokens are covered (system tokens are excluded).

Prerequisites

Notifications only fire when both conditions are met:

  1. At least one threshold is set to a positive integer in System Config. See Configuring Thresholds.
  2. An SMTP server is configured. See Email Configuration.

Configuring Thresholds

Both thresholds default to 0, which disables notifications. An admin sets them to positive integers in System Config to turn them on.

System config keyDefaultDescription
access-tokens.notifications.warning0 (disabled)Days before expiry to send the warning email
access-tokens.notifications.critical0 (disabled)Days before expiry to send the critical email

Set one or both. If you set only the critical threshold, recipients get a single alert close to expiry with no earlier heads-up.

Who Gets Notified

Recipients depend on the token type:

Token typeRecipients
Personal tokenThe token owner's email address
Service account tokenAll human users in groups that have permissions on the service account

Each token gets at most one email per threshold level. The scheduler tracks which levels have already been sent, so a warning email won't repeat, and the critical email only goes out once its threshold is reached.