Importing data to other tables¶
This extension does not directly provide a mechanism for mapping LDAP data to other tables than those related to groups and users. However it is possible to make it so that some data is not mapped to the users table but passed instead to a hook, enabling a separate extension to handle that data.
Defining such data is easy. With the usual mapping syntax:
local_field = ldap_field
Any local_field
that does not exist in the mapped users table will be considered “extra data”. The local_field
may have any special syntax that suits your needs (for example “table__field”) as long as it does not mess with the
mapping configuration itself.
Warning
In previous versions of this extension (2.x) it was possible to use a dot for local_field
(e.g.,
table.field
).
This is not supported anymore since you may use TypoScript to post-process the
mapping. We suggest that you use a double underscore character instead (__
) as in table__field
.
All fields considered to be extra data will be mapped to LDAP values as any other field, but stored separately and passed to the hook.
In your extension (in the ext_localconf.php
file), register the hook using a code like:
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['ig_ldap_sso_auth']['extraDataProcessing'][]
= 'EXT:extension/Path/To/Class/ClassName.php:VendorName\\ClassName';
Your class has to implement the \Causal\IgLdapSsoAuth\Utility\ExtraDataProcessorInterface
interface.
This implies implementing a method called processExtraData
which will receive the following arguments:
- $userTable
- The name of the user table that was just handled (should normally be “fe_users” or “be_users”).
- $user
- Full user record plus the extra data to handle in your extension.
The extra data is located in
$user['__extraData']
. It is up to your extension to handle it as needed.
Note
This process exists only for users, not for groups.