Files
itflow/cron/manager_checkin.php
johnnyq 3b5c11c552 Add managed mode, so one ITFlow can manage others - Admin > Managed Instances adds an instance and gives a one-time connection code (a week) that the other ITFlow pastes into the new Admin > Managed By, after which it checks in every minute from the new Manager Check-in cron job with a health report (versions, update waiting and whether it has security fixes, cron, last backup, errors today, agents against the seat limit, clients, storage) and takes back what the manager sets; the manager lists each instance's version, health, seats and last check-in with a page per instance showing what needs a look, its requests and everything it reported, can update it by hand or automatically after a set number of days (security releases straight away, not retried for six hours after a failure), set its seat limit and white-label key (locked on the instance while set), make it read-only (look, export and download only, across agents, portal, guest links and the API) or suspended (a notice with the manager's message and contact, 503 for the API) with other cron jobs paused until it is active again, sign in to it as support through a signed one-time two-minute link into a two-hour session that takes no seat, can't open the vault and can't set passwords or make API keys, and remove it, while the new Managed Instances job notifies when one stops checking in and closes requests never answered; instances only call the manager, can disconnect unless config.php sets $config_manager_required, and the Update page and queue_update defer to the manager; database 3.5.8 adds managed_instances, managed_instance_commands, settings.config_manager_keys and settings.config_managed, the logic is in the new functions/managed.php with api/managed/enroll.php, api/managed/checkin.php, login_support.php and includes/managed_blocked.php, cronJobClaim() takes a paused reason that leaves a due job due, getAgentUserLimit() and getActiveAgentUserCount() honour the manager's limit and leave out the support user, the vault helpers read a missing session key as empty, the audit log knows the new types and actions, and the email parser no longer logs an App Logs error every minute while parsing is switched off; changelog updated
2026-11-05 15:22:41 -05:00

54 lines
1.8 KiB
PHP

<?php
/*
* ITFlow - Manager check-in job
*
* For an ITFlow managed by another (Admin > Managed By): every minute, tells the manager how
* this install is doing and takes back what the manager sets - seat limit, white label,
* updates, active, read-only or suspended - and anything it has asked, like an update. See
* functions/managed.php. The instance always calls; the manager never calls it.
*
* First in the registry, so a change of mode applies to the jobs after it in the same cycle.
* Stops straight away on an install that isn't managed - which is most of them.
*/
// Set working directory to the directory this cron script lives at.
chdir(dirname(__FILE__));
// Ensure we're running from command line
if (php_sapi_name() !== 'cli') {
die("This script must be run from the command line.\n");
}
// Prevent overlapping runs of this script
$cron_lock_script = __FILE__;
require_once "includes/cron_lock.php";
require_once "../config.php";
// Set Timezone
require_once "../includes/inc_set_timezone.php";
require_once "../functions.php";
$manager_checkin_settings = mysqli_fetch_assoc(mysqli_query($mysqli, "SELECT config_enable_cron FROM settings WHERE company_id = 1"));
if (intval($manager_checkin_settings['config_enable_cron'] ?? 0) === 0) {
cronJobStop("Cron: is not enabled\n");
}
// Files newer than the schema - the column managed mode keeps its state in isn't there yet
if (!settingsColumnExists($mysqli, 'config_managed')) {
cronJobStop("The database update has not been applied yet\n");
}
if (!managedIsManaged()) {
cronJobStop("Not managed\n");
}
$manager_checkin = managedCheckin();
// Thrown, so the dispatcher records why against the job and Admin > Managed By can show it
if (!$manager_checkin['ok']) {
throw new Exception($manager_checkin['error']);
}