The eID-Login extension allows to use the German eID-card and similar electronic identity documents for secure and privacy-friendly login as Website-User into TYPO3 sites. For this purpose, a so-called eID-Client, such as the AusweisApp2 or the Open eCard App and eID-Service are required. In the default configuration a suitable eID-Service is provided without any additional costs.
The installation of the extension can be done in usual ways for a TYPO3 extension. It supports TYPO3 instances which are installed the classic or the composer based way.
If your TYPO3 instance is installed the classic way, please add the extension in the extension manager, either through searching the extension at
Get Extensions in the extension manager or via manual upload.
If your TYPO3 instance installation is composer based, you can add the extension by running:
composer require eidlogin/eid-login-typo3
PLEASE NOTE: If the extension has been installed via composer, you might need to deactivate and re-activate it in the extension manager, to make the console command available for the scheduler!
The eID-Login extension has some requirements to the TYPO3 instance and the configured sites.
- The extension depends on the presence of the TYPO3 scheduler. In composer based TYPO3 instances you might need to install it separately.
- The mail configuration of the TYPO3 instance must be valid, including a default 'from' address.
- All sites using the eID-Login must use HTTP over TLS as protocol.
- The 'Site Configuration' settings of sites using the eID-Login must have full qualified entry points, i.e not using
The extension comes with two maintenance commands:
eidlogin:cleandb- Delete orphaned / old database entries
eidlogin:certificate- Check certificate validity. Does an automated rollover before certificates expire and inform admins about it via email.
The commands must be scheduled as tasks in the scheduler extension:
- Open the scheduler module in the backend and select 'scheduled tasks'
- Use the
+icon to add a task
Execute console commandsin the
- Add a
- once every five minutes for
- once a day for
- once every five minutes for
- Select the command (
eidlogin:certificate) in the
The eID-Login extension can be configured and used in the sites of a TYPO3 instance separately. Opening the backend module of the extension will show a matrix of the sites in the TYPO3 instance and its setup and configuration state regarding the eID-Login.
To provide URLs needed for the eID-Login, a site most hold a free accessible page without content, which should not be visible in the menus. This page needs a separate template record with the following configuration:
- Make the template a
eID-Login SAML Templateas static include under
Includesin the template
There must be at least one free accessible page holding the Frontend-Plugin
eID-Login Link as content element.
This plugin will render a logo, a link to start an eID-Login and a link to the FAQ regarding eID-Login, or a logout link if the Website-User is currently logged in.
Also messages which may occur when doing an eID-Login are rendered by the plugin as TYPO3 Flash-Messages.
Website-Users which should be able to use the plugin must be configured using the
Record Storage Page option.
The value of this Option must be the same for every eID-Login Frontend-Plugin of a site!
At least one access restricted page holding the Frontend-Plugin
eID-Login Settings to render the links which enable the creation and deletion of of eID connection for Website-Users.
Messages which occur in the process are rendered there as TYPO3 Flash-Messages.
The pugin also provides a checkbox to disable the password based login for the specific Website-User.
It will be rendered, if an eID connection exists.
Website-Users which may use this plugin must be configured using the
Record Storage Page option.
ATTENTION: The extension is listening to the
TYPO3\CMS\FrontendLogin\Event\LoginConfirmedEvent event to check if the password based login of a Website-User should be prevented.
For this to be fired do not activate the
Disable redirect after successful login, but display logout-form option of the Login Form!
When a site meets all criteria as stated above, it may be configured by using a simple wizard. Follow the instructions given in the wizard. Information for the technical background is provided via an Info panel if needed.
Record Storage Page option for all eID-Login Frontend-Plugins of a specific site must be set to the same value!
The value is used to connect the Website-Users eID-Connections to to a site.
This means if
Record Storage Page option values are used for eID-Login Frontend-Plugins of more than one specific site, the resulting Website-Users records and their eID-Connections are used for more than one specific site also.
In case of deletion of eID-Connection when reconfiguring or resetting the eID-Login settings of site
A, this may lead to Website-Users loosing the eID-Login based access to site
B too, if the values of
Record Storge Page intersect.
In the frontend Plugins 'eID-Login Link' and 'eID-Login Settings' all relevant HTML tags carry
id attributes for easy styling.
Please inspect the souce code of the rendered pages to learn about the used values.
If you want to set the value of the
class attribute for a specific html tag, this can be done be using the TypoScript paths below, which are evaluated in the templates of the extension:
If you want the extension to skip XML Validation of SAML Responses for a specific site, set the following in your
['EXTENSIONS']['eidlogin'][ROOT_PAGEID_OF_THE_SITE]['skipxmlvalidation'] => true
If you want to uninstall the eID-Login extension please follow the steps below:
- Delete the scheduler tasks for running the
- Delete the page and template record forming the page used to provide the technical URLs of the extension
- Delete all instances of the Frontend-Plugins
- Deactivate the extension in the extension manager
- Delete/Remove the extension (using the extension manager or composer, depending on how the extension has been installed)
- Delete the extension specific configuration entry in the file
- Run the
Database Analyzerto clean the tables
- Remove the database tables with the prefix