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 tokenThe account's owners

A user owner gets the email at their own address. A group owner sends it to that group's direct members. Run-as principals aren't notified.

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.