Skip to main content

iTop Integration - Releases

← App details

Nextcloud 35

iTop Integration 1.5.0
Release Details
UpdatedOct. 26, 2026, 11:34 p.m.
Changelog

๐Ÿ”— Identity Binding & Deprecated API Cleanup

โš ๏ธ Breaking

  • Minimum Nextcloud version is now 32: OCP\Config\IUserConfig is only available from Nextcloud 32 onwards, so the user preference migration below raises min-version from 30 to 32. Nextcloud 30 and 31 are no longer supported

Added

  • Admin-side identity binding (occ itop:bind): administrators can link Nextcloud accounts to their iTop person without those users touching iTop. This is the only route available to portal-only users, because iTop issues personal tokens to back-end users only. Matching is controlled by an admin-configured source attribute (Nextcloud email, user ID or display name) and target (Person.email, Person.employee_number or User.login), and results are graded: exact (attribute and name agree) is bindable, review (names differ) needs explicit confirmation, ambiguous (several candidates) is never guessed, none is reported. The command is dry-run by default and requires --apply to write; accounts can be excluded from matching entirely. A failing account is reported and skipped rather than aborting the batch, and the command warns when --limit leaves accounts unexamined. A person already linked to another Nextcloud account is graded conflict and never bound automatically, on any path โ€” person_id is the authorisation boundary for ticket and CI access, so two accounts holding one person would mean each seeing the other's tickets
  • Identity binding settings and API: the matching rule (which Nextcloud attribute is matched against which iTop attribute) is now configurable from Admin settings โ†’ iTop instead of only through occ config:app:set, and shows a warning when a risky attribute is selected, before the rule is saved. Adds admin endpoints for listing accounts with their binding state, managing exclusions, and unbinding, which the association table builds on
  • User associations screen: Admin settings โ†’ iTop now lists every Nextcloud account with its iTop binding state and avatar, filterable by all / unbound / bound / excluded and searchable by name, user ID or email. Accounts can be excluded from matching (individually or in bulk) and links can be removed. Bindings made before this app recorded provenance show their origin as "unknown" rather than blank. Computing matches is not part of this screen
  • Scope picker on the user associations screen: one field searches Nextcloud accounts, groups and Teams, and narrows the table to the accounts the chosen scope covers. Teams require the circles app; with it disabled the picker simply omits them. Typing without choosing a suggestion still filters by name, user ID or email
  • Match suggestions on the user associations screen: Suggest matches grades the selected accounts โ€” or the current page โ€” as exact, review, ambiguous or conflict, and Apply exact only binds the confident ones. Review rows show the Nextcloud and iTop names side by side for a one-click confirmation, ambiguous rows open a picker, and conflict rows name the account already holding that person and offer no action. An already-bound account is never re-bound by apply and gets no Apply or Confirm action โ€” moving someone to a different account stays an explicit unlink-then-apply. Matching runs only when asked, because each account costs one iTop request. Any unbound, non-excluded account can also be linked to a person manually โ€” via the same picker, pre-filled with candidates on an ambiguous row and otherwise opened empty to search โ€” without a match being found first, for the accounts the matcher has nothing to go on
  • Self-service discovery (POST /binding/discover): a third binding route lets a user link their own account from personal settings, with no administrator and no iTop personal token involved. It is off by default โ€” unlike administrator binding, which is backed by the administrator's own application token, and personal-token binding, where iTop itself resolves the token to its own contact, discovery lets the user's own attribute decide which identity they receive, so it starts opt-in and an administrator enables it from Admin settings โ†’ iTop
  • What discovery will and will not do: it binds only on an exact match โ€” where the matched attribute and the name agree. Review (names differ), ambiguous (several candidates) and conflict (person already linked to another account) each get their own explanation and point the user to an administrator; none of these ever names the matched person, so a result that cannot be linked automatically gives no clue who it almost matched. It never re-binds an already-linked account โ€” an administrator must unlink first. The discovery and confirmation endpoints take no parameters and are rate-limited to 5 calls per minute per user, and a successful bind is recorded in the audit log with the account, the person, the method (discovery) and the matched attribute. Personal settings shows only the binding methods an administrator has enabled, and offers discovery as the alternative for portal-only users who cannot obtain a personal token, pointing them to an administrator only when discovery is also disabled
  • An independent toggle for the existing personal-token route: on by default, to preserve current behaviour; the personal-token endpoint returns 403 when it is switched off
  • Admin-configured request-access links: two optional ServiceSubcategory ids โ€” one for "I have a problem" (Incident), one for "I need assistance" (User Request) โ€” let an administrator point users at the right iTop request form. The link appears only where a user cannot link their own account, pointing them to a way of asking for access instead of an administrator, and the user is offered exactly one of the two, chosen by what went wrong: being unable to link because of policy โ€” self-service is switched off, personal tokens are not issued to this profile, the account is excluded from matching โ€” is a service request, while trying to link and having it break โ€” discovery could not match the account, a token was rejected, iTop could not be reached โ€” is an incident. The two normally carry different SLAs, which is the reason for configuring two ids. Either, both or neither may be set; where the id a situation calls for is not set, no link and no hint are shown at all rather than the other one being offered, since that would file the wrong kind of ticket. Setting both ids to the same value stays supported for instances where one form covers both cases. Both ids are ignored, and no link is shown, until the instance URL is configured, since there is no base URL to build the link on
  • Person detail line on the user associations screen: a bound row now reads #16 Boris Vian over boris.vian@it.com ยท admin, beside an icon in the same slot the Nextcloud avatar occupies in the Account column โ€” so the two columns describe the same person in the same shape, instead of leaving an administrator to look a bare id up in iTop. The icon says whether that person is a service desk agent or a portal user; where neither can be established it stays empty rather than guessing, and the hover adds the iTop User id as #2 when one is known. Resolved for the whole page in batched queries rather than one per row, so the table costs no more iTop requests than it already did. A person iTop can no longer find is called out as a broken link; an unreachable iTop leaves the line blank instead, because that is transient and not something to go and repair

Changed

  • Admin settings reorganised: the sections an administrator uses day to day come first and connection setup moved to the bottom, since it is configured once. Before the connection is configured the page shows only that form. Identity binding and user associations are now a single "User associations" section listing the accounts with the matching rule beneath it, and chips under the page header jump to any section, with a back-to-top chip on each
  • Migrated off deprecated IConfig value APIs: IConfig::get/set/deleteAppValue has been deprecated since Nextcloud 29 in favour of IAppConfig, and the matching user preference methods since Nextcloud 33 in favour of IUserConfig. All ~200 call sites now use IAppConfig::getValueString/setValueString/deleteKey and IUserConfig::getValueString/setValueString/deleteUserConfig. IConfig is still used for getSystemValue, which is not deprecated
  • String accessors used deliberately: the typed getValueInt/getValueBool variants are intentionally not used. Existing values are stored as VALUE_MIXED, which reads safely under any getter, but the first typed write pins a config key's type permanently โ€” a single missed call site would then raise AppConfigTypeConflictException at runtime. The string accessors preserve the previous behaviour exactly and leave typed accessors as a safe per-key follow-up
  • Controller routing flags moved to PHP attributes: @NoAdminRequired, @NoCSRFRequired and @PublicPage have been deprecated as PHPDoc annotations since Nextcloud 30 in favour of the OCP\AppFramework\Http\Attribute\* attributes. All 16 across the three remaining controllers were converted. Nextcloud logged one deprecation line per matched method per request, so an endpoint such as the CI class icon โ€” fetched once per class on every settings page load โ€” filled the log on instances running at a low log level. No endpoint's access level changed
  • Notifier registration moved to the bootstrap context: IManager::registerNotifierService() has been deprecated since Nextcloud 22; the notifier is now registered via IRegistrationContext, which also removes a service container lookup from the Application constructor
  • Replaced legacy OC globals in the settings bundles: OC.generateUrl โ†’ generateUrl (@nextcloud/router), OC.requestToken โ†’ getRequestToken() (@nextcloud/auth), OC.Notification.showTemporary โ†’ showSuccess/showError (@nextcloud/dialogs), and the window.t fallback โ†’ translate (@nextcloud/l10n). The request token is now read when each request's headers are built rather than cached at module load, so a rotated token is picked up
<hr />
  • The personal settings page no longer names iTop: every string a user sees there now uses the display name an administrator configured, so an instance rebranded to something else never shows the underlying product name to people who have never heard it. The default is still iTop, so an instance that has not been rebranded is unchanged. Two paragraphs aimed at administrators โ€” how to install the portal personal tokens extension, and which iTop configuration key allows token creation โ€” have been removed from that page entirely; they are not instructions the person reading their own settings can act on
  • Personal settings only shows what a linked account can act on: Search Settings, Notification Settings and Configuration Item Classes appear once the account is linked to a person, since none of them affect anything until it is. The Save button and the "Available features" list are likewise shown only where there is something to save or some way to link. Linking by personal token refreshes the page so the newly available settings appear straight away

Security

  • Cross-site scripting through iTop-supplied text: a person's name, email and organisation were written into the personal settings page as markup rather than text, and a ticket's caller name was built into a link in the reference widget the same way. Anyone able to edit those fields in iTop โ€” an agent, not necessarily an administrator โ€” could run script in the session of any Nextcloud user whose settings page loaded that person, or of everyone in a Talk room where such a ticket link was shared. Both now render as text, and a link whose URL is not http/https is dropped rather than followed. Present in earlier releases; upgrading is the fix
  • The personal-token endpoint is now rate limited to 5 calls per minute per user, with brute-force protection armed on a failed validation. It accepts a token supplied by the caller and makes up to two outbound iTop requests per call, so without a ceiling any signed-in account could use Nextcloud to guess iTop tokens and to generate load against the iTop instance

Fixed

  • Portal users with an additional profile were treated as back-end users: iTop confines a user to the front-end portal as soon as the Portal user profile is assigned โ€” the back office stays locked even when a back-end profile such as Service Desk Agent is also present. ProfileService::isPortalOnly() only reported portal-only when Portal user was the sole profile, so these users were misclassified. The consequences were that ticket links pointed at /pages/UI.php (the back office they cannot open) in widgets, rich previews and notifications; the agent dashboard widget and agent notifications were offered to them; and, because all queries run under the application token, searchCIs() and getCIPreview() skipped the contact-based scoping that portal users are meant to get and could return Configuration Items beyond the user's entitlement. Detection now keys on the profile being present at all. Portal power user is unaffected and still means a back-end user with portal access (typically Service Desk Agent + Portal power user), since the comparison is exact rather than a substring match
  • Cached portal status is recomputed on upgrade: a post-migration repair step clears is_portal_only and profiles_last_check for all users, so the corrected rule takes effect immediately instead of after the profile cache TTL lapses
  • Personal settings respects simple ticketing mode: in simple mode the ticket count endpoint no longer queries the Incident class (which does not exist there) or shows an Incidents: 0 row that could never be anything else; it shows a single ticket count instead

Known issue

  • occ user:setting <uid> integration_itop <key> <value> now fails with "conflict between new type (mixed) and old type (string)" for keys the app has already written. IUserConfig::setValueString() pins a key's type, while occ user:setting writes an untyped value; setValueMixed() is not public API, so this affects any app using IUserConfig on Nextcloud 32+. App behaviour is unaffected โ€” only manual administration. Workaround: occ user:setting <uid> integration_itop <key> --delete first, then set the value
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureLLIEfBPW8vgp0tZOZRrOgTRYypYWYopxng7Cc1s20D5vPFz7xEXLdDj60jkQG7kS4I+AfykgMZlUrOl5c8x6mE/rZQhZL8hQYFOI1eSH5MhFrLO/3BV8fHvAZrvQ4CaTjzOaQVaZNrwudzjiik2EhaQTY72JmsyWMNz/+BkklwnqGSMbZNK4A7AWJAcTATpIOWPFnnX+9KJK8YNfcqZy+1sC5AriI0I7xRVTu/WmwL0tCKiGqxS4/K764E+prlbmjXlYF20C/YELyoiy6kakawFLocvNPm2UtulKj7imPCaxAOOW8pxL0RptEtr6SiDasxCVcUqfgYIpUhDuuBfjMs1r67LxqE8zwQIz9nSlPLvQsAnS0/WAStc762TnPpUen6Q0ZVZKjoBm28vpuo7/0dRQNUFTF3de9B/CQHZKy3WiCAmVRinrGVN9CvkgpEz7WB8P9nu7XQeei1BZu/tLhfQiGoModgQKt2OapQapSHMkC41uMdwmAqDQXfIpXbIOeJynfgs/SLjibYypGIjdfwBb5U6YjOWB3bNxCSE/YWAONyOH7C6m81OevMkJP3ANHThUIgZkCE1LDfodji2VwuXJzGnw+ejNuC8LmPaOKpskQrSPwdbyq65EzAm5ZMK9ePJm9QOs9GXverHweXWmOYzEbThZhV/Fb+6FGO2AxLI=
Signature digestsha512
Dependencies
Required Nextcloud versions >=32.0.0,<36.0.0
Minimum Integer bits32
iTop Integration 1.4.3
Release Details
UpdatedSept. 26, 2026, 9:01 p.m.
Changelog

๐Ÿ”ง Nextcloud 35 Compatibility

Changed

  • Nextcloud 35 Support: Raised the supported max-version to 35 โ€” the app has been verified to run on Nextcloud 35 without code changes
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureaGErBYZ69ot3XEeyeAsN63ujSZcUgGHPl2ArM1J3qBV2GbKPqa9OGpzCmCY9JKRAPWvadu93hZ8JJ+ZyIFAoJSnt2MuNbN9JNyZY2DDkE6IjmQoV/KTLzm3zhe6Tk1pl+mbYSEtzGJBh4i2qyZq39w7bkRhKH3+aTbM7oZlJc+VQhE7NZ9B4F8npRv6YP9CsM7OVKBS1CWO6T3S6D6aUS/lBbPA41jwFDfto+04M0YSo71QdHbo1B2ZU9iyOBXLku+ZkzKkP6lJIaSq0YLJctwCbRA6N4c+qQG+mcmbeWK0Is6VcghuR7coUnGDR80AXH1jws0PrwGWK/61+PWcEyaqsnO+UOL6EDKCvMwpIN1MoVmgtJ1lpbvysr7MnJMhd+N1UFHcmIJxWd0on+XgbCDiPzApLlw50PaCt7PvXHnmr3IotbKyWl1rFEFEgcSead/WBSHUHXChdmdVu57fw2dm29Me1uvcgz1lMtoKV0WQWBlW5koK5H99KKWcIDdxQQ+QPBJfUDkWD1jq6mVZs1aUZb76RCJaw4e9TXwJhIm7RLoz9G3hMbCLxA2R+VKaROrEvzHyrZVQUPx7mG8Uyt00jb4yeT/lmgLxXYLtUJFSVluZj9Y2JsMyO7bXHcsCcHHanViJcYSvQyjqbZhtVJJy7LHlpuwZBwX4lvg+Meyc=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<36.0.0
Minimum Integer bits32

Nextcloud 34

iTop Integration 1.5.0
Release Details
UpdatedOct. 26, 2026, 11:34 p.m.
Changelog

๐Ÿ”— Identity Binding & Deprecated API Cleanup

โš ๏ธ Breaking

  • Minimum Nextcloud version is now 32: OCP\Config\IUserConfig is only available from Nextcloud 32 onwards, so the user preference migration below raises min-version from 30 to 32. Nextcloud 30 and 31 are no longer supported

Added

  • Admin-side identity binding (occ itop:bind): administrators can link Nextcloud accounts to their iTop person without those users touching iTop. This is the only route available to portal-only users, because iTop issues personal tokens to back-end users only. Matching is controlled by an admin-configured source attribute (Nextcloud email, user ID or display name) and target (Person.email, Person.employee_number or User.login), and results are graded: exact (attribute and name agree) is bindable, review (names differ) needs explicit confirmation, ambiguous (several candidates) is never guessed, none is reported. The command is dry-run by default and requires --apply to write; accounts can be excluded from matching entirely. A failing account is reported and skipped rather than aborting the batch, and the command warns when --limit leaves accounts unexamined. A person already linked to another Nextcloud account is graded conflict and never bound automatically, on any path โ€” person_id is the authorisation boundary for ticket and CI access, so two accounts holding one person would mean each seeing the other's tickets
  • Identity binding settings and API: the matching rule (which Nextcloud attribute is matched against which iTop attribute) is now configurable from Admin settings โ†’ iTop instead of only through occ config:app:set, and shows a warning when a risky attribute is selected, before the rule is saved. Adds admin endpoints for listing accounts with their binding state, managing exclusions, and unbinding, which the association table builds on
  • User associations screen: Admin settings โ†’ iTop now lists every Nextcloud account with its iTop binding state and avatar, filterable by all / unbound / bound / excluded and searchable by name, user ID or email. Accounts can be excluded from matching (individually or in bulk) and links can be removed. Bindings made before this app recorded provenance show their origin as "unknown" rather than blank. Computing matches is not part of this screen
  • Scope picker on the user associations screen: one field searches Nextcloud accounts, groups and Teams, and narrows the table to the accounts the chosen scope covers. Teams require the circles app; with it disabled the picker simply omits them. Typing without choosing a suggestion still filters by name, user ID or email
  • Match suggestions on the user associations screen: Suggest matches grades the selected accounts โ€” or the current page โ€” as exact, review, ambiguous or conflict, and Apply exact only binds the confident ones. Review rows show the Nextcloud and iTop names side by side for a one-click confirmation, ambiguous rows open a picker, and conflict rows name the account already holding that person and offer no action. An already-bound account is never re-bound by apply and gets no Apply or Confirm action โ€” moving someone to a different account stays an explicit unlink-then-apply. Matching runs only when asked, because each account costs one iTop request. Any unbound, non-excluded account can also be linked to a person manually โ€” via the same picker, pre-filled with candidates on an ambiguous row and otherwise opened empty to search โ€” without a match being found first, for the accounts the matcher has nothing to go on
  • Self-service discovery (POST /binding/discover): a third binding route lets a user link their own account from personal settings, with no administrator and no iTop personal token involved. It is off by default โ€” unlike administrator binding, which is backed by the administrator's own application token, and personal-token binding, where iTop itself resolves the token to its own contact, discovery lets the user's own attribute decide which identity they receive, so it starts opt-in and an administrator enables it from Admin settings โ†’ iTop
  • What discovery will and will not do: it binds only on an exact match โ€” where the matched attribute and the name agree. Review (names differ), ambiguous (several candidates) and conflict (person already linked to another account) each get their own explanation and point the user to an administrator; none of these ever names the matched person, so a result that cannot be linked automatically gives no clue who it almost matched. It never re-binds an already-linked account โ€” an administrator must unlink first. The discovery and confirmation endpoints take no parameters and are rate-limited to 5 calls per minute per user, and a successful bind is recorded in the audit log with the account, the person, the method (discovery) and the matched attribute. Personal settings shows only the binding methods an administrator has enabled, and offers discovery as the alternative for portal-only users who cannot obtain a personal token, pointing them to an administrator only when discovery is also disabled
  • An independent toggle for the existing personal-token route: on by default, to preserve current behaviour; the personal-token endpoint returns 403 when it is switched off
  • Admin-configured request-access links: two optional ServiceSubcategory ids โ€” one for "I have a problem" (Incident), one for "I need assistance" (User Request) โ€” let an administrator point users at the right iTop request form. The link appears only where a user cannot link their own account, pointing them to a way of asking for access instead of an administrator, and the user is offered exactly one of the two, chosen by what went wrong: being unable to link because of policy โ€” self-service is switched off, personal tokens are not issued to this profile, the account is excluded from matching โ€” is a service request, while trying to link and having it break โ€” discovery could not match the account, a token was rejected, iTop could not be reached โ€” is an incident. The two normally carry different SLAs, which is the reason for configuring two ids. Either, both or neither may be set; where the id a situation calls for is not set, no link and no hint are shown at all rather than the other one being offered, since that would file the wrong kind of ticket. Setting both ids to the same value stays supported for instances where one form covers both cases. Both ids are ignored, and no link is shown, until the instance URL is configured, since there is no base URL to build the link on
  • Person detail line on the user associations screen: a bound row now reads #16 Boris Vian over boris.vian@it.com ยท admin, beside an icon in the same slot the Nextcloud avatar occupies in the Account column โ€” so the two columns describe the same person in the same shape, instead of leaving an administrator to look a bare id up in iTop. The icon says whether that person is a service desk agent or a portal user; where neither can be established it stays empty rather than guessing, and the hover adds the iTop User id as #2 when one is known. Resolved for the whole page in batched queries rather than one per row, so the table costs no more iTop requests than it already did. A person iTop can no longer find is called out as a broken link; an unreachable iTop leaves the line blank instead, because that is transient and not something to go and repair

Changed

  • Admin settings reorganised: the sections an administrator uses day to day come first and connection setup moved to the bottom, since it is configured once. Before the connection is configured the page shows only that form. Identity binding and user associations are now a single "User associations" section listing the accounts with the matching rule beneath it, and chips under the page header jump to any section, with a back-to-top chip on each
  • Migrated off deprecated IConfig value APIs: IConfig::get/set/deleteAppValue has been deprecated since Nextcloud 29 in favour of IAppConfig, and the matching user preference methods since Nextcloud 33 in favour of IUserConfig. All ~200 call sites now use IAppConfig::getValueString/setValueString/deleteKey and IUserConfig::getValueString/setValueString/deleteUserConfig. IConfig is still used for getSystemValue, which is not deprecated
  • String accessors used deliberately: the typed getValueInt/getValueBool variants are intentionally not used. Existing values are stored as VALUE_MIXED, which reads safely under any getter, but the first typed write pins a config key's type permanently โ€” a single missed call site would then raise AppConfigTypeConflictException at runtime. The string accessors preserve the previous behaviour exactly and leave typed accessors as a safe per-key follow-up
  • Controller routing flags moved to PHP attributes: @NoAdminRequired, @NoCSRFRequired and @PublicPage have been deprecated as PHPDoc annotations since Nextcloud 30 in favour of the OCP\AppFramework\Http\Attribute\* attributes. All 16 across the three remaining controllers were converted. Nextcloud logged one deprecation line per matched method per request, so an endpoint such as the CI class icon โ€” fetched once per class on every settings page load โ€” filled the log on instances running at a low log level. No endpoint's access level changed
  • Notifier registration moved to the bootstrap context: IManager::registerNotifierService() has been deprecated since Nextcloud 22; the notifier is now registered via IRegistrationContext, which also removes a service container lookup from the Application constructor
  • Replaced legacy OC globals in the settings bundles: OC.generateUrl โ†’ generateUrl (@nextcloud/router), OC.requestToken โ†’ getRequestToken() (@nextcloud/auth), OC.Notification.showTemporary โ†’ showSuccess/showError (@nextcloud/dialogs), and the window.t fallback โ†’ translate (@nextcloud/l10n). The request token is now read when each request's headers are built rather than cached at module load, so a rotated token is picked up
<hr />
  • The personal settings page no longer names iTop: every string a user sees there now uses the display name an administrator configured, so an instance rebranded to something else never shows the underlying product name to people who have never heard it. The default is still iTop, so an instance that has not been rebranded is unchanged. Two paragraphs aimed at administrators โ€” how to install the portal personal tokens extension, and which iTop configuration key allows token creation โ€” have been removed from that page entirely; they are not instructions the person reading their own settings can act on
  • Personal settings only shows what a linked account can act on: Search Settings, Notification Settings and Configuration Item Classes appear once the account is linked to a person, since none of them affect anything until it is. The Save button and the "Available features" list are likewise shown only where there is something to save or some way to link. Linking by personal token refreshes the page so the newly available settings appear straight away

Security

  • Cross-site scripting through iTop-supplied text: a person's name, email and organisation were written into the personal settings page as markup rather than text, and a ticket's caller name was built into a link in the reference widget the same way. Anyone able to edit those fields in iTop โ€” an agent, not necessarily an administrator โ€” could run script in the session of any Nextcloud user whose settings page loaded that person, or of everyone in a Talk room where such a ticket link was shared. Both now render as text, and a link whose URL is not http/https is dropped rather than followed. Present in earlier releases; upgrading is the fix
  • The personal-token endpoint is now rate limited to 5 calls per minute per user, with brute-force protection armed on a failed validation. It accepts a token supplied by the caller and makes up to two outbound iTop requests per call, so without a ceiling any signed-in account could use Nextcloud to guess iTop tokens and to generate load against the iTop instance

Fixed

  • Portal users with an additional profile were treated as back-end users: iTop confines a user to the front-end portal as soon as the Portal user profile is assigned โ€” the back office stays locked even when a back-end profile such as Service Desk Agent is also present. ProfileService::isPortalOnly() only reported portal-only when Portal user was the sole profile, so these users were misclassified. The consequences were that ticket links pointed at /pages/UI.php (the back office they cannot open) in widgets, rich previews and notifications; the agent dashboard widget and agent notifications were offered to them; and, because all queries run under the application token, searchCIs() and getCIPreview() skipped the contact-based scoping that portal users are meant to get and could return Configuration Items beyond the user's entitlement. Detection now keys on the profile being present at all. Portal power user is unaffected and still means a back-end user with portal access (typically Service Desk Agent + Portal power user), since the comparison is exact rather than a substring match
  • Cached portal status is recomputed on upgrade: a post-migration repair step clears is_portal_only and profiles_last_check for all users, so the corrected rule takes effect immediately instead of after the profile cache TTL lapses
  • Personal settings respects simple ticketing mode: in simple mode the ticket count endpoint no longer queries the Incident class (which does not exist there) or shows an Incidents: 0 row that could never be anything else; it shows a single ticket count instead

Known issue

  • occ user:setting <uid> integration_itop <key> <value> now fails with "conflict between new type (mixed) and old type (string)" for keys the app has already written. IUserConfig::setValueString() pins a key's type, while occ user:setting writes an untyped value; setValueMixed() is not public API, so this affects any app using IUserConfig on Nextcloud 32+. App behaviour is unaffected โ€” only manual administration. Workaround: occ user:setting <uid> integration_itop <key> --delete first, then set the value
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureLLIEfBPW8vgp0tZOZRrOgTRYypYWYopxng7Cc1s20D5vPFz7xEXLdDj60jkQG7kS4I+AfykgMZlUrOl5c8x6mE/rZQhZL8hQYFOI1eSH5MhFrLO/3BV8fHvAZrvQ4CaTjzOaQVaZNrwudzjiik2EhaQTY72JmsyWMNz/+BkklwnqGSMbZNK4A7AWJAcTATpIOWPFnnX+9KJK8YNfcqZy+1sC5AriI0I7xRVTu/WmwL0tCKiGqxS4/K764E+prlbmjXlYF20C/YELyoiy6kakawFLocvNPm2UtulKj7imPCaxAOOW8pxL0RptEtr6SiDasxCVcUqfgYIpUhDuuBfjMs1r67LxqE8zwQIz9nSlPLvQsAnS0/WAStc762TnPpUen6Q0ZVZKjoBm28vpuo7/0dRQNUFTF3de9B/CQHZKy3WiCAmVRinrGVN9CvkgpEz7WB8P9nu7XQeei1BZu/tLhfQiGoModgQKt2OapQapSHMkC41uMdwmAqDQXfIpXbIOeJynfgs/SLjibYypGIjdfwBb5U6YjOWB3bNxCSE/YWAONyOH7C6m81OevMkJP3ANHThUIgZkCE1LDfodji2VwuXJzGnw+ejNuC8LmPaOKpskQrSPwdbyq65EzAm5ZMK9ePJm9QOs9GXverHweXWmOYzEbThZhV/Fb+6FGO2AxLI=
Signature digestsha512
Dependencies
Required Nextcloud versions >=32.0.0,<36.0.0
Minimum Integer bits32
iTop Integration 1.4.3
Release Details
UpdatedSept. 26, 2026, 9:01 p.m.
Changelog

๐Ÿ”ง Nextcloud 35 Compatibility

Changed

  • Nextcloud 35 Support: Raised the supported max-version to 35 โ€” the app has been verified to run on Nextcloud 35 without code changes
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureaGErBYZ69ot3XEeyeAsN63ujSZcUgGHPl2ArM1J3qBV2GbKPqa9OGpzCmCY9JKRAPWvadu93hZ8JJ+ZyIFAoJSnt2MuNbN9JNyZY2DDkE6IjmQoV/KTLzm3zhe6Tk1pl+mbYSEtzGJBh4i2qyZq39w7bkRhKH3+aTbM7oZlJc+VQhE7NZ9B4F8npRv6YP9CsM7OVKBS1CWO6T3S6D6aUS/lBbPA41jwFDfto+04M0YSo71QdHbo1B2ZU9iyOBXLku+ZkzKkP6lJIaSq0YLJctwCbRA6N4c+qQG+mcmbeWK0Is6VcghuR7coUnGDR80AXH1jws0PrwGWK/61+PWcEyaqsnO+UOL6EDKCvMwpIN1MoVmgtJ1lpbvysr7MnJMhd+N1UFHcmIJxWd0on+XgbCDiPzApLlw50PaCt7PvXHnmr3IotbKyWl1rFEFEgcSead/WBSHUHXChdmdVu57fw2dm29Me1uvcgz1lMtoKV0WQWBlW5koK5H99KKWcIDdxQQ+QPBJfUDkWD1jq6mVZs1aUZb76RCJaw4e9TXwJhIm7RLoz9G3hMbCLxA2R+VKaROrEvzHyrZVQUPx7mG8Uyt00jb4yeT/lmgLxXYLtUJFSVluZj9Y2JsMyO7bXHcsCcHHanViJcYSvQyjqbZhtVJJy7LHlpuwZBwX4lvg+Meyc=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<36.0.0
Minimum Integer bits32
iTop Integration 1.4.2
Release Details
UpdatedAug. 11, 2026, 12:29 p.m.
Changelog

๐Ÿ”ง Compatibility Fixes

Fixed

  • Deprecated Exception in Notifier (#6): Notifier::prepare() now throws OCP\Notification\UnknownNotificationException instead of the deprecated plain InvalidArgumentException when a notification is not known to this notifier โ€” Nextcloud โ‰ฅ 30 logged a deprecation warning on every notifications API poll (e.g. from mobile clients or Unified Push) whenever other apps' notifications were processed
  • CI Links Missing Object ID: Smart picker and search results for Configuration Items produced iTop URLs with an empty id= parameter (only UserRequest links worked) โ€” CI queries use output_fields=*, which does not include the object id in iTop REST responses; the id is now taken from the response's key property in both the CI search and the preview mapper, so inserted links and previews point to the actual object
  • Custom CI Class Icons on Hardened Servers: Icon auto-discovery relied on the iTop web server exposing HTML directory listings of /datamodels/2.x/ โ€” standard production hardening (Options -Indexes) blocks these, so all custom CI classes silently fell back to the generic Peripheral icon; the installed module list is now fetched via the REST API (ModuleInstallation) and datamodel XML URLs are derived from the iTop naming convention, with directory listings only used as an enhancement when available; a failed discovery (empty definitions map) is no longer persisted for 24h, so icons recover on the next attempt instead of staying pinned to the fallback; on servers that block the datamodel XML files entirely, the admin settings now show a hint on the Custom CI Classes section naming the affected classes and the two remedies (allow the Nextcloud server to read the datamodel XMLs, or upload icons manually); class icons in the admin settings are now clickable to upload or overwrite a custom icon (SVG or PNG, max 256 KB) via the file picker
  • Localized iTop Date Formats: iTop installations with a customized date_and_time_format (e.g. d.m.Y) delivered localized date strings via the REST API, causing "Invalid Date" in the dashboard widgets, wrong ticket sorting, and broken SLA deadline calculations โ€” all REST responses are now normalized to Y-m-d H:i:s regardless of the server's locale configuration (supports ., /, and - separators in day-first, month-first, and year-first order), and the widgets fall back to the raw string instead of rendering "Invalid Date" for unparseable values
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignaturefId/QLAYQEVu5mLv0resY8nlf2XgkKbsnesc/bTdxlCm/xw1eU7oluiCkFaewbOoq9XEgOJbMeklp+bHzVP+L6jcwuU+yitvPV26TfYSSIsKoXk4nly1FAW4U2Dpf/ggx4JhNo7f3Wwop+25hJV7Dm083545eR8YgDHjARP9UmBJHgfJgo1drYHEEUnyGdRtd78GD+7mXJQMM3s8b48RTXvl7qH4F8gykVa/TXAGIBc/quSxG9+N6kxyAVyXT96oxUUOG3mJOfmqHGDplaYYYaWNoJI0AKkErnS2zemTLHbnKPqgx2l6OmA5UnL1JubRnbRyPPHvIGKayhuWvqvD5h90PxeirsAXvH8adM7SnMS8kpgu9zllkxmOrZvthOVOb64M8wUUVBxdHUvVZ7YcGc93GHyFtC0WQ0HbQ+IAtdZkfZz0zPY54TRhtdd9wfPfDCWLmqwIX0E28MhXV+9/bNTGiYd+MM6VHC5EioUxGS97aBC66bXyUt9vbHvA0lGDEPE58PDZCYwlhv3SqyKY1rtN8L73tWgxrgej9zKVQFpbR8az//W5DjZBTm2ef4+I0bL1nLBz1w0C2U69we2QcuV+rQkO+ohLBEN0NqYrmIeP6dEkie+N122wpN3uGN1ryDNew+PTu9DfIFvFBEqn23YRMb/EGypzMHj33aQpJaY=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<35.0.0
Minimum Integer bits32
iTop Integration 1.4.1
Release Details
UpdatedJuly 26, 2026, 2:08 p.m.
Changelog

๐Ÿ”ง Nextcloud 34 Compatibility, Token Setup Guidance & Release Polish

This release restores compatibility with Nextcloud 34, adds in-app guidance for the iTop personal token prerequisites, and fixes several issues found during the pre-release review of v1.4.0.

Added

  • iTop Configuration Hint (Admin Settings): New warning card explaining that agents need personal_tokens_allowed_profiles configured in iTop's Configuration File Editor before they can create personal tokens, including a ready-to-adapt $MyModuleSettings example
  • Personal Token Help (Personal Settings): Info hint shown when the "Personal Tokens" option is missing from the user's iTop account, pointing them to their iTop administrator

Fixed

  • Nextcloud 34 Compatibility: Replaced removed legacy \OC::$server->getURLGenerator() / getDatabaseConnection() calls with the modern \OCP\Server::get() API โ€” the deprecated shortcut methods were removed in Nextcloud 34, causing the admin and personal settings pages to abort mid-render with an Internal Server Error; also raised the supported max-version to 34
  • Broken Admin Settings CSS: Removed a stray unclosed .ticket-type-options rule that swallowed the new config-hint styles and duplicated an existing selector
  • Template Translation Mismatch: Removed embedded HTML from translatable strings in admin and personal settings templates so they match the locale catalogs (German translations now resolve correctly), and fixed a missing %s substitution that displayed literally instead of the instance name
  • Locale File Consistency: Synced 5 new strings from .js locale files into the .json catalogs for en, de, and de_DE (server-side rendering reads .json โ€” the strings would otherwise fall back to English)
  • Slow Custom CI Class Discovery: The ci-class-available endpoint re-crawled the entire iTop datamodel (one HTTP request per module directory and XML file) on every call โ€” the parsed class-definition map and a negative cache for undiscoverable icons are now persisted in appdata with a 24h TTL, reducing repeat loads from ~37s to under a second
  • Class Browser Not Updating: Newly added custom CI classes now disappear from the selection panel immediately after saving instead of remaining listed
  • Debug Leftover: Removed a stray console.log from the dashboard widget and rebuilt the frontend bundle
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureDQlRM1dgZb1GdPGTBChvKh27m38BBFoFPHhs7jIws7L07u1co5AeWtowwauS7srSh0q6ReEiu1AyFhqC9XXWMC3vwYRFhlnlP3fzMqA2Xi4UAwI989tAhMoixMa4ecisEEWqZ9fo6FZ4rrPgU5CmWVoosLnrdd3v0G/RsCW54d4QruNxspp1RNXWe5z76pecjPrhkASIe6a+YPPa2LJz56H6TxK4aRYtGQ67ODUKm/Yn+F/ctU4hVuol38f68T2QKL0WH48eYXBV8y8D0u1hYMm3CMVeB4McxTaSkYenMOcYOxbjLTGBS6Nk/KJzvab6gi4xB/VzbvWFu5Kz7i2Va9XabBnUSOBsaBLMYf1uM+62wdxFnUFi9pc+dHpB0Pz+WBmtDA7t/YnSrZQk8KVnbUef5Rd8CIopHxMoI9BKQfMlsuLg6zbNx6hsFN/kN9mbhei3U+VfZ5ryyu3bMpZ2a4VlECvZB1h+V271LXdjNviqVWBwSrJPNOVhaPpEYn49HbOJ4FWF+ZIncMIP/VVcfWNLganCJ49ffzCZUIFffGRbxpzbYvuh8NiWqwVGb841B8QoM27MgTH5dq0HYVaB0o8mcpOYRpLtC933L0vDrldYIzrS0hGP4E+nAU0PYpuigY2bfrswWYuhvrHNF1EcrfqqW8vW2XT8L6jrNUutNXw=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<35.0.0
Minimum Integer bits32

Nextcloud 33

iTop Integration 1.5.0
Release Details
UpdatedOct. 26, 2026, 11:34 p.m.
Changelog

๐Ÿ”— Identity Binding & Deprecated API Cleanup

โš ๏ธ Breaking

  • Minimum Nextcloud version is now 32: OCP\Config\IUserConfig is only available from Nextcloud 32 onwards, so the user preference migration below raises min-version from 30 to 32. Nextcloud 30 and 31 are no longer supported

Added

  • Admin-side identity binding (occ itop:bind): administrators can link Nextcloud accounts to their iTop person without those users touching iTop. This is the only route available to portal-only users, because iTop issues personal tokens to back-end users only. Matching is controlled by an admin-configured source attribute (Nextcloud email, user ID or display name) and target (Person.email, Person.employee_number or User.login), and results are graded: exact (attribute and name agree) is bindable, review (names differ) needs explicit confirmation, ambiguous (several candidates) is never guessed, none is reported. The command is dry-run by default and requires --apply to write; accounts can be excluded from matching entirely. A failing account is reported and skipped rather than aborting the batch, and the command warns when --limit leaves accounts unexamined. A person already linked to another Nextcloud account is graded conflict and never bound automatically, on any path โ€” person_id is the authorisation boundary for ticket and CI access, so two accounts holding one person would mean each seeing the other's tickets
  • Identity binding settings and API: the matching rule (which Nextcloud attribute is matched against which iTop attribute) is now configurable from Admin settings โ†’ iTop instead of only through occ config:app:set, and shows a warning when a risky attribute is selected, before the rule is saved. Adds admin endpoints for listing accounts with their binding state, managing exclusions, and unbinding, which the association table builds on
  • User associations screen: Admin settings โ†’ iTop now lists every Nextcloud account with its iTop binding state and avatar, filterable by all / unbound / bound / excluded and searchable by name, user ID or email. Accounts can be excluded from matching (individually or in bulk) and links can be removed. Bindings made before this app recorded provenance show their origin as "unknown" rather than blank. Computing matches is not part of this screen
  • Scope picker on the user associations screen: one field searches Nextcloud accounts, groups and Teams, and narrows the table to the accounts the chosen scope covers. Teams require the circles app; with it disabled the picker simply omits them. Typing without choosing a suggestion still filters by name, user ID or email
  • Match suggestions on the user associations screen: Suggest matches grades the selected accounts โ€” or the current page โ€” as exact, review, ambiguous or conflict, and Apply exact only binds the confident ones. Review rows show the Nextcloud and iTop names side by side for a one-click confirmation, ambiguous rows open a picker, and conflict rows name the account already holding that person and offer no action. An already-bound account is never re-bound by apply and gets no Apply or Confirm action โ€” moving someone to a different account stays an explicit unlink-then-apply. Matching runs only when asked, because each account costs one iTop request. Any unbound, non-excluded account can also be linked to a person manually โ€” via the same picker, pre-filled with candidates on an ambiguous row and otherwise opened empty to search โ€” without a match being found first, for the accounts the matcher has nothing to go on
  • Self-service discovery (POST /binding/discover): a third binding route lets a user link their own account from personal settings, with no administrator and no iTop personal token involved. It is off by default โ€” unlike administrator binding, which is backed by the administrator's own application token, and personal-token binding, where iTop itself resolves the token to its own contact, discovery lets the user's own attribute decide which identity they receive, so it starts opt-in and an administrator enables it from Admin settings โ†’ iTop
  • What discovery will and will not do: it binds only on an exact match โ€” where the matched attribute and the name agree. Review (names differ), ambiguous (several candidates) and conflict (person already linked to another account) each get their own explanation and point the user to an administrator; none of these ever names the matched person, so a result that cannot be linked automatically gives no clue who it almost matched. It never re-binds an already-linked account โ€” an administrator must unlink first. The discovery and confirmation endpoints take no parameters and are rate-limited to 5 calls per minute per user, and a successful bind is recorded in the audit log with the account, the person, the method (discovery) and the matched attribute. Personal settings shows only the binding methods an administrator has enabled, and offers discovery as the alternative for portal-only users who cannot obtain a personal token, pointing them to an administrator only when discovery is also disabled
  • An independent toggle for the existing personal-token route: on by default, to preserve current behaviour; the personal-token endpoint returns 403 when it is switched off
  • Admin-configured request-access links: two optional ServiceSubcategory ids โ€” one for "I have a problem" (Incident), one for "I need assistance" (User Request) โ€” let an administrator point users at the right iTop request form. The link appears only where a user cannot link their own account, pointing them to a way of asking for access instead of an administrator, and the user is offered exactly one of the two, chosen by what went wrong: being unable to link because of policy โ€” self-service is switched off, personal tokens are not issued to this profile, the account is excluded from matching โ€” is a service request, while trying to link and having it break โ€” discovery could not match the account, a token was rejected, iTop could not be reached โ€” is an incident. The two normally carry different SLAs, which is the reason for configuring two ids. Either, both or neither may be set; where the id a situation calls for is not set, no link and no hint are shown at all rather than the other one being offered, since that would file the wrong kind of ticket. Setting both ids to the same value stays supported for instances where one form covers both cases. Both ids are ignored, and no link is shown, until the instance URL is configured, since there is no base URL to build the link on
  • Person detail line on the user associations screen: a bound row now reads #16 Boris Vian over boris.vian@it.com ยท admin, beside an icon in the same slot the Nextcloud avatar occupies in the Account column โ€” so the two columns describe the same person in the same shape, instead of leaving an administrator to look a bare id up in iTop. The icon says whether that person is a service desk agent or a portal user; where neither can be established it stays empty rather than guessing, and the hover adds the iTop User id as #2 when one is known. Resolved for the whole page in batched queries rather than one per row, so the table costs no more iTop requests than it already did. A person iTop can no longer find is called out as a broken link; an unreachable iTop leaves the line blank instead, because that is transient and not something to go and repair

Changed

  • Admin settings reorganised: the sections an administrator uses day to day come first and connection setup moved to the bottom, since it is configured once. Before the connection is configured the page shows only that form. Identity binding and user associations are now a single "User associations" section listing the accounts with the matching rule beneath it, and chips under the page header jump to any section, with a back-to-top chip on each
  • Migrated off deprecated IConfig value APIs: IConfig::get/set/deleteAppValue has been deprecated since Nextcloud 29 in favour of IAppConfig, and the matching user preference methods since Nextcloud 33 in favour of IUserConfig. All ~200 call sites now use IAppConfig::getValueString/setValueString/deleteKey and IUserConfig::getValueString/setValueString/deleteUserConfig. IConfig is still used for getSystemValue, which is not deprecated
  • String accessors used deliberately: the typed getValueInt/getValueBool variants are intentionally not used. Existing values are stored as VALUE_MIXED, which reads safely under any getter, but the first typed write pins a config key's type permanently โ€” a single missed call site would then raise AppConfigTypeConflictException at runtime. The string accessors preserve the previous behaviour exactly and leave typed accessors as a safe per-key follow-up
  • Controller routing flags moved to PHP attributes: @NoAdminRequired, @NoCSRFRequired and @PublicPage have been deprecated as PHPDoc annotations since Nextcloud 30 in favour of the OCP\AppFramework\Http\Attribute\* attributes. All 16 across the three remaining controllers were converted. Nextcloud logged one deprecation line per matched method per request, so an endpoint such as the CI class icon โ€” fetched once per class on every settings page load โ€” filled the log on instances running at a low log level. No endpoint's access level changed
  • Notifier registration moved to the bootstrap context: IManager::registerNotifierService() has been deprecated since Nextcloud 22; the notifier is now registered via IRegistrationContext, which also removes a service container lookup from the Application constructor
  • Replaced legacy OC globals in the settings bundles: OC.generateUrl โ†’ generateUrl (@nextcloud/router), OC.requestToken โ†’ getRequestToken() (@nextcloud/auth), OC.Notification.showTemporary โ†’ showSuccess/showError (@nextcloud/dialogs), and the window.t fallback โ†’ translate (@nextcloud/l10n). The request token is now read when each request's headers are built rather than cached at module load, so a rotated token is picked up
<hr />
  • The personal settings page no longer names iTop: every string a user sees there now uses the display name an administrator configured, so an instance rebranded to something else never shows the underlying product name to people who have never heard it. The default is still iTop, so an instance that has not been rebranded is unchanged. Two paragraphs aimed at administrators โ€” how to install the portal personal tokens extension, and which iTop configuration key allows token creation โ€” have been removed from that page entirely; they are not instructions the person reading their own settings can act on
  • Personal settings only shows what a linked account can act on: Search Settings, Notification Settings and Configuration Item Classes appear once the account is linked to a person, since none of them affect anything until it is. The Save button and the "Available features" list are likewise shown only where there is something to save or some way to link. Linking by personal token refreshes the page so the newly available settings appear straight away

Security

  • Cross-site scripting through iTop-supplied text: a person's name, email and organisation were written into the personal settings page as markup rather than text, and a ticket's caller name was built into a link in the reference widget the same way. Anyone able to edit those fields in iTop โ€” an agent, not necessarily an administrator โ€” could run script in the session of any Nextcloud user whose settings page loaded that person, or of everyone in a Talk room where such a ticket link was shared. Both now render as text, and a link whose URL is not http/https is dropped rather than followed. Present in earlier releases; upgrading is the fix
  • The personal-token endpoint is now rate limited to 5 calls per minute per user, with brute-force protection armed on a failed validation. It accepts a token supplied by the caller and makes up to two outbound iTop requests per call, so without a ceiling any signed-in account could use Nextcloud to guess iTop tokens and to generate load against the iTop instance

Fixed

  • Portal users with an additional profile were treated as back-end users: iTop confines a user to the front-end portal as soon as the Portal user profile is assigned โ€” the back office stays locked even when a back-end profile such as Service Desk Agent is also present. ProfileService::isPortalOnly() only reported portal-only when Portal user was the sole profile, so these users were misclassified. The consequences were that ticket links pointed at /pages/UI.php (the back office they cannot open) in widgets, rich previews and notifications; the agent dashboard widget and agent notifications were offered to them; and, because all queries run under the application token, searchCIs() and getCIPreview() skipped the contact-based scoping that portal users are meant to get and could return Configuration Items beyond the user's entitlement. Detection now keys on the profile being present at all. Portal power user is unaffected and still means a back-end user with portal access (typically Service Desk Agent + Portal power user), since the comparison is exact rather than a substring match
  • Cached portal status is recomputed on upgrade: a post-migration repair step clears is_portal_only and profiles_last_check for all users, so the corrected rule takes effect immediately instead of after the profile cache TTL lapses
  • Personal settings respects simple ticketing mode: in simple mode the ticket count endpoint no longer queries the Incident class (which does not exist there) or shows an Incidents: 0 row that could never be anything else; it shows a single ticket count instead

Known issue

  • occ user:setting <uid> integration_itop <key> <value> now fails with "conflict between new type (mixed) and old type (string)" for keys the app has already written. IUserConfig::setValueString() pins a key's type, while occ user:setting writes an untyped value; setValueMixed() is not public API, so this affects any app using IUserConfig on Nextcloud 32+. App behaviour is unaffected โ€” only manual administration. Workaround: occ user:setting <uid> integration_itop <key> --delete first, then set the value
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureLLIEfBPW8vgp0tZOZRrOgTRYypYWYopxng7Cc1s20D5vPFz7xEXLdDj60jkQG7kS4I+AfykgMZlUrOl5c8x6mE/rZQhZL8hQYFOI1eSH5MhFrLO/3BV8fHvAZrvQ4CaTjzOaQVaZNrwudzjiik2EhaQTY72JmsyWMNz/+BkklwnqGSMbZNK4A7AWJAcTATpIOWPFnnX+9KJK8YNfcqZy+1sC5AriI0I7xRVTu/WmwL0tCKiGqxS4/K764E+prlbmjXlYF20C/YELyoiy6kakawFLocvNPm2UtulKj7imPCaxAOOW8pxL0RptEtr6SiDasxCVcUqfgYIpUhDuuBfjMs1r67LxqE8zwQIz9nSlPLvQsAnS0/WAStc762TnPpUen6Q0ZVZKjoBm28vpuo7/0dRQNUFTF3de9B/CQHZKy3WiCAmVRinrGVN9CvkgpEz7WB8P9nu7XQeei1BZu/tLhfQiGoModgQKt2OapQapSHMkC41uMdwmAqDQXfIpXbIOeJynfgs/SLjibYypGIjdfwBb5U6YjOWB3bNxCSE/YWAONyOH7C6m81OevMkJP3ANHThUIgZkCE1LDfodji2VwuXJzGnw+ejNuC8LmPaOKpskQrSPwdbyq65EzAm5ZMK9ePJm9QOs9GXverHweXWmOYzEbThZhV/Fb+6FGO2AxLI=
Signature digestsha512
Dependencies
Required Nextcloud versions >=32.0.0,<36.0.0
Minimum Integer bits32
iTop Integration 1.4.3
Release Details
UpdatedSept. 26, 2026, 9:01 p.m.
Changelog

๐Ÿ”ง Nextcloud 35 Compatibility

Changed

  • Nextcloud 35 Support: Raised the supported max-version to 35 โ€” the app has been verified to run on Nextcloud 35 without code changes
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureaGErBYZ69ot3XEeyeAsN63ujSZcUgGHPl2ArM1J3qBV2GbKPqa9OGpzCmCY9JKRAPWvadu93hZ8JJ+ZyIFAoJSnt2MuNbN9JNyZY2DDkE6IjmQoV/KTLzm3zhe6Tk1pl+mbYSEtzGJBh4i2qyZq39w7bkRhKH3+aTbM7oZlJc+VQhE7NZ9B4F8npRv6YP9CsM7OVKBS1CWO6T3S6D6aUS/lBbPA41jwFDfto+04M0YSo71QdHbo1B2ZU9iyOBXLku+ZkzKkP6lJIaSq0YLJctwCbRA6N4c+qQG+mcmbeWK0Is6VcghuR7coUnGDR80AXH1jws0PrwGWK/61+PWcEyaqsnO+UOL6EDKCvMwpIN1MoVmgtJ1lpbvysr7MnJMhd+N1UFHcmIJxWd0on+XgbCDiPzApLlw50PaCt7PvXHnmr3IotbKyWl1rFEFEgcSead/WBSHUHXChdmdVu57fw2dm29Me1uvcgz1lMtoKV0WQWBlW5koK5H99KKWcIDdxQQ+QPBJfUDkWD1jq6mVZs1aUZb76RCJaw4e9TXwJhIm7RLoz9G3hMbCLxA2R+VKaROrEvzHyrZVQUPx7mG8Uyt00jb4yeT/lmgLxXYLtUJFSVluZj9Y2JsMyO7bXHcsCcHHanViJcYSvQyjqbZhtVJJy7LHlpuwZBwX4lvg+Meyc=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<36.0.0
Minimum Integer bits32
iTop Integration 1.4.2
Release Details
UpdatedAug. 11, 2026, 12:29 p.m.
Changelog

๐Ÿ”ง Compatibility Fixes

Fixed

  • Deprecated Exception in Notifier (#6): Notifier::prepare() now throws OCP\Notification\UnknownNotificationException instead of the deprecated plain InvalidArgumentException when a notification is not known to this notifier โ€” Nextcloud โ‰ฅ 30 logged a deprecation warning on every notifications API poll (e.g. from mobile clients or Unified Push) whenever other apps' notifications were processed
  • CI Links Missing Object ID: Smart picker and search results for Configuration Items produced iTop URLs with an empty id= parameter (only UserRequest links worked) โ€” CI queries use output_fields=*, which does not include the object id in iTop REST responses; the id is now taken from the response's key property in both the CI search and the preview mapper, so inserted links and previews point to the actual object
  • Custom CI Class Icons on Hardened Servers: Icon auto-discovery relied on the iTop web server exposing HTML directory listings of /datamodels/2.x/ โ€” standard production hardening (Options -Indexes) blocks these, so all custom CI classes silently fell back to the generic Peripheral icon; the installed module list is now fetched via the REST API (ModuleInstallation) and datamodel XML URLs are derived from the iTop naming convention, with directory listings only used as an enhancement when available; a failed discovery (empty definitions map) is no longer persisted for 24h, so icons recover on the next attempt instead of staying pinned to the fallback; on servers that block the datamodel XML files entirely, the admin settings now show a hint on the Custom CI Classes section naming the affected classes and the two remedies (allow the Nextcloud server to read the datamodel XMLs, or upload icons manually); class icons in the admin settings are now clickable to upload or overwrite a custom icon (SVG or PNG, max 256 KB) via the file picker
  • Localized iTop Date Formats: iTop installations with a customized date_and_time_format (e.g. d.m.Y) delivered localized date strings via the REST API, causing "Invalid Date" in the dashboard widgets, wrong ticket sorting, and broken SLA deadline calculations โ€” all REST responses are now normalized to Y-m-d H:i:s regardless of the server's locale configuration (supports ., /, and - separators in day-first, month-first, and year-first order), and the widgets fall back to the raw string instead of rendering "Invalid Date" for unparseable values
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignaturefId/QLAYQEVu5mLv0resY8nlf2XgkKbsnesc/bTdxlCm/xw1eU7oluiCkFaewbOoq9XEgOJbMeklp+bHzVP+L6jcwuU+yitvPV26TfYSSIsKoXk4nly1FAW4U2Dpf/ggx4JhNo7f3Wwop+25hJV7Dm083545eR8YgDHjARP9UmBJHgfJgo1drYHEEUnyGdRtd78GD+7mXJQMM3s8b48RTXvl7qH4F8gykVa/TXAGIBc/quSxG9+N6kxyAVyXT96oxUUOG3mJOfmqHGDplaYYYaWNoJI0AKkErnS2zemTLHbnKPqgx2l6OmA5UnL1JubRnbRyPPHvIGKayhuWvqvD5h90PxeirsAXvH8adM7SnMS8kpgu9zllkxmOrZvthOVOb64M8wUUVBxdHUvVZ7YcGc93GHyFtC0WQ0HbQ+IAtdZkfZz0zPY54TRhtdd9wfPfDCWLmqwIX0E28MhXV+9/bNTGiYd+MM6VHC5EioUxGS97aBC66bXyUt9vbHvA0lGDEPE58PDZCYwlhv3SqyKY1rtN8L73tWgxrgej9zKVQFpbR8az//W5DjZBTm2ef4+I0bL1nLBz1w0C2U69we2QcuV+rQkO+ohLBEN0NqYrmIeP6dEkie+N122wpN3uGN1ryDNew+PTu9DfIFvFBEqn23YRMb/EGypzMHj33aQpJaY=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<35.0.0
Minimum Integer bits32
iTop Integration 1.4.1
Release Details
UpdatedJuly 26, 2026, 2:08 p.m.
Changelog

๐Ÿ”ง Nextcloud 34 Compatibility, Token Setup Guidance & Release Polish

This release restores compatibility with Nextcloud 34, adds in-app guidance for the iTop personal token prerequisites, and fixes several issues found during the pre-release review of v1.4.0.

Added

  • iTop Configuration Hint (Admin Settings): New warning card explaining that agents need personal_tokens_allowed_profiles configured in iTop's Configuration File Editor before they can create personal tokens, including a ready-to-adapt $MyModuleSettings example
  • Personal Token Help (Personal Settings): Info hint shown when the "Personal Tokens" option is missing from the user's iTop account, pointing them to their iTop administrator

Fixed

  • Nextcloud 34 Compatibility: Replaced removed legacy \OC::$server->getURLGenerator() / getDatabaseConnection() calls with the modern \OCP\Server::get() API โ€” the deprecated shortcut methods were removed in Nextcloud 34, causing the admin and personal settings pages to abort mid-render with an Internal Server Error; also raised the supported max-version to 34
  • Broken Admin Settings CSS: Removed a stray unclosed .ticket-type-options rule that swallowed the new config-hint styles and duplicated an existing selector
  • Template Translation Mismatch: Removed embedded HTML from translatable strings in admin and personal settings templates so they match the locale catalogs (German translations now resolve correctly), and fixed a missing %s substitution that displayed literally instead of the instance name
  • Locale File Consistency: Synced 5 new strings from .js locale files into the .json catalogs for en, de, and de_DE (server-side rendering reads .json โ€” the strings would otherwise fall back to English)
  • Slow Custom CI Class Discovery: The ci-class-available endpoint re-crawled the entire iTop datamodel (one HTTP request per module directory and XML file) on every call โ€” the parsed class-definition map and a negative cache for undiscoverable icons are now persisted in appdata with a 24h TTL, reducing repeat loads from ~37s to under a second
  • Class Browser Not Updating: Newly added custom CI classes now disappear from the selection panel immediately after saving instead of remaining listed
  • Debug Leftover: Removed a stray console.log from the dashboard widget and rebuilt the frontend bundle
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureDQlRM1dgZb1GdPGTBChvKh27m38BBFoFPHhs7jIws7L07u1co5AeWtowwauS7srSh0q6ReEiu1AyFhqC9XXWMC3vwYRFhlnlP3fzMqA2Xi4UAwI989tAhMoixMa4ecisEEWqZ9fo6FZ4rrPgU5CmWVoosLnrdd3v0G/RsCW54d4QruNxspp1RNXWe5z76pecjPrhkASIe6a+YPPa2LJz56H6TxK4aRYtGQ67ODUKm/Yn+F/ctU4hVuol38f68T2QKL0WH48eYXBV8y8D0u1hYMm3CMVeB4McxTaSkYenMOcYOxbjLTGBS6Nk/KJzvab6gi4xB/VzbvWFu5Kz7i2Va9XabBnUSOBsaBLMYf1uM+62wdxFnUFi9pc+dHpB0Pz+WBmtDA7t/YnSrZQk8KVnbUef5Rd8CIopHxMoI9BKQfMlsuLg6zbNx6hsFN/kN9mbhei3U+VfZ5ryyu3bMpZ2a4VlECvZB1h+V271LXdjNviqVWBwSrJPNOVhaPpEYn49HbOJ4FWF+ZIncMIP/VVcfWNLganCJ49ffzCZUIFffGRbxpzbYvuh8NiWqwVGb841B8QoM27MgTH5dq0HYVaB0o8mcpOYRpLtC933L0vDrldYIzrS0hGP4E+nAU0PYpuigY2bfrswWYuhvrHNF1EcrfqqW8vW2XT8L6jrNUutNXw=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<35.0.0
Minimum Integer bits32

Nextcloud 32

iTop Integration 1.5.0
Release Details
UpdatedOct. 26, 2026, 11:34 p.m.
Changelog

๐Ÿ”— Identity Binding & Deprecated API Cleanup

โš ๏ธ Breaking

  • Minimum Nextcloud version is now 32: OCP\Config\IUserConfig is only available from Nextcloud 32 onwards, so the user preference migration below raises min-version from 30 to 32. Nextcloud 30 and 31 are no longer supported

Added

  • Admin-side identity binding (occ itop:bind): administrators can link Nextcloud accounts to their iTop person without those users touching iTop. This is the only route available to portal-only users, because iTop issues personal tokens to back-end users only. Matching is controlled by an admin-configured source attribute (Nextcloud email, user ID or display name) and target (Person.email, Person.employee_number or User.login), and results are graded: exact (attribute and name agree) is bindable, review (names differ) needs explicit confirmation, ambiguous (several candidates) is never guessed, none is reported. The command is dry-run by default and requires --apply to write; accounts can be excluded from matching entirely. A failing account is reported and skipped rather than aborting the batch, and the command warns when --limit leaves accounts unexamined. A person already linked to another Nextcloud account is graded conflict and never bound automatically, on any path โ€” person_id is the authorisation boundary for ticket and CI access, so two accounts holding one person would mean each seeing the other's tickets
  • Identity binding settings and API: the matching rule (which Nextcloud attribute is matched against which iTop attribute) is now configurable from Admin settings โ†’ iTop instead of only through occ config:app:set, and shows a warning when a risky attribute is selected, before the rule is saved. Adds admin endpoints for listing accounts with their binding state, managing exclusions, and unbinding, which the association table builds on
  • User associations screen: Admin settings โ†’ iTop now lists every Nextcloud account with its iTop binding state and avatar, filterable by all / unbound / bound / excluded and searchable by name, user ID or email. Accounts can be excluded from matching (individually or in bulk) and links can be removed. Bindings made before this app recorded provenance show their origin as "unknown" rather than blank. Computing matches is not part of this screen
  • Scope picker on the user associations screen: one field searches Nextcloud accounts, groups and Teams, and narrows the table to the accounts the chosen scope covers. Teams require the circles app; with it disabled the picker simply omits them. Typing without choosing a suggestion still filters by name, user ID or email
  • Match suggestions on the user associations screen: Suggest matches grades the selected accounts โ€” or the current page โ€” as exact, review, ambiguous or conflict, and Apply exact only binds the confident ones. Review rows show the Nextcloud and iTop names side by side for a one-click confirmation, ambiguous rows open a picker, and conflict rows name the account already holding that person and offer no action. An already-bound account is never re-bound by apply and gets no Apply or Confirm action โ€” moving someone to a different account stays an explicit unlink-then-apply. Matching runs only when asked, because each account costs one iTop request. Any unbound, non-excluded account can also be linked to a person manually โ€” via the same picker, pre-filled with candidates on an ambiguous row and otherwise opened empty to search โ€” without a match being found first, for the accounts the matcher has nothing to go on
  • Self-service discovery (POST /binding/discover): a third binding route lets a user link their own account from personal settings, with no administrator and no iTop personal token involved. It is off by default โ€” unlike administrator binding, which is backed by the administrator's own application token, and personal-token binding, where iTop itself resolves the token to its own contact, discovery lets the user's own attribute decide which identity they receive, so it starts opt-in and an administrator enables it from Admin settings โ†’ iTop
  • What discovery will and will not do: it binds only on an exact match โ€” where the matched attribute and the name agree. Review (names differ), ambiguous (several candidates) and conflict (person already linked to another account) each get their own explanation and point the user to an administrator; none of these ever names the matched person, so a result that cannot be linked automatically gives no clue who it almost matched. It never re-binds an already-linked account โ€” an administrator must unlink first. The discovery and confirmation endpoints take no parameters and are rate-limited to 5 calls per minute per user, and a successful bind is recorded in the audit log with the account, the person, the method (discovery) and the matched attribute. Personal settings shows only the binding methods an administrator has enabled, and offers discovery as the alternative for portal-only users who cannot obtain a personal token, pointing them to an administrator only when discovery is also disabled
  • An independent toggle for the existing personal-token route: on by default, to preserve current behaviour; the personal-token endpoint returns 403 when it is switched off
  • Admin-configured request-access links: two optional ServiceSubcategory ids โ€” one for "I have a problem" (Incident), one for "I need assistance" (User Request) โ€” let an administrator point users at the right iTop request form. The link appears only where a user cannot link their own account, pointing them to a way of asking for access instead of an administrator, and the user is offered exactly one of the two, chosen by what went wrong: being unable to link because of policy โ€” self-service is switched off, personal tokens are not issued to this profile, the account is excluded from matching โ€” is a service request, while trying to link and having it break โ€” discovery could not match the account, a token was rejected, iTop could not be reached โ€” is an incident. The two normally carry different SLAs, which is the reason for configuring two ids. Either, both or neither may be set; where the id a situation calls for is not set, no link and no hint are shown at all rather than the other one being offered, since that would file the wrong kind of ticket. Setting both ids to the same value stays supported for instances where one form covers both cases. Both ids are ignored, and no link is shown, until the instance URL is configured, since there is no base URL to build the link on
  • Person detail line on the user associations screen: a bound row now reads #16 Boris Vian over boris.vian@it.com ยท admin, beside an icon in the same slot the Nextcloud avatar occupies in the Account column โ€” so the two columns describe the same person in the same shape, instead of leaving an administrator to look a bare id up in iTop. The icon says whether that person is a service desk agent or a portal user; where neither can be established it stays empty rather than guessing, and the hover adds the iTop User id as #2 when one is known. Resolved for the whole page in batched queries rather than one per row, so the table costs no more iTop requests than it already did. A person iTop can no longer find is called out as a broken link; an unreachable iTop leaves the line blank instead, because that is transient and not something to go and repair

Changed

  • Admin settings reorganised: the sections an administrator uses day to day come first and connection setup moved to the bottom, since it is configured once. Before the connection is configured the page shows only that form. Identity binding and user associations are now a single "User associations" section listing the accounts with the matching rule beneath it, and chips under the page header jump to any section, with a back-to-top chip on each
  • Migrated off deprecated IConfig value APIs: IConfig::get/set/deleteAppValue has been deprecated since Nextcloud 29 in favour of IAppConfig, and the matching user preference methods since Nextcloud 33 in favour of IUserConfig. All ~200 call sites now use IAppConfig::getValueString/setValueString/deleteKey and IUserConfig::getValueString/setValueString/deleteUserConfig. IConfig is still used for getSystemValue, which is not deprecated
  • String accessors used deliberately: the typed getValueInt/getValueBool variants are intentionally not used. Existing values are stored as VALUE_MIXED, which reads safely under any getter, but the first typed write pins a config key's type permanently โ€” a single missed call site would then raise AppConfigTypeConflictException at runtime. The string accessors preserve the previous behaviour exactly and leave typed accessors as a safe per-key follow-up
  • Controller routing flags moved to PHP attributes: @NoAdminRequired, @NoCSRFRequired and @PublicPage have been deprecated as PHPDoc annotations since Nextcloud 30 in favour of the OCP\AppFramework\Http\Attribute\* attributes. All 16 across the three remaining controllers were converted. Nextcloud logged one deprecation line per matched method per request, so an endpoint such as the CI class icon โ€” fetched once per class on every settings page load โ€” filled the log on instances running at a low log level. No endpoint's access level changed
  • Notifier registration moved to the bootstrap context: IManager::registerNotifierService() has been deprecated since Nextcloud 22; the notifier is now registered via IRegistrationContext, which also removes a service container lookup from the Application constructor
  • Replaced legacy OC globals in the settings bundles: OC.generateUrl โ†’ generateUrl (@nextcloud/router), OC.requestToken โ†’ getRequestToken() (@nextcloud/auth), OC.Notification.showTemporary โ†’ showSuccess/showError (@nextcloud/dialogs), and the window.t fallback โ†’ translate (@nextcloud/l10n). The request token is now read when each request's headers are built rather than cached at module load, so a rotated token is picked up
<hr />
  • The personal settings page no longer names iTop: every string a user sees there now uses the display name an administrator configured, so an instance rebranded to something else never shows the underlying product name to people who have never heard it. The default is still iTop, so an instance that has not been rebranded is unchanged. Two paragraphs aimed at administrators โ€” how to install the portal personal tokens extension, and which iTop configuration key allows token creation โ€” have been removed from that page entirely; they are not instructions the person reading their own settings can act on
  • Personal settings only shows what a linked account can act on: Search Settings, Notification Settings and Configuration Item Classes appear once the account is linked to a person, since none of them affect anything until it is. The Save button and the "Available features" list are likewise shown only where there is something to save or some way to link. Linking by personal token refreshes the page so the newly available settings appear straight away

Security

  • Cross-site scripting through iTop-supplied text: a person's name, email and organisation were written into the personal settings page as markup rather than text, and a ticket's caller name was built into a link in the reference widget the same way. Anyone able to edit those fields in iTop โ€” an agent, not necessarily an administrator โ€” could run script in the session of any Nextcloud user whose settings page loaded that person, or of everyone in a Talk room where such a ticket link was shared. Both now render as text, and a link whose URL is not http/https is dropped rather than followed. Present in earlier releases; upgrading is the fix
  • The personal-token endpoint is now rate limited to 5 calls per minute per user, with brute-force protection armed on a failed validation. It accepts a token supplied by the caller and makes up to two outbound iTop requests per call, so without a ceiling any signed-in account could use Nextcloud to guess iTop tokens and to generate load against the iTop instance

Fixed

  • Portal users with an additional profile were treated as back-end users: iTop confines a user to the front-end portal as soon as the Portal user profile is assigned โ€” the back office stays locked even when a back-end profile such as Service Desk Agent is also present. ProfileService::isPortalOnly() only reported portal-only when Portal user was the sole profile, so these users were misclassified. The consequences were that ticket links pointed at /pages/UI.php (the back office they cannot open) in widgets, rich previews and notifications; the agent dashboard widget and agent notifications were offered to them; and, because all queries run under the application token, searchCIs() and getCIPreview() skipped the contact-based scoping that portal users are meant to get and could return Configuration Items beyond the user's entitlement. Detection now keys on the profile being present at all. Portal power user is unaffected and still means a back-end user with portal access (typically Service Desk Agent + Portal power user), since the comparison is exact rather than a substring match
  • Cached portal status is recomputed on upgrade: a post-migration repair step clears is_portal_only and profiles_last_check for all users, so the corrected rule takes effect immediately instead of after the profile cache TTL lapses
  • Personal settings respects simple ticketing mode: in simple mode the ticket count endpoint no longer queries the Incident class (which does not exist there) or shows an Incidents: 0 row that could never be anything else; it shows a single ticket count instead

Known issue

  • occ user:setting <uid> integration_itop <key> <value> now fails with "conflict between new type (mixed) and old type (string)" for keys the app has already written. IUserConfig::setValueString() pins a key's type, while occ user:setting writes an untyped value; setValueMixed() is not public API, so this affects any app using IUserConfig on Nextcloud 32+. App behaviour is unaffected โ€” only manual administration. Workaround: occ user:setting <uid> integration_itop <key> --delete first, then set the value
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureLLIEfBPW8vgp0tZOZRrOgTRYypYWYopxng7Cc1s20D5vPFz7xEXLdDj60jkQG7kS4I+AfykgMZlUrOl5c8x6mE/rZQhZL8hQYFOI1eSH5MhFrLO/3BV8fHvAZrvQ4CaTjzOaQVaZNrwudzjiik2EhaQTY72JmsyWMNz/+BkklwnqGSMbZNK4A7AWJAcTATpIOWPFnnX+9KJK8YNfcqZy+1sC5AriI0I7xRVTu/WmwL0tCKiGqxS4/K764E+prlbmjXlYF20C/YELyoiy6kakawFLocvNPm2UtulKj7imPCaxAOOW8pxL0RptEtr6SiDasxCVcUqfgYIpUhDuuBfjMs1r67LxqE8zwQIz9nSlPLvQsAnS0/WAStc762TnPpUen6Q0ZVZKjoBm28vpuo7/0dRQNUFTF3de9B/CQHZKy3WiCAmVRinrGVN9CvkgpEz7WB8P9nu7XQeei1BZu/tLhfQiGoModgQKt2OapQapSHMkC41uMdwmAqDQXfIpXbIOeJynfgs/SLjibYypGIjdfwBb5U6YjOWB3bNxCSE/YWAONyOH7C6m81OevMkJP3ANHThUIgZkCE1LDfodji2VwuXJzGnw+ejNuC8LmPaOKpskQrSPwdbyq65EzAm5ZMK9ePJm9QOs9GXverHweXWmOYzEbThZhV/Fb+6FGO2AxLI=
Signature digestsha512
Dependencies
Required Nextcloud versions >=32.0.0,<36.0.0
Minimum Integer bits32
iTop Integration 1.4.3
Release Details
UpdatedSept. 26, 2026, 9:01 p.m.
Changelog

๐Ÿ”ง Nextcloud 35 Compatibility

Changed

  • Nextcloud 35 Support: Raised the supported max-version to 35 โ€” the app has been verified to run on Nextcloud 35 without code changes
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureaGErBYZ69ot3XEeyeAsN63ujSZcUgGHPl2ArM1J3qBV2GbKPqa9OGpzCmCY9JKRAPWvadu93hZ8JJ+ZyIFAoJSnt2MuNbN9JNyZY2DDkE6IjmQoV/KTLzm3zhe6Tk1pl+mbYSEtzGJBh4i2qyZq39w7bkRhKH3+aTbM7oZlJc+VQhE7NZ9B4F8npRv6YP9CsM7OVKBS1CWO6T3S6D6aUS/lBbPA41jwFDfto+04M0YSo71QdHbo1B2ZU9iyOBXLku+ZkzKkP6lJIaSq0YLJctwCbRA6N4c+qQG+mcmbeWK0Is6VcghuR7coUnGDR80AXH1jws0PrwGWK/61+PWcEyaqsnO+UOL6EDKCvMwpIN1MoVmgtJ1lpbvysr7MnJMhd+N1UFHcmIJxWd0on+XgbCDiPzApLlw50PaCt7PvXHnmr3IotbKyWl1rFEFEgcSead/WBSHUHXChdmdVu57fw2dm29Me1uvcgz1lMtoKV0WQWBlW5koK5H99KKWcIDdxQQ+QPBJfUDkWD1jq6mVZs1aUZb76RCJaw4e9TXwJhIm7RLoz9G3hMbCLxA2R+VKaROrEvzHyrZVQUPx7mG8Uyt00jb4yeT/lmgLxXYLtUJFSVluZj9Y2JsMyO7bXHcsCcHHanViJcYSvQyjqbZhtVJJy7LHlpuwZBwX4lvg+Meyc=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<36.0.0
Minimum Integer bits32
iTop Integration 1.4.2
Release Details
UpdatedAug. 11, 2026, 12:29 p.m.
Changelog

๐Ÿ”ง Compatibility Fixes

Fixed

  • Deprecated Exception in Notifier (#6): Notifier::prepare() now throws OCP\Notification\UnknownNotificationException instead of the deprecated plain InvalidArgumentException when a notification is not known to this notifier โ€” Nextcloud โ‰ฅ 30 logged a deprecation warning on every notifications API poll (e.g. from mobile clients or Unified Push) whenever other apps' notifications were processed
  • CI Links Missing Object ID: Smart picker and search results for Configuration Items produced iTop URLs with an empty id= parameter (only UserRequest links worked) โ€” CI queries use output_fields=*, which does not include the object id in iTop REST responses; the id is now taken from the response's key property in both the CI search and the preview mapper, so inserted links and previews point to the actual object
  • Custom CI Class Icons on Hardened Servers: Icon auto-discovery relied on the iTop web server exposing HTML directory listings of /datamodels/2.x/ โ€” standard production hardening (Options -Indexes) blocks these, so all custom CI classes silently fell back to the generic Peripheral icon; the installed module list is now fetched via the REST API (ModuleInstallation) and datamodel XML URLs are derived from the iTop naming convention, with directory listings only used as an enhancement when available; a failed discovery (empty definitions map) is no longer persisted for 24h, so icons recover on the next attempt instead of staying pinned to the fallback; on servers that block the datamodel XML files entirely, the admin settings now show a hint on the Custom CI Classes section naming the affected classes and the two remedies (allow the Nextcloud server to read the datamodel XMLs, or upload icons manually); class icons in the admin settings are now clickable to upload or overwrite a custom icon (SVG or PNG, max 256 KB) via the file picker
  • Localized iTop Date Formats: iTop installations with a customized date_and_time_format (e.g. d.m.Y) delivered localized date strings via the REST API, causing "Invalid Date" in the dashboard widgets, wrong ticket sorting, and broken SLA deadline calculations โ€” all REST responses are now normalized to Y-m-d H:i:s regardless of the server's locale configuration (supports ., /, and - separators in day-first, month-first, and year-first order), and the widgets fall back to the raw string instead of rendering "Invalid Date" for unparseable values
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignaturefId/QLAYQEVu5mLv0resY8nlf2XgkKbsnesc/bTdxlCm/xw1eU7oluiCkFaewbOoq9XEgOJbMeklp+bHzVP+L6jcwuU+yitvPV26TfYSSIsKoXk4nly1FAW4U2Dpf/ggx4JhNo7f3Wwop+25hJV7Dm083545eR8YgDHjARP9UmBJHgfJgo1drYHEEUnyGdRtd78GD+7mXJQMM3s8b48RTXvl7qH4F8gykVa/TXAGIBc/quSxG9+N6kxyAVyXT96oxUUOG3mJOfmqHGDplaYYYaWNoJI0AKkErnS2zemTLHbnKPqgx2l6OmA5UnL1JubRnbRyPPHvIGKayhuWvqvD5h90PxeirsAXvH8adM7SnMS8kpgu9zllkxmOrZvthOVOb64M8wUUVBxdHUvVZ7YcGc93GHyFtC0WQ0HbQ+IAtdZkfZz0zPY54TRhtdd9wfPfDCWLmqwIX0E28MhXV+9/bNTGiYd+MM6VHC5EioUxGS97aBC66bXyUt9vbHvA0lGDEPE58PDZCYwlhv3SqyKY1rtN8L73tWgxrgej9zKVQFpbR8az//W5DjZBTm2ef4+I0bL1nLBz1w0C2U69we2QcuV+rQkO+ohLBEN0NqYrmIeP6dEkie+N122wpN3uGN1ryDNew+PTu9DfIFvFBEqn23YRMb/EGypzMHj33aQpJaY=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<35.0.0
Minimum Integer bits32
iTop Integration 1.4.1
Release Details
UpdatedJuly 26, 2026, 2:08 p.m.
Changelog

๐Ÿ”ง Nextcloud 34 Compatibility, Token Setup Guidance & Release Polish

This release restores compatibility with Nextcloud 34, adds in-app guidance for the iTop personal token prerequisites, and fixes several issues found during the pre-release review of v1.4.0.

Added

  • iTop Configuration Hint (Admin Settings): New warning card explaining that agents need personal_tokens_allowed_profiles configured in iTop's Configuration File Editor before they can create personal tokens, including a ready-to-adapt $MyModuleSettings example
  • Personal Token Help (Personal Settings): Info hint shown when the "Personal Tokens" option is missing from the user's iTop account, pointing them to their iTop administrator

Fixed

  • Nextcloud 34 Compatibility: Replaced removed legacy \OC::$server->getURLGenerator() / getDatabaseConnection() calls with the modern \OCP\Server::get() API โ€” the deprecated shortcut methods were removed in Nextcloud 34, causing the admin and personal settings pages to abort mid-render with an Internal Server Error; also raised the supported max-version to 34
  • Broken Admin Settings CSS: Removed a stray unclosed .ticket-type-options rule that swallowed the new config-hint styles and duplicated an existing selector
  • Template Translation Mismatch: Removed embedded HTML from translatable strings in admin and personal settings templates so they match the locale catalogs (German translations now resolve correctly), and fixed a missing %s substitution that displayed literally instead of the instance name
  • Locale File Consistency: Synced 5 new strings from .js locale files into the .json catalogs for en, de, and de_DE (server-side rendering reads .json โ€” the strings would otherwise fall back to English)
  • Slow Custom CI Class Discovery: The ci-class-available endpoint re-crawled the entire iTop datamodel (one HTTP request per module directory and XML file) on every call โ€” the parsed class-definition map and a negative cache for undiscoverable icons are now persisted in appdata with a 24h TTL, reducing repeat loads from ~37s to under a second
  • Class Browser Not Updating: Newly added custom CI classes now disappear from the selection panel immediately after saving instead of remaining listed
  • Debug Leftover: Removed a stray console.log from the dashboard widget and rebuilt the frontend bundle
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureDQlRM1dgZb1GdPGTBChvKh27m38BBFoFPHhs7jIws7L07u1co5AeWtowwauS7srSh0q6ReEiu1AyFhqC9XXWMC3vwYRFhlnlP3fzMqA2Xi4UAwI989tAhMoixMa4ecisEEWqZ9fo6FZ4rrPgU5CmWVoosLnrdd3v0G/RsCW54d4QruNxspp1RNXWe5z76pecjPrhkASIe6a+YPPa2LJz56H6TxK4aRYtGQ67ODUKm/Yn+F/ctU4hVuol38f68T2QKL0WH48eYXBV8y8D0u1hYMm3CMVeB4McxTaSkYenMOcYOxbjLTGBS6Nk/KJzvab6gi4xB/VzbvWFu5Kz7i2Va9XabBnUSOBsaBLMYf1uM+62wdxFnUFi9pc+dHpB0Pz+WBmtDA7t/YnSrZQk8KVnbUef5Rd8CIopHxMoI9BKQfMlsuLg6zbNx6hsFN/kN9mbhei3U+VfZ5ryyu3bMpZ2a4VlECvZB1h+V271LXdjNviqVWBwSrJPNOVhaPpEYn49HbOJ4FWF+ZIncMIP/VVcfWNLganCJ49ffzCZUIFffGRbxpzbYvuh8NiWqwVGb841B8QoM27MgTH5dq0HYVaB0o8mcpOYRpLtC933L0vDrldYIzrS0hGP4E+nAU0PYpuigY2bfrswWYuhvrHNF1EcrfqqW8vW2XT8L6jrNUutNXw=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<35.0.0
Minimum Integer bits32
iTop Integration 1.3.1
Release Details
UpdatedNov. 9, 2025, 4:15 p.m.
Changelog

๐Ÿ”’ Security Hardening

This release includes important security enhancements to strengthen the application's defenses.

Changed

  • Replaced direct cURL usage with Nextcloud's IClientService for proper SSL certificate verification
  • Enhanced input validation and sanitization for OQL query parameters
  • Improved data validation for numeric identifiers

Security

  • Resolved issues related to network communication security
  • Strengthened protection against malicious input in database queries
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignaturelnQXKW/X1W4wzcMo2KRpEnsnPE+X3WtmgNn4YwtcagfRqtmdmXPJ/y+tv3P4FmMqn59c+fXHdKGkA8mx5pAp1xLl4sDw++/toeXrTAdVI6gfMeoNuKGNqrOGTRfxYoQ47zR6Oz7mmw18uDNbF6tzTEmzn3zHrwJFopziUVls2p/ZNk5lAPqpStmYnlZplx1/av4UjtMDQ5oHHArkjrGscon7cXsKHXTDjBQqTm43AgvpmTysqZKOCDRz2R9Ng122tFxw5ykn8ZSe1fT7ZG16x6S+XawsPsQKUQ+BCDAb7QkkauDPKIoZPXbuLwMl4PCQErwmq23shI5hYtrdq7uBo6XZOtjlgW5YQSm3zoAM4lXVpQSoDFn2ogup1pPOGE/flYqhTijCpuOGMzAxdvCz7/IzC9vjBwc6ML3M+2Ohf0TJKFVL4WeRWclCiy4kAy/BpXN88Dq9yiKVOMbiVD1UZuFdyGRiEYYvFrK8zt387nwtJ7yfi73lNKMm1Z0/zqfEPrdrDtGa6PtVABqPhiSsV7SAOZIJr+frx1YoYYRkTnB8EB/MzPU9QebTSduJr4yVw+Rz+4a+4w0bX7zy3DUoRMlBbrluGA2VcMWacbdEVpCrrESdvwwEFMPyjlVh2yrGj2/qGf7YfFBvtQF7aJbod826WLbqAy4rtfkEKOqwZd0=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<33.0.0
Minimum Integer bits32
iTop Integration 1.3.0
Release Details
UpdatedNov. 8, 2025, 6:12 p.m.
Changelog

โœจ Major New Feature: Agent Notifications System

Version 1.3.0 introduces a comprehensive notification system with 12 notification types across two independent tracks: Portal (4 types) and Agent (8 types). The system provides smart, event-driven notifications with weekend-aware SLA warnings and zero duplicate detection.

Added

Agent Notification System (8 Types)

  • Ticket Assignment Tracking:
  • ticket_assigned: New tickets assigned to you from unassigned state
  • ticket_reassigned: Tickets reassigned to you from another agent
  • team_unassigned_new: New unassigned tickets appearing in your team's queue

  • SLA Management:

  • ticket_tto_warning: Time To Own SLA warnings with escalating urgency (โฐ 24h โ†’ โš ๏ธ 12h โ†’ ๐ŸŸ  4h โ†’ ๐Ÿ”ด 1h)
  • ticket_ttr_warning: Time To Resolve SLA warnings with same escalation pattern
  • ticket_sla_breach: SLA deadline exceeded alerts (๐Ÿšจ icon)
  • Weekend-Aware Logic: Friday uses 72h threshold, Saturday uses 48h threshold to catch Monday/Tuesday breaches

  • Priority & Comments:

  • ticket_priority_critical: Automatic alerts when tickets escalate to critical priority (๐Ÿ”ด icon)
  • ticket_comment: New comments on your tickets (both public and private log types)

Portal Notification Enhancements

  • Portal notifications (from v1.2.2) now fully integrated with agent system:
  • ticket_status_changed: Status transitions
  • agent_responded: Public comments from agents
  • ticket_resolved: Resolution notifications
  • agent_assigned: Agent assignment changes

Background Job Infrastructure

  • CheckAgentTicketUpdates: New background job running every 5 minutes
  • Processes all 8 agent notification types
  • Portal-only filtering (skips users with is_portal_only='1')
  • Per-user interval checking (5-1440 minutes configurable)
  • Query optimization (skips API calls when notification types disabled)
  • Rate limiting (max 20 notifications per user per run)

  • CheckPortalTicketUpdates: Existing job (enhanced)

  • Improved query optimization
  • Better timestamp handling
  • Contact role filtering support

Admin Configuration

  • 3-State Notification Control: Configure each notification type independently
  • Disabled: Not available to users (hidden)
  • Forced: Mandatory for all users (no opt-out)
  • User Choice: Enabled by default, users can opt-out

  • Default Configuration:

  • Portal: All 4 types set to "User Choice"
  • Agent: 6 types "User Choice", 2 types "Forced" (SLA breach, priority critical)

  • Configurable Intervals:

  • Admin default: 5-1440 minutes (recommended: 15 minutes)
  • Per-user override available in personal settings

OCC Commands

  • Enhanced itop:notifications:test-user:
  • New --agent flag for testing agent notifications
  • New --portal flag for testing portal notifications (default)
  • --reset flag to clear timestamps and force full re-check
  • Displays user configuration, enabled notifications, and next execution time

API & Services

  • New ItopAPIService Methods:
  • getAgentTicketIds(): Get tickets assigned to agent
  • getTicketsApproachingDeadline(): SLA warning detection with crossing-time algorithm
  • getTeamAssignmentChanges(): Detect new unassigned team tickets
  • applyCrossingTimeAlgorithm(): Weekend-aware threshold calculation (private)

  • Team Detection:

  • Leverages existing getUserTeams() method
  • Tracks team_id changes via CMDBChangeOp
  • Verifies tickets remain unassigned (agent_id = NULL/0)

Documentation

  • New docs/NOTIFICATIONS.md: Comprehensive 345-line user & admin guide
  • Complete notification type reference with examples
  • Setup instructions for users and administrators
  • Troubleshooting section with common issues
  • FAQ with 12 frequently asked questions
  • Technical architecture details

Changed

Notification Algorithm Improvements

  • SLA Crossing-Time Algorithm: Detects threshold crossings without storing per-ticket state
  • Eliminates duplicate warnings for same SLA level
  • Dynamically calculates when each threshold (24h/12h/4h/1h) will be crossed
  • Only notifies most urgent level if multiple thresholds crossed
  • Weekend expansion: Friday (72h), Saturday (48h) for 24h threshold

  • Notification Deduplication:

  • Unique object keys: ticket_id|subject|timestamp_hash
  • Timestamp filtering prevents re-processing old changes
  • Leverages Nextcloud's native duplicate prevention

User Experience

  • Personal Settings UI: Agent notifications section (only visible to non-portal users)
  • Master toggle for agent notifications
  • Granular per-type checkboxes (only "User Choice" types shown)
  • Info box listing "Forced" notifications that cannot be disabled
  • Integrated with existing portal notification settings

  • Notification Display:

  • Escalating emoji icons based on urgency (SLA warnings)
  • Clear differentiation between public and private comments
  • Team name included in team ticket notifications
  • Clickable links route to appropriate iTop interface (portal vs admin UI)

Technical Details

New Configuration Keys (oc_appconfig)

  • agent_notification_config: JSON map of notification type โ†’ state (disabled/forced/user_choice)
  • default_notification_interval: Default check interval for all users (minutes, default: 15)

New User Preferences (oc_preferences)

  • notification_last_agent_check: Unix timestamp of last agent notification check
  • disabled_agent_notifications: JSON array of disabled notification types OR "all"
  • notification_check_interval: Per-user custom interval (minutes)

Architecture Highlights

  • Dual Background Jobs: Portal and Agent jobs run independently
  • CMDBChangeOp Detection: Leverages iTop's built-in change tracking (no external state)
  • Minimal State Storage: Only timestamps per user (no per-ticket data)
  • Query Optimization: Early exit if all notifications disabled, selective API calls
  • Portal-Only Filtering: Agent job automatically skips portal-only users

Performance

  • Per-User Intervals: Users only processed when their interval elapses (reduces API load)
  • Query Optimization: Up to 100% reduction in API calls when notification types disabled
  • Rate Limiting: Max 20 notifications per user per run prevents spam
  • Smart Caching: Team memberships cached for 30 minutes, agent names for 24 hours

Translation Updates

  • Updated en.json, de.json, de_DE.json, fr.json with agent notification types

Breaking Changes

None - Existing portal notifications continue working without changes.

Migration Notes

  • No user action required: Portal notifications work as before
  • Agent detection automatic: Users with is_portal_only='0' gain agent notification access

See Also

<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureWBBeIspelxxeSl4ijI5xjEbBhaAP3KUyE5ZDmHGAOynl+pivkOzx524mIVKEiJPFsoA9xoKkhpn88sMOoDHTvT9L2zvlza+mVXcqc4G01pk5mRB55fAIJGsNvx6gPe7lV84F2H7IrZwpXcKFLY6pPmaHuP13Oc86w/TULtFfsDGXkuKRD2Z65Gf9VGLmUoSkGwXTRD+iPYgceP7XrY/J+iEQp91GBFXg+UriU6sQdNrRBUlGZkGrIYeuX1XGghBEWjfrFwwQJYDxtWh9Dp/TTdkkGwo8R3kf+KxsMPu+JxD34DKvU9OOHIIKbVeudFgKF/96qNYoZMh+vYWPRkX1i2e7NCNKLkTCIfXEd7Ocs8o2bjBdts1aGV6L0ujTAqsJU7ekm60g6/7YecTgvHP+Fz45hZ2T5kwVeLeiQuHwyUgDyrNIQ7iVXPDi8UpgU0tacGnOJBlWxopgQdBGUkRUzmjIhmpmDohz18QxiJIOsXMHIlraXKJrwMSzHB+mxMPxokS4KfqPKadGDJr/ziqQPfJk+UnbNCU881NZua2aaTJuVsrBv9KKB1hqerCE3tpz0ktm4ym66Emg2qn5P5I3PR7TFxyKzNDmymaLIEkacYsk1xrX6Jv/2nIwmrD4AwR0x9U0NtwE9FUb4JnWms8TyI81l+qZcIrDlHms1DTv+yM=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<33.0.0
Minimum Integer bits32

Nextcloud 31

iTop Integration 1.4.3
Release Details
UpdatedSept. 26, 2026, 9:01 p.m.
Changelog

๐Ÿ”ง Nextcloud 35 Compatibility

Changed

  • Nextcloud 35 Support: Raised the supported max-version to 35 โ€” the app has been verified to run on Nextcloud 35 without code changes
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureaGErBYZ69ot3XEeyeAsN63ujSZcUgGHPl2ArM1J3qBV2GbKPqa9OGpzCmCY9JKRAPWvadu93hZ8JJ+ZyIFAoJSnt2MuNbN9JNyZY2DDkE6IjmQoV/KTLzm3zhe6Tk1pl+mbYSEtzGJBh4i2qyZq39w7bkRhKH3+aTbM7oZlJc+VQhE7NZ9B4F8npRv6YP9CsM7OVKBS1CWO6T3S6D6aUS/lBbPA41jwFDfto+04M0YSo71QdHbo1B2ZU9iyOBXLku+ZkzKkP6lJIaSq0YLJctwCbRA6N4c+qQG+mcmbeWK0Is6VcghuR7coUnGDR80AXH1jws0PrwGWK/61+PWcEyaqsnO+UOL6EDKCvMwpIN1MoVmgtJ1lpbvysr7MnJMhd+N1UFHcmIJxWd0on+XgbCDiPzApLlw50PaCt7PvXHnmr3IotbKyWl1rFEFEgcSead/WBSHUHXChdmdVu57fw2dm29Me1uvcgz1lMtoKV0WQWBlW5koK5H99KKWcIDdxQQ+QPBJfUDkWD1jq6mVZs1aUZb76RCJaw4e9TXwJhIm7RLoz9G3hMbCLxA2R+VKaROrEvzHyrZVQUPx7mG8Uyt00jb4yeT/lmgLxXYLtUJFSVluZj9Y2JsMyO7bXHcsCcHHanViJcYSvQyjqbZhtVJJy7LHlpuwZBwX4lvg+Meyc=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<36.0.0
Minimum Integer bits32
iTop Integration 1.4.2
Release Details
UpdatedAug. 11, 2026, 12:29 p.m.
Changelog

๐Ÿ”ง Compatibility Fixes

Fixed

  • Deprecated Exception in Notifier (#6): Notifier::prepare() now throws OCP\Notification\UnknownNotificationException instead of the deprecated plain InvalidArgumentException when a notification is not known to this notifier โ€” Nextcloud โ‰ฅ 30 logged a deprecation warning on every notifications API poll (e.g. from mobile clients or Unified Push) whenever other apps' notifications were processed
  • CI Links Missing Object ID: Smart picker and search results for Configuration Items produced iTop URLs with an empty id= parameter (only UserRequest links worked) โ€” CI queries use output_fields=*, which does not include the object id in iTop REST responses; the id is now taken from the response's key property in both the CI search and the preview mapper, so inserted links and previews point to the actual object
  • Custom CI Class Icons on Hardened Servers: Icon auto-discovery relied on the iTop web server exposing HTML directory listings of /datamodels/2.x/ โ€” standard production hardening (Options -Indexes) blocks these, so all custom CI classes silently fell back to the generic Peripheral icon; the installed module list is now fetched via the REST API (ModuleInstallation) and datamodel XML URLs are derived from the iTop naming convention, with directory listings only used as an enhancement when available; a failed discovery (empty definitions map) is no longer persisted for 24h, so icons recover on the next attempt instead of staying pinned to the fallback; on servers that block the datamodel XML files entirely, the admin settings now show a hint on the Custom CI Classes section naming the affected classes and the two remedies (allow the Nextcloud server to read the datamodel XMLs, or upload icons manually); class icons in the admin settings are now clickable to upload or overwrite a custom icon (SVG or PNG, max 256 KB) via the file picker
  • Localized iTop Date Formats: iTop installations with a customized date_and_time_format (e.g. d.m.Y) delivered localized date strings via the REST API, causing "Invalid Date" in the dashboard widgets, wrong ticket sorting, and broken SLA deadline calculations โ€” all REST responses are now normalized to Y-m-d H:i:s regardless of the server's locale configuration (supports ., /, and - separators in day-first, month-first, and year-first order), and the widgets fall back to the raw string instead of rendering "Invalid Date" for unparseable values
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignaturefId/QLAYQEVu5mLv0resY8nlf2XgkKbsnesc/bTdxlCm/xw1eU7oluiCkFaewbOoq9XEgOJbMeklp+bHzVP+L6jcwuU+yitvPV26TfYSSIsKoXk4nly1FAW4U2Dpf/ggx4JhNo7f3Wwop+25hJV7Dm083545eR8YgDHjARP9UmBJHgfJgo1drYHEEUnyGdRtd78GD+7mXJQMM3s8b48RTXvl7qH4F8gykVa/TXAGIBc/quSxG9+N6kxyAVyXT96oxUUOG3mJOfmqHGDplaYYYaWNoJI0AKkErnS2zemTLHbnKPqgx2l6OmA5UnL1JubRnbRyPPHvIGKayhuWvqvD5h90PxeirsAXvH8adM7SnMS8kpgu9zllkxmOrZvthOVOb64M8wUUVBxdHUvVZ7YcGc93GHyFtC0WQ0HbQ+IAtdZkfZz0zPY54TRhtdd9wfPfDCWLmqwIX0E28MhXV+9/bNTGiYd+MM6VHC5EioUxGS97aBC66bXyUt9vbHvA0lGDEPE58PDZCYwlhv3SqyKY1rtN8L73tWgxrgej9zKVQFpbR8az//W5DjZBTm2ef4+I0bL1nLBz1w0C2U69we2QcuV+rQkO+ohLBEN0NqYrmIeP6dEkie+N122wpN3uGN1ryDNew+PTu9DfIFvFBEqn23YRMb/EGypzMHj33aQpJaY=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<35.0.0
Minimum Integer bits32
iTop Integration 1.4.1
Release Details
UpdatedJuly 26, 2026, 2:08 p.m.
Changelog

๐Ÿ”ง Nextcloud 34 Compatibility, Token Setup Guidance & Release Polish

This release restores compatibility with Nextcloud 34, adds in-app guidance for the iTop personal token prerequisites, and fixes several issues found during the pre-release review of v1.4.0.

Added

  • iTop Configuration Hint (Admin Settings): New warning card explaining that agents need personal_tokens_allowed_profiles configured in iTop's Configuration File Editor before they can create personal tokens, including a ready-to-adapt $MyModuleSettings example
  • Personal Token Help (Personal Settings): Info hint shown when the "Personal Tokens" option is missing from the user's iTop account, pointing them to their iTop administrator

Fixed

  • Nextcloud 34 Compatibility: Replaced removed legacy \OC::$server->getURLGenerator() / getDatabaseConnection() calls with the modern \OCP\Server::get() API โ€” the deprecated shortcut methods were removed in Nextcloud 34, causing the admin and personal settings pages to abort mid-render with an Internal Server Error; also raised the supported max-version to 34
  • Broken Admin Settings CSS: Removed a stray unclosed .ticket-type-options rule that swallowed the new config-hint styles and duplicated an existing selector
  • Template Translation Mismatch: Removed embedded HTML from translatable strings in admin and personal settings templates so they match the locale catalogs (German translations now resolve correctly), and fixed a missing %s substitution that displayed literally instead of the instance name
  • Locale File Consistency: Synced 5 new strings from .js locale files into the .json catalogs for en, de, and de_DE (server-side rendering reads .json โ€” the strings would otherwise fall back to English)
  • Slow Custom CI Class Discovery: The ci-class-available endpoint re-crawled the entire iTop datamodel (one HTTP request per module directory and XML file) on every call โ€” the parsed class-definition map and a negative cache for undiscoverable icons are now persisted in appdata with a 24h TTL, reducing repeat loads from ~37s to under a second
  • Class Browser Not Updating: Newly added custom CI classes now disappear from the selection panel immediately after saving instead of remaining listed
  • Debug Leftover: Removed a stray console.log from the dashboard widget and rebuilt the frontend bundle
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureDQlRM1dgZb1GdPGTBChvKh27m38BBFoFPHhs7jIws7L07u1co5AeWtowwauS7srSh0q6ReEiu1AyFhqC9XXWMC3vwYRFhlnlP3fzMqA2Xi4UAwI989tAhMoixMa4ecisEEWqZ9fo6FZ4rrPgU5CmWVoosLnrdd3v0G/RsCW54d4QruNxspp1RNXWe5z76pecjPrhkASIe6a+YPPa2LJz56H6TxK4aRYtGQ67ODUKm/Yn+F/ctU4hVuol38f68T2QKL0WH48eYXBV8y8D0u1hYMm3CMVeB4McxTaSkYenMOcYOxbjLTGBS6Nk/KJzvab6gi4xB/VzbvWFu5Kz7i2Va9XabBnUSOBsaBLMYf1uM+62wdxFnUFi9pc+dHpB0Pz+WBmtDA7t/YnSrZQk8KVnbUef5Rd8CIopHxMoI9BKQfMlsuLg6zbNx6hsFN/kN9mbhei3U+VfZ5ryyu3bMpZ2a4VlECvZB1h+V271LXdjNviqVWBwSrJPNOVhaPpEYn49HbOJ4FWF+ZIncMIP/VVcfWNLganCJ49ffzCZUIFffGRbxpzbYvuh8NiWqwVGb841B8QoM27MgTH5dq0HYVaB0o8mcpOYRpLtC933L0vDrldYIzrS0hGP4E+nAU0PYpuigY2bfrswWYuhvrHNF1EcrfqqW8vW2XT8L6jrNUutNXw=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<35.0.0
Minimum Integer bits32
iTop Integration 1.3.1
Release Details
UpdatedNov. 9, 2025, 4:15 p.m.
Changelog

๐Ÿ”’ Security Hardening

This release includes important security enhancements to strengthen the application's defenses.

Changed

  • Replaced direct cURL usage with Nextcloud's IClientService for proper SSL certificate verification
  • Enhanced input validation and sanitization for OQL query parameters
  • Improved data validation for numeric identifiers

Security

  • Resolved issues related to network communication security
  • Strengthened protection against malicious input in database queries
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignaturelnQXKW/X1W4wzcMo2KRpEnsnPE+X3WtmgNn4YwtcagfRqtmdmXPJ/y+tv3P4FmMqn59c+fXHdKGkA8mx5pAp1xLl4sDw++/toeXrTAdVI6gfMeoNuKGNqrOGTRfxYoQ47zR6Oz7mmw18uDNbF6tzTEmzn3zHrwJFopziUVls2p/ZNk5lAPqpStmYnlZplx1/av4UjtMDQ5oHHArkjrGscon7cXsKHXTDjBQqTm43AgvpmTysqZKOCDRz2R9Ng122tFxw5ykn8ZSe1fT7ZG16x6S+XawsPsQKUQ+BCDAb7QkkauDPKIoZPXbuLwMl4PCQErwmq23shI5hYtrdq7uBo6XZOtjlgW5YQSm3zoAM4lXVpQSoDFn2ogup1pPOGE/flYqhTijCpuOGMzAxdvCz7/IzC9vjBwc6ML3M+2Ohf0TJKFVL4WeRWclCiy4kAy/BpXN88Dq9yiKVOMbiVD1UZuFdyGRiEYYvFrK8zt387nwtJ7yfi73lNKMm1Z0/zqfEPrdrDtGa6PtVABqPhiSsV7SAOZIJr+frx1YoYYRkTnB8EB/MzPU9QebTSduJr4yVw+Rz+4a+4w0bX7zy3DUoRMlBbrluGA2VcMWacbdEVpCrrESdvwwEFMPyjlVh2yrGj2/qGf7YfFBvtQF7aJbod826WLbqAy4rtfkEKOqwZd0=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<33.0.0
Minimum Integer bits32
iTop Integration 1.3.0
Release Details
UpdatedNov. 8, 2025, 6:12 p.m.
Changelog

โœจ Major New Feature: Agent Notifications System

Version 1.3.0 introduces a comprehensive notification system with 12 notification types across two independent tracks: Portal (4 types) and Agent (8 types). The system provides smart, event-driven notifications with weekend-aware SLA warnings and zero duplicate detection.

Added

Agent Notification System (8 Types)

  • Ticket Assignment Tracking:
  • ticket_assigned: New tickets assigned to you from unassigned state
  • ticket_reassigned: Tickets reassigned to you from another agent
  • team_unassigned_new: New unassigned tickets appearing in your team's queue

  • SLA Management:

  • ticket_tto_warning: Time To Own SLA warnings with escalating urgency (โฐ 24h โ†’ โš ๏ธ 12h โ†’ ๐ŸŸ  4h โ†’ ๐Ÿ”ด 1h)
  • ticket_ttr_warning: Time To Resolve SLA warnings with same escalation pattern
  • ticket_sla_breach: SLA deadline exceeded alerts (๐Ÿšจ icon)
  • Weekend-Aware Logic: Friday uses 72h threshold, Saturday uses 48h threshold to catch Monday/Tuesday breaches

  • Priority & Comments:

  • ticket_priority_critical: Automatic alerts when tickets escalate to critical priority (๐Ÿ”ด icon)
  • ticket_comment: New comments on your tickets (both public and private log types)

Portal Notification Enhancements

  • Portal notifications (from v1.2.2) now fully integrated with agent system:
  • ticket_status_changed: Status transitions
  • agent_responded: Public comments from agents
  • ticket_resolved: Resolution notifications
  • agent_assigned: Agent assignment changes

Background Job Infrastructure

  • CheckAgentTicketUpdates: New background job running every 5 minutes
  • Processes all 8 agent notification types
  • Portal-only filtering (skips users with is_portal_only='1')
  • Per-user interval checking (5-1440 minutes configurable)
  • Query optimization (skips API calls when notification types disabled)
  • Rate limiting (max 20 notifications per user per run)

  • CheckPortalTicketUpdates: Existing job (enhanced)

  • Improved query optimization
  • Better timestamp handling
  • Contact role filtering support

Admin Configuration

  • 3-State Notification Control: Configure each notification type independently
  • Disabled: Not available to users (hidden)
  • Forced: Mandatory for all users (no opt-out)
  • User Choice: Enabled by default, users can opt-out

  • Default Configuration:

  • Portal: All 4 types set to "User Choice"
  • Agent: 6 types "User Choice", 2 types "Forced" (SLA breach, priority critical)

  • Configurable Intervals:

  • Admin default: 5-1440 minutes (recommended: 15 minutes)
  • Per-user override available in personal settings

OCC Commands

  • Enhanced itop:notifications:test-user:
  • New --agent flag for testing agent notifications
  • New --portal flag for testing portal notifications (default)
  • --reset flag to clear timestamps and force full re-check
  • Displays user configuration, enabled notifications, and next execution time

API & Services

  • New ItopAPIService Methods:
  • getAgentTicketIds(): Get tickets assigned to agent
  • getTicketsApproachingDeadline(): SLA warning detection with crossing-time algorithm
  • getTeamAssignmentChanges(): Detect new unassigned team tickets
  • applyCrossingTimeAlgorithm(): Weekend-aware threshold calculation (private)

  • Team Detection:

  • Leverages existing getUserTeams() method
  • Tracks team_id changes via CMDBChangeOp
  • Verifies tickets remain unassigned (agent_id = NULL/0)

Documentation

  • New docs/NOTIFICATIONS.md: Comprehensive 345-line user & admin guide
  • Complete notification type reference with examples
  • Setup instructions for users and administrators
  • Troubleshooting section with common issues
  • FAQ with 12 frequently asked questions
  • Technical architecture details

Changed

Notification Algorithm Improvements

  • SLA Crossing-Time Algorithm: Detects threshold crossings without storing per-ticket state
  • Eliminates duplicate warnings for same SLA level
  • Dynamically calculates when each threshold (24h/12h/4h/1h) will be crossed
  • Only notifies most urgent level if multiple thresholds crossed
  • Weekend expansion: Friday (72h), Saturday (48h) for 24h threshold

  • Notification Deduplication:

  • Unique object keys: ticket_id|subject|timestamp_hash
  • Timestamp filtering prevents re-processing old changes
  • Leverages Nextcloud's native duplicate prevention

User Experience

  • Personal Settings UI: Agent notifications section (only visible to non-portal users)
  • Master toggle for agent notifications
  • Granular per-type checkboxes (only "User Choice" types shown)
  • Info box listing "Forced" notifications that cannot be disabled
  • Integrated with existing portal notification settings

  • Notification Display:

  • Escalating emoji icons based on urgency (SLA warnings)
  • Clear differentiation between public and private comments
  • Team name included in team ticket notifications
  • Clickable links route to appropriate iTop interface (portal vs admin UI)

Technical Details

New Configuration Keys (oc_appconfig)

  • agent_notification_config: JSON map of notification type โ†’ state (disabled/forced/user_choice)
  • default_notification_interval: Default check interval for all users (minutes, default: 15)

New User Preferences (oc_preferences)

  • notification_last_agent_check: Unix timestamp of last agent notification check
  • disabled_agent_notifications: JSON array of disabled notification types OR "all"
  • notification_check_interval: Per-user custom interval (minutes)

Architecture Highlights

  • Dual Background Jobs: Portal and Agent jobs run independently
  • CMDBChangeOp Detection: Leverages iTop's built-in change tracking (no external state)
  • Minimal State Storage: Only timestamps per user (no per-ticket data)
  • Query Optimization: Early exit if all notifications disabled, selective API calls
  • Portal-Only Filtering: Agent job automatically skips portal-only users

Performance

  • Per-User Intervals: Users only processed when their interval elapses (reduces API load)
  • Query Optimization: Up to 100% reduction in API calls when notification types disabled
  • Rate Limiting: Max 20 notifications per user per run prevents spam
  • Smart Caching: Team memberships cached for 30 minutes, agent names for 24 hours

Translation Updates

  • Updated en.json, de.json, de_DE.json, fr.json with agent notification types

Breaking Changes

None - Existing portal notifications continue working without changes.

Migration Notes

  • No user action required: Portal notifications work as before
  • Agent detection automatic: Users with is_portal_only='0' gain agent notification access

See Also

<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureWBBeIspelxxeSl4ijI5xjEbBhaAP3KUyE5ZDmHGAOynl+pivkOzx524mIVKEiJPFsoA9xoKkhpn88sMOoDHTvT9L2zvlza+mVXcqc4G01pk5mRB55fAIJGsNvx6gPe7lV84F2H7IrZwpXcKFLY6pPmaHuP13Oc86w/TULtFfsDGXkuKRD2Z65Gf9VGLmUoSkGwXTRD+iPYgceP7XrY/J+iEQp91GBFXg+UriU6sQdNrRBUlGZkGrIYeuX1XGghBEWjfrFwwQJYDxtWh9Dp/TTdkkGwo8R3kf+KxsMPu+JxD34DKvU9OOHIIKbVeudFgKF/96qNYoZMh+vYWPRkX1i2e7NCNKLkTCIfXEd7Ocs8o2bjBdts1aGV6L0ujTAqsJU7ekm60g6/7YecTgvHP+Fz45hZ2T5kwVeLeiQuHwyUgDyrNIQ7iVXPDi8UpgU0tacGnOJBlWxopgQdBGUkRUzmjIhmpmDohz18QxiJIOsXMHIlraXKJrwMSzHB+mxMPxokS4KfqPKadGDJr/ziqQPfJk+UnbNCU881NZua2aaTJuVsrBv9KKB1hqerCE3tpz0ktm4ym66Emg2qn5P5I3PR7TFxyKzNDmymaLIEkacYsk1xrX6Jv/2nIwmrD4AwR0x9U0NtwE9FUb4JnWms8TyI81l+qZcIrDlHms1DTv+yM=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<33.0.0
Minimum Integer bits32

Nextcloud 30

iTop Integration 1.4.3
Release Details
UpdatedSept. 26, 2026, 9:01 p.m.
Changelog

๐Ÿ”ง Nextcloud 35 Compatibility

Changed

  • Nextcloud 35 Support: Raised the supported max-version to 35 โ€” the app has been verified to run on Nextcloud 35 without code changes
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureaGErBYZ69ot3XEeyeAsN63ujSZcUgGHPl2ArM1J3qBV2GbKPqa9OGpzCmCY9JKRAPWvadu93hZ8JJ+ZyIFAoJSnt2MuNbN9JNyZY2DDkE6IjmQoV/KTLzm3zhe6Tk1pl+mbYSEtzGJBh4i2qyZq39w7bkRhKH3+aTbM7oZlJc+VQhE7NZ9B4F8npRv6YP9CsM7OVKBS1CWO6T3S6D6aUS/lBbPA41jwFDfto+04M0YSo71QdHbo1B2ZU9iyOBXLku+ZkzKkP6lJIaSq0YLJctwCbRA6N4c+qQG+mcmbeWK0Is6VcghuR7coUnGDR80AXH1jws0PrwGWK/61+PWcEyaqsnO+UOL6EDKCvMwpIN1MoVmgtJ1lpbvysr7MnJMhd+N1UFHcmIJxWd0on+XgbCDiPzApLlw50PaCt7PvXHnmr3IotbKyWl1rFEFEgcSead/WBSHUHXChdmdVu57fw2dm29Me1uvcgz1lMtoKV0WQWBlW5koK5H99KKWcIDdxQQ+QPBJfUDkWD1jq6mVZs1aUZb76RCJaw4e9TXwJhIm7RLoz9G3hMbCLxA2R+VKaROrEvzHyrZVQUPx7mG8Uyt00jb4yeT/lmgLxXYLtUJFSVluZj9Y2JsMyO7bXHcsCcHHanViJcYSvQyjqbZhtVJJy7LHlpuwZBwX4lvg+Meyc=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<36.0.0
Minimum Integer bits32
iTop Integration 1.4.2
Release Details
UpdatedAug. 11, 2026, 12:29 p.m.
Changelog

๐Ÿ”ง Compatibility Fixes

Fixed

  • Deprecated Exception in Notifier (#6): Notifier::prepare() now throws OCP\Notification\UnknownNotificationException instead of the deprecated plain InvalidArgumentException when a notification is not known to this notifier โ€” Nextcloud โ‰ฅ 30 logged a deprecation warning on every notifications API poll (e.g. from mobile clients or Unified Push) whenever other apps' notifications were processed
  • CI Links Missing Object ID: Smart picker and search results for Configuration Items produced iTop URLs with an empty id= parameter (only UserRequest links worked) โ€” CI queries use output_fields=*, which does not include the object id in iTop REST responses; the id is now taken from the response's key property in both the CI search and the preview mapper, so inserted links and previews point to the actual object
  • Custom CI Class Icons on Hardened Servers: Icon auto-discovery relied on the iTop web server exposing HTML directory listings of /datamodels/2.x/ โ€” standard production hardening (Options -Indexes) blocks these, so all custom CI classes silently fell back to the generic Peripheral icon; the installed module list is now fetched via the REST API (ModuleInstallation) and datamodel XML URLs are derived from the iTop naming convention, with directory listings only used as an enhancement when available; a failed discovery (empty definitions map) is no longer persisted for 24h, so icons recover on the next attempt instead of staying pinned to the fallback; on servers that block the datamodel XML files entirely, the admin settings now show a hint on the Custom CI Classes section naming the affected classes and the two remedies (allow the Nextcloud server to read the datamodel XMLs, or upload icons manually); class icons in the admin settings are now clickable to upload or overwrite a custom icon (SVG or PNG, max 256 KB) via the file picker
  • Localized iTop Date Formats: iTop installations with a customized date_and_time_format (e.g. d.m.Y) delivered localized date strings via the REST API, causing "Invalid Date" in the dashboard widgets, wrong ticket sorting, and broken SLA deadline calculations โ€” all REST responses are now normalized to Y-m-d H:i:s regardless of the server's locale configuration (supports ., /, and - separators in day-first, month-first, and year-first order), and the widgets fall back to the raw string instead of rendering "Invalid Date" for unparseable values
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignaturefId/QLAYQEVu5mLv0resY8nlf2XgkKbsnesc/bTdxlCm/xw1eU7oluiCkFaewbOoq9XEgOJbMeklp+bHzVP+L6jcwuU+yitvPV26TfYSSIsKoXk4nly1FAW4U2Dpf/ggx4JhNo7f3Wwop+25hJV7Dm083545eR8YgDHjARP9UmBJHgfJgo1drYHEEUnyGdRtd78GD+7mXJQMM3s8b48RTXvl7qH4F8gykVa/TXAGIBc/quSxG9+N6kxyAVyXT96oxUUOG3mJOfmqHGDplaYYYaWNoJI0AKkErnS2zemTLHbnKPqgx2l6OmA5UnL1JubRnbRyPPHvIGKayhuWvqvD5h90PxeirsAXvH8adM7SnMS8kpgu9zllkxmOrZvthOVOb64M8wUUVBxdHUvVZ7YcGc93GHyFtC0WQ0HbQ+IAtdZkfZz0zPY54TRhtdd9wfPfDCWLmqwIX0E28MhXV+9/bNTGiYd+MM6VHC5EioUxGS97aBC66bXyUt9vbHvA0lGDEPE58PDZCYwlhv3SqyKY1rtN8L73tWgxrgej9zKVQFpbR8az//W5DjZBTm2ef4+I0bL1nLBz1w0C2U69we2QcuV+rQkO+ohLBEN0NqYrmIeP6dEkie+N122wpN3uGN1ryDNew+PTu9DfIFvFBEqn23YRMb/EGypzMHj33aQpJaY=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<35.0.0
Minimum Integer bits32
iTop Integration 1.4.1
Release Details
UpdatedJuly 26, 2026, 2:08 p.m.
Changelog

๐Ÿ”ง Nextcloud 34 Compatibility, Token Setup Guidance & Release Polish

This release restores compatibility with Nextcloud 34, adds in-app guidance for the iTop personal token prerequisites, and fixes several issues found during the pre-release review of v1.4.0.

Added

  • iTop Configuration Hint (Admin Settings): New warning card explaining that agents need personal_tokens_allowed_profiles configured in iTop's Configuration File Editor before they can create personal tokens, including a ready-to-adapt $MyModuleSettings example
  • Personal Token Help (Personal Settings): Info hint shown when the "Personal Tokens" option is missing from the user's iTop account, pointing them to their iTop administrator

Fixed

  • Nextcloud 34 Compatibility: Replaced removed legacy \OC::$server->getURLGenerator() / getDatabaseConnection() calls with the modern \OCP\Server::get() API โ€” the deprecated shortcut methods were removed in Nextcloud 34, causing the admin and personal settings pages to abort mid-render with an Internal Server Error; also raised the supported max-version to 34
  • Broken Admin Settings CSS: Removed a stray unclosed .ticket-type-options rule that swallowed the new config-hint styles and duplicated an existing selector
  • Template Translation Mismatch: Removed embedded HTML from translatable strings in admin and personal settings templates so they match the locale catalogs (German translations now resolve correctly), and fixed a missing %s substitution that displayed literally instead of the instance name
  • Locale File Consistency: Synced 5 new strings from .js locale files into the .json catalogs for en, de, and de_DE (server-side rendering reads .json โ€” the strings would otherwise fall back to English)
  • Slow Custom CI Class Discovery: The ci-class-available endpoint re-crawled the entire iTop datamodel (one HTTP request per module directory and XML file) on every call โ€” the parsed class-definition map and a negative cache for undiscoverable icons are now persisted in appdata with a 24h TTL, reducing repeat loads from ~37s to under a second
  • Class Browser Not Updating: Newly added custom CI classes now disappear from the selection panel immediately after saving instead of remaining listed
  • Debug Leftover: Removed a stray console.log from the dashboard widget and rebuilt the frontend bundle
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureDQlRM1dgZb1GdPGTBChvKh27m38BBFoFPHhs7jIws7L07u1co5AeWtowwauS7srSh0q6ReEiu1AyFhqC9XXWMC3vwYRFhlnlP3fzMqA2Xi4UAwI989tAhMoixMa4ecisEEWqZ9fo6FZ4rrPgU5CmWVoosLnrdd3v0G/RsCW54d4QruNxspp1RNXWe5z76pecjPrhkASIe6a+YPPa2LJz56H6TxK4aRYtGQ67ODUKm/Yn+F/ctU4hVuol38f68T2QKL0WH48eYXBV8y8D0u1hYMm3CMVeB4McxTaSkYenMOcYOxbjLTGBS6Nk/KJzvab6gi4xB/VzbvWFu5Kz7i2Va9XabBnUSOBsaBLMYf1uM+62wdxFnUFi9pc+dHpB0Pz+WBmtDA7t/YnSrZQk8KVnbUef5Rd8CIopHxMoI9BKQfMlsuLg6zbNx6hsFN/kN9mbhei3U+VfZ5ryyu3bMpZ2a4VlECvZB1h+V271LXdjNviqVWBwSrJPNOVhaPpEYn49HbOJ4FWF+ZIncMIP/VVcfWNLganCJ49ffzCZUIFffGRbxpzbYvuh8NiWqwVGb841B8QoM27MgTH5dq0HYVaB0o8mcpOYRpLtC933L0vDrldYIzrS0hGP4E+nAU0PYpuigY2bfrswWYuhvrHNF1EcrfqqW8vW2XT8L6jrNUutNXw=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<35.0.0
Minimum Integer bits32
iTop Integration 1.3.1
Release Details
UpdatedNov. 9, 2025, 4:15 p.m.
Changelog

๐Ÿ”’ Security Hardening

This release includes important security enhancements to strengthen the application's defenses.

Changed

  • Replaced direct cURL usage with Nextcloud's IClientService for proper SSL certificate verification
  • Enhanced input validation and sanitization for OQL query parameters
  • Improved data validation for numeric identifiers

Security

  • Resolved issues related to network communication security
  • Strengthened protection against malicious input in database queries
<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignaturelnQXKW/X1W4wzcMo2KRpEnsnPE+X3WtmgNn4YwtcagfRqtmdmXPJ/y+tv3P4FmMqn59c+fXHdKGkA8mx5pAp1xLl4sDw++/toeXrTAdVI6gfMeoNuKGNqrOGTRfxYoQ47zR6Oz7mmw18uDNbF6tzTEmzn3zHrwJFopziUVls2p/ZNk5lAPqpStmYnlZplx1/av4UjtMDQ5oHHArkjrGscon7cXsKHXTDjBQqTm43AgvpmTysqZKOCDRz2R9Ng122tFxw5ykn8ZSe1fT7ZG16x6S+XawsPsQKUQ+BCDAb7QkkauDPKIoZPXbuLwMl4PCQErwmq23shI5hYtrdq7uBo6XZOtjlgW5YQSm3zoAM4lXVpQSoDFn2ogup1pPOGE/flYqhTijCpuOGMzAxdvCz7/IzC9vjBwc6ML3M+2Ohf0TJKFVL4WeRWclCiy4kAy/BpXN88Dq9yiKVOMbiVD1UZuFdyGRiEYYvFrK8zt387nwtJ7yfi73lNKMm1Z0/zqfEPrdrDtGa6PtVABqPhiSsV7SAOZIJr+frx1YoYYRkTnB8EB/MzPU9QebTSduJr4yVw+Rz+4a+4w0bX7zy3DUoRMlBbrluGA2VcMWacbdEVpCrrESdvwwEFMPyjlVh2yrGj2/qGf7YfFBvtQF7aJbod826WLbqAy4rtfkEKOqwZd0=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<33.0.0
Minimum Integer bits32
iTop Integration 1.3.0
Release Details
UpdatedNov. 8, 2025, 6:12 p.m.
Changelog

โœจ Major New Feature: Agent Notifications System

Version 1.3.0 introduces a comprehensive notification system with 12 notification types across two independent tracks: Portal (4 types) and Agent (8 types). The system provides smart, event-driven notifications with weekend-aware SLA warnings and zero duplicate detection.

Added

Agent Notification System (8 Types)

  • Ticket Assignment Tracking:
  • ticket_assigned: New tickets assigned to you from unassigned state
  • ticket_reassigned: Tickets reassigned to you from another agent
  • team_unassigned_new: New unassigned tickets appearing in your team's queue

  • SLA Management:

  • ticket_tto_warning: Time To Own SLA warnings with escalating urgency (โฐ 24h โ†’ โš ๏ธ 12h โ†’ ๐ŸŸ  4h โ†’ ๐Ÿ”ด 1h)
  • ticket_ttr_warning: Time To Resolve SLA warnings with same escalation pattern
  • ticket_sla_breach: SLA deadline exceeded alerts (๐Ÿšจ icon)
  • Weekend-Aware Logic: Friday uses 72h threshold, Saturday uses 48h threshold to catch Monday/Tuesday breaches

  • Priority & Comments:

  • ticket_priority_critical: Automatic alerts when tickets escalate to critical priority (๐Ÿ”ด icon)
  • ticket_comment: New comments on your tickets (both public and private log types)

Portal Notification Enhancements

  • Portal notifications (from v1.2.2) now fully integrated with agent system:
  • ticket_status_changed: Status transitions
  • agent_responded: Public comments from agents
  • ticket_resolved: Resolution notifications
  • agent_assigned: Agent assignment changes

Background Job Infrastructure

  • CheckAgentTicketUpdates: New background job running every 5 minutes
  • Processes all 8 agent notification types
  • Portal-only filtering (skips users with is_portal_only='1')
  • Per-user interval checking (5-1440 minutes configurable)
  • Query optimization (skips API calls when notification types disabled)
  • Rate limiting (max 20 notifications per user per run)

  • CheckPortalTicketUpdates: Existing job (enhanced)

  • Improved query optimization
  • Better timestamp handling
  • Contact role filtering support

Admin Configuration

  • 3-State Notification Control: Configure each notification type independently
  • Disabled: Not available to users (hidden)
  • Forced: Mandatory for all users (no opt-out)
  • User Choice: Enabled by default, users can opt-out

  • Default Configuration:

  • Portal: All 4 types set to "User Choice"
  • Agent: 6 types "User Choice", 2 types "Forced" (SLA breach, priority critical)

  • Configurable Intervals:

  • Admin default: 5-1440 minutes (recommended: 15 minutes)
  • Per-user override available in personal settings

OCC Commands

  • Enhanced itop:notifications:test-user:
  • New --agent flag for testing agent notifications
  • New --portal flag for testing portal notifications (default)
  • --reset flag to clear timestamps and force full re-check
  • Displays user configuration, enabled notifications, and next execution time

API & Services

  • New ItopAPIService Methods:
  • getAgentTicketIds(): Get tickets assigned to agent
  • getTicketsApproachingDeadline(): SLA warning detection with crossing-time algorithm
  • getTeamAssignmentChanges(): Detect new unassigned team tickets
  • applyCrossingTimeAlgorithm(): Weekend-aware threshold calculation (private)

  • Team Detection:

  • Leverages existing getUserTeams() method
  • Tracks team_id changes via CMDBChangeOp
  • Verifies tickets remain unassigned (agent_id = NULL/0)

Documentation

  • New docs/NOTIFICATIONS.md: Comprehensive 345-line user & admin guide
  • Complete notification type reference with examples
  • Setup instructions for users and administrators
  • Troubleshooting section with common issues
  • FAQ with 12 frequently asked questions
  • Technical architecture details

Changed

Notification Algorithm Improvements

  • SLA Crossing-Time Algorithm: Detects threshold crossings without storing per-ticket state
  • Eliminates duplicate warnings for same SLA level
  • Dynamically calculates when each threshold (24h/12h/4h/1h) will be crossed
  • Only notifies most urgent level if multiple thresholds crossed
  • Weekend expansion: Friday (72h), Saturday (48h) for 24h threshold

  • Notification Deduplication:

  • Unique object keys: ticket_id|subject|timestamp_hash
  • Timestamp filtering prevents re-processing old changes
  • Leverages Nextcloud's native duplicate prevention

User Experience

  • Personal Settings UI: Agent notifications section (only visible to non-portal users)
  • Master toggle for agent notifications
  • Granular per-type checkboxes (only "User Choice" types shown)
  • Info box listing "Forced" notifications that cannot be disabled
  • Integrated with existing portal notification settings

  • Notification Display:

  • Escalating emoji icons based on urgency (SLA warnings)
  • Clear differentiation between public and private comments
  • Team name included in team ticket notifications
  • Clickable links route to appropriate iTop interface (portal vs admin UI)

Technical Details

New Configuration Keys (oc_appconfig)

  • agent_notification_config: JSON map of notification type โ†’ state (disabled/forced/user_choice)
  • default_notification_interval: Default check interval for all users (minutes, default: 15)

New User Preferences (oc_preferences)

  • notification_last_agent_check: Unix timestamp of last agent notification check
  • disabled_agent_notifications: JSON array of disabled notification types OR "all"
  • notification_check_interval: Per-user custom interval (minutes)

Architecture Highlights

  • Dual Background Jobs: Portal and Agent jobs run independently
  • CMDBChangeOp Detection: Leverages iTop's built-in change tracking (no external state)
  • Minimal State Storage: Only timestamps per user (no per-ticket data)
  • Query Optimization: Early exit if all notifications disabled, selective API calls
  • Portal-Only Filtering: Agent job automatically skips portal-only users

Performance

  • Per-User Intervals: Users only processed when their interval elapses (reduces API load)
  • Query Optimization: Up to 100% reduction in API calls when notification types disabled
  • Rate Limiting: Max 20 notifications per user per run prevents spam
  • Smart Caching: Team memberships cached for 30 minutes, agent names for 24 hours

Translation Updates

  • Updated en.json, de.json, de_DE.json, fr.json with agent notification types

Breaking Changes

None - Existing portal notifications continue working without changes.

Migration Notes

  • No user action required: Portal notifications work as before
  • Agent detection automatic: Users with is_portal_only='0' gain agent notification access

See Also

<hr />
Licenses GNU Affero General Public License v3.0 or later
Certificate-----BEGIN CERTIFICATE-----
MIIECzCCAvMCAhLJMA0GCSqGSIb3DQEBCwUAMHsxCzAJBgNVBAYTAkRFMRswGQYD
VQQIDBJCYWRlbi1XdWVydHRlbWJlcmcxFzAVBgNVBAoMDk5leHRjbG91ZCBHbWJI
MTYwNAYDVQQDDC1OZXh0Y2xvdWQgQ29kZSBTaWduaW5nIEludGVybWVkaWF0ZSBB
dXRob3JpdHkwHhcNMjUxMTAzMTkyNjI3WhcNMzYwMjA5MTkyNjI3WjAbMRkwFwYD
VQQDDBBpbnRlZ3JhdGlvbl9pdG9wMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
CgKCAgEApQCMgekkYYpaftV1ZcERCu2ZBVzkGnvDdzFoOEf16K66EYHsszZJHaIF
8rPcLf0yUPS/EXRbsZGkf3XyMBoL+9fLZgnuSABKUhnE8EMPynS50jRkf20Z76pn
leVU5fkWPYEUsUrqI8tfIEfhbWmumIpodkIYv0oRXEeqt0p/kg5gelSaGsOv/WCY
npRO2NbVG5VKKMrIbp8rc+5umRCr/2i0le9g4s0t/YqKfhNc+DuojKgncNO1CZRU
Ua/cPG63JWd0hfFLV/Jpts6tFpVYx/wpgxxTMvPnxnpuTmIVrIMYWQj+X4hJFgTT
++4yq4HvKH+xBwnJsjiuF/GdbRAgq1OOQSCeD+EwdFYRFUsK+20DlptO0pcYF+bX
A3UYERmqksAmENeOHBEPYPqU3ad3wMh5nf+J5xc4LCq/PBo3/rVrPQBhbwwox08I
icXigo7hr8st8XHpkWs+jC5tVoupAw65J0ciQR2kKE88D4ueI7HjxGtkI1LX6m+s
OFwCZZBZF5K9DnqRkHi9DgZhLdXes51brcWeIxKaXyfhWrOoRg1YMmTJiG1dWHlF
Gs+7e+JxQtGs2acB4C5h4uxxdyL1nFTvKgQNJ3haCLr5WHas6M1WDUHKIFnPqCh7
F6GoJK0FV3sGo/wQU44ST3T5GYsoDR/TSgRtDowb26wWBRBU3F8CAwEAATANBgkq
hkiG9w0BAQsFAAOCAQEAeNUDvib8cBbyvoEqPVQ8j5NyVyPnMYH0mnC+n8h4f0BA
9Bc1VCa4vq6OlFOuVOcJxH+akBCqXaRmyRaV2cs+5aIjIZSTeYuaVt++ZWlDCGIU
wPcRMbZK3ai2TNHL1DPUgxn+4x+Q9oOG/qTjUYn6WcSGvP1WqkQO8IVWT9pt0gRZ
8+Jh85AxDKlmoWLndbvxwGv5F9EzaygPmHMBy8dz/LtcTmxc0jv5NGcZi3oeZSpW
i2GTmKNLTVGtPRGrvwew90h0qoF+fnv8AiuwNAQYhJxwNy9gINp36bhGYi4QUVFe
bqH2ZB7zzCqEiBmcevYLXK8jzUKzNxJa9gEaDV+i9A==
-----END CERTIFICATE-----
SignatureWBBeIspelxxeSl4ijI5xjEbBhaAP3KUyE5ZDmHGAOynl+pivkOzx524mIVKEiJPFsoA9xoKkhpn88sMOoDHTvT9L2zvlza+mVXcqc4G01pk5mRB55fAIJGsNvx6gPe7lV84F2H7IrZwpXcKFLY6pPmaHuP13Oc86w/TULtFfsDGXkuKRD2Z65Gf9VGLmUoSkGwXTRD+iPYgceP7XrY/J+iEQp91GBFXg+UriU6sQdNrRBUlGZkGrIYeuX1XGghBEWjfrFwwQJYDxtWh9Dp/TTdkkGwo8R3kf+KxsMPu+JxD34DKvU9OOHIIKbVeudFgKF/96qNYoZMh+vYWPRkX1i2e7NCNKLkTCIfXEd7Ocs8o2bjBdts1aGV6L0ujTAqsJU7ekm60g6/7YecTgvHP+Fz45hZ2T5kwVeLeiQuHwyUgDyrNIQ7iVXPDi8UpgU0tacGnOJBlWxopgQdBGUkRUzmjIhmpmDohz18QxiJIOsXMHIlraXKJrwMSzHB+mxMPxokS4KfqPKadGDJr/ziqQPfJk+UnbNCU881NZua2aaTJuVsrBv9KKB1hqerCE3tpz0ktm4ym66Emg2qn5P5I3PR7TFxyKzNDmymaLIEkacYsk1xrX6Jv/2nIwmrD4AwR0x9U0NtwE9FUb4JnWms8TyI81l+qZcIrDlHms1DTv+yM=
Signature digestsha512
Dependencies
Required Nextcloud versions >=30.0.0,<33.0.0
Minimum Integer bits32