CSV Connector
Identity connector for for CSV-formatted text files.
| Functionality | stable |
| Development status | active (actively developed and maintained) |
| Support status | supported |
| Origin | Evolveum |
| Support provided by | Evolveum |
| Target systems | CSV files (local) |
| Protocol | Local filesystem I/O operations |
| Source code | https://github.com/Evolveum/connector-csv |
This connector is useful to connect to systems that regularly export or import user databases in a form of CSV files. It is usually used to connect to HR-like systems that export the HR data every night. MidPoint deployments are usually using this connector to pull that data. This connector pretends that the CSV file is actually the complete resource. Therefore, the usual configuration of an authoritative resource can be used to connect such an export-based resource.
This connector can also be used as a remote connector if the file is on a different machine than midPoint.
Capabilities and Features
Schema |
YES |
Determined from CSV file header. |
|---|---|---|
Provisioning |
YES |
|
Live Synchronization |
YES |
|
Password |
YES |
|
Activation |
SIMULATED |
No activation for generic CSV is possible. |
Paging support |
NO |
|
Native attribute names |
YES |
|
Last login date |
YES |
Using configuration property with date/time/timestamp column. |
History
This is an CSV connector completely rewritten from scratch during 2016 and 2017.
Versions
| Version | Origin | Binary | Sources | Build Date | Framework version | Bundled with midPoint | Description |
|---|---|---|---|---|---|---|---|
2.0 |
Polygon |
Jun 3rd 2017 |
1.4.2.14 |
3.6 |
Stable version |
||
2.1 |
Polygon |
October 4th 2017 |
1.4.2.14 |
3.6.1 |
Improved live synchronization. Fixed file locking. |
||
2.2 |
Polygon |
April 12th 2018 |
1.4.2.14 |
3.8 |
Script execution (exec) |
||
2.3 |
Polygon |
December 19th 2018 |
1.4.2.35 |
4.0 |
Parallel provisioning operation (thread locking) |
||
2.4 |
Polygon |
April 3rd 2020 |
1.4.2.35 |
4.1 |
Fix for getLastSynchronizationToken-always returning new token |
||
2.5 |
Polygon |
10th October 2022 |
1.5.1.3 |
4.6 |
Added support for configuration discovery. |
||
2.6 |
Polygon |
13th March 2023 |
1.5.1.3 |
4.7 |
Internal search filtering - no need for ConnId result handlers any more. |
||
2.7 |
Polygon |
9th October 2023 |
1.5.1.3 |
4.8 |
Fix of suggestions for configuration discovery. |
||
2.8 |
Polygon |
16th August 2024 |
1.5.2.0 |
4.8.4, 4.9 |
Fixed NPE with multivalue attributes when delimiter is not defined. Fix UTF-8 BOM character in csv file during of discovery functions. |
||
2.9 |
Polygon |
Not released yet |
Added support for _LAST_LOGIN_DATE_ attribute (capability). |
Interoperability
This connector was developed using standard Java I/O libraries. It relies on Java platform for all I/O operations, including potentially problematic operations that involve concurrent and remote access to files. The capabilities of the Java platform on specific operating systems and filesystems may be limited.
The connector is only tested using local files on standard local filesystems in Linux and Windows environments. Network filesystems are not tested - although we have reports that this connector works with some network filesystems.
Support
This connector is bundled with midPoint distribution, therefore it is a subject to bundled support program. Such bundled support includes only support for local files on standard local filesystems in Linux and Windows environment (ext4 and NTFS file systems). Other operating systems are not supported. Network file systems and unusual (experimental) filesystems are not supported.
Support for other operating systems, remote or unusual filesystems has to be explicitly negotiated in a support contract.