API Token Expiry Warning Script (#2253)

* Add API token expiry warning notification script

* Create Readme.md for API Token Expiry Warning script

Added documentation for the API Token Expiry Warning script, detailing its purpose and benefits.

Author: Charanjet

Server-Side Components/Scheduled Jobs/API Token Expiry Warning/API Token Expiry Warning.js

@@ -0,0 +1,53 @@
+(function() {
+
+    // Configuration via system properties
+    var warningDays = parseInt(gs.getProperty('api.token.expiry.warning.days', '7'), 10); // Days before expiry to warn
+    var emailRecipients = gs.getProperty('api.token.expiry.email.recipients', 'admin@example.com'); // Comma-separated emails
+
+    // Current time and warning threshold time
+    var now = new GlideDateTime();
+    var warningDate = new GlideDateTime();
+    warningDate.addDays(warningDays);
+
+    // Query oauth_credential records with expires_on between now and warningDate
+    var gr = new GlideRecord('oauth_credential');
+    gr.addQuery('expires_on', '>=', now);
+    gr.addQuery('expires_on', '<=', warningDate);
+    gr.addQuery('active', '=', true); // Only active tokens
+    gr.orderBy('expires_on');
+    gr.query();
+
+    if (!gr.hasNext()) {
+        gs.info('No OAuth credentials nearing expiry within ' + warningDays + ' days.');
+        return;
+    }
+
+    // Build notification email body
+    var emailBody = '<h3>API Token Expiry Warning</h3>';
+    emailBody += '<p>The following OAuth credentials are set to expire within ' + warningDays + ' days:</p>';
+    emailBody += '<table border="1" cellpadding="5" cellspacing="0" style="border-collapse:collapse;">';
+    emailBody += '<tr><th>Name</th><th>User</th><th>Client ID</th><th>Expires On</th></tr>';
+
+    while (gr.next()) {
+        emailBody += '<tr>';
+        emailBody += '<td>' + gr.getDisplayValue('name') + '</td>';
+        emailBody += '<td>' + gr.getDisplayValue('user') + '</td>';
+        emailBody += '<td>' + gr.getValue('client_id') + '</td>';
+        emailBody += '<td>' + gr.getDisplayValue('expires_on') + '</td>';
+        emailBody += '</tr>';
+    }
+    emailBody += '</table>';
+    emailBody += '<p>Please review and renew tokens to avoid integration failures.</p>';
+
+    // Send the email
+    var mail = new GlideEmailOutbound();
+    mail.setFrom('no-reply@yourdomain.com');
+    mail.setSubject('[ServiceNow] OAuth API Token Expiry Warning');
+    mail.setTo(emailRecipients);
+    mail.setBody(emailBody);
+    mail.setContentType('text/html');
+    mail.send();
+
+    gs.info('OAuth token expiry warning email sent to: ' + emailRecipients);
+
+})();

Server-Side Components/Scheduled Jobs/API Token Expiry Warning/Readme.md

@@ -0,0 +1,5 @@
+API Token Expiry Warning Script
+**Overview**
+This script provides proactive monitoring and alerting for OAuth API tokens stored in the ServiceNow oauth_credential table. It identifies tokens nearing expiry within a configurable countdown window and sends notification emails to administrators, helping prevent sudden integration failures due to expired credentials.
+**Problem Solved**
+API tokens used for integrations have expiration timestamps after which they become invalid. Without early warnings, tokens can expire unnoticed, causing integration outages, failed API calls, and increased support incidents. This solution enables administrators to receive timely alerts allowing proactive token renewal and smoother integration continuity.