Sidebar

Combodo

iTop Extensions

Preserve post data with SSO

😎 😎 😎 Combodo's customers only 😎 😎 😎

name:
Preserve post data with SSO
description:
This extension solves “post data lost” during SSO authentication. Main usage is Designer MTPs.
version:
1.0.0
release:
2026-09-17
itop-version-min:
2.0
state:
Pilot

Features

This extension solves post issues during authentication. Main example is with designer MTPs…

This extension aims to get rid of such error messages during MTP:

Revision History

Version Release Date Comments
1.0.1 2026-09-07 * N°7098 - MTP with SAML User does not always work
* N°10035 - Use HTTP_REFERER to save post depending on configuration

Requirements

  • iTop min : 2.7.9
  • PHP min: 7.4

Configuration

For Designer MTP/MTT (Move to Production/Move To Test)

Once extension is installed/enabled you have to configure it in iTop configuration.

Example: To enable this extension with Keycloak SSO and SAML authentications only for designer MTPs (endpoint: compile.php):

config-itop.php
'allowed_login_types'=>'form|saml|external|token|hybridauth-Keycloak',
...
'authent-post-sso' => array (
        'supported_login_modes' => array (
          0 => 'hybridauth-Keycloak',
          1 => 'saml',
        ),
        'saml' => array (
            'from_url_match' => 'https://itsm-designer.combodo.com', 
            'to_url_match' => 'compile.php',
            'max_stored_cached_files' => 1,
        ),
        'hybridauth-Keycloak' => array (
            'to_url_match' => 'compile.php',
        ),
    ),

To learn more about OpenID/SAML authentication inside iTop:

Authentication modes

The supported_login_modes parameter defines the list of authentication modes during which the cache mechanism of posted data will be enabled.

  • Valid values are values present in the allowed_login_types configuration parameter of your iTop
  • By default it is not activated.
config-itop.php
'allowed_login_types'=>'form|saml|external|token|hybridauth-Keycloak',
...
'authent-post-sso' => array (
        'supported_login_modes' => array (
          0 => 'hybridauth-Keycloak',
          1 => 'saml',
        ),

Enabled endpoints

Within each allowed login mode, you must specified the allowed iTop endpoint(s) in the to_url_match parameter

  • compile.php is the name of the endpoint used for iTop MTP from the Designer
  • If no endpoint is provided the cache mechanism will not operate.
Limitation:

We cannot specify multiple endpoints for a particular login_mode

In below example we authorize only MTP/Designer endpoint.

Example
        'hybridauth-Keycloak' => array (
            'to_url_match' => 'compile.php',
        ),

Enabled servers

Within each allowed login mode, you can optionally specify source servers in the from_url_match parameter to limit the use of the cache mechanism

In below example only POST request from itsm-designer to 'compile.php' endpoint are triggering cache mechanism.

Example
        'hybridauth-Keycloak' => array (
            'from_url_match' => 'https://itsm-designer.combodo.com', 
            'to_url_match' => 'compile.php',
        ),

Usage

Cache on Local disk

  • When cache is enabled, a file is stored per session and per endpoint required.
  • Files are considered as expired after 5 minutes.
  • Expired files are removed regularly.
  • By default only one file per endpoint is cached on itop server disk at a time. When further POST are sent to iTop, only one at a time will trigger a file cache being saved on disk. The others will work without cache.
  • You can increase the amount of cache files per endpoint by using the parameter max_stored_cached_files
Example
        'hybridauth-Keycloak' => array (
            'from_url_match' => 'https://itsm-designer.combodo.com', 
            'to_url_match' => 'compile.php',
            'max_stored_cached_files' => 1,
        ),

Troubleshooting

To troubleshoot you can enable log verbosity when installing/testing this new extension

config-itop.php
$MySettings = array(
        'login_debug' => true,
        'log_level_min' => ['AuthentPostSso' => 'Debug'],
extensions/authent-post-sso.txt · Last modified: 2026/11/17 12:55 by 127.0.0.1
Back to top
Contact us