PHPackages                             surf/simplesamlphp-module-readid - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication & Authorization](/categories/authentication)
4. /
5. surf/simplesamlphp-module-readid

AbandonedArchivedSimplesamlphp-module[Authentication & Authorization](/categories/authentication)

surf/simplesamlphp-module-readid
================================

A module to authenticate using ReadID back-end.

30PHP

Since Nov 1Pushed 4y ago6 watchersCompare

[ Source](https://github.com/SURFnet/simplesamlphp-module-readid)[ Packagist](https://packagist.org/packages/surf/simplesamlphp-module-readid)[ RSS](/packages/surf-simplesamlphp-module-readid/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependenciesVersions (1)Used By (0)

ReadID simpleSAMLphp auth module
================================

[](#readid-simplesamlphp-auth-module)

This module adds ReadID Ready App as auth source to simpleSAMLphp. ReadID Ready is an app that can read the data from your passport or other identity documents. Besides collecting your personal data from the document chip it also verifies if your identity document is valid and authentic. By using this module you can use an ID-card, passport or drivers-licence to authenticate.

Disclaimer
----------

[](#disclaimer)

This module was not created by ReadID or InnoValor (the company that created ReadID) and will not be supported by them. Please use [github issues](https://github.com/SURFnet/simplesamlphp-module-readid/issues/new) for any questions about this module. A valid contract for using ReadID Ready is required for using this module. For more information on ReadID see

Usage
-----

[](#usage)

SimpleSAMLphp makes use of Composer to manage dependencies and third-party modules. Just execute the following command:

`composer.phar require surf/simplesamlphp-module-readid`

Please note that if you don't have console access to your web server, you will need to deploy the module somewhere else and then copy the files to your server.

Config
------

[](#config)

Add the authentication source to `authsource.php`:

```
$config = [
...
    'readid' => [
        'readid:ReadID',
        'apiCreateSession' => '/odata/v1/ODataServlet/createReadySession',
        'requesterApiKey' =>
        'iProov' => true,
        'scope' => '',
        'timeout' => 180,
    ],
...

```

- apiCreateSession, you probably won't have to change this
- requesterApiKey, is the ReadID key that can request sessions
- iProov, enable or disable iProov during the ReadID process
- scope, the scope added to scoped attributes. You can adjust the (SAML) attribute mapping in lib/Auth/Source/ReadID.php::getUser()
- timeout, how long does the user have to complete the reading of their document before a timeout message is shown

The authsource also needs a specific readid configuration `config-readid.conf` in the config directory:

```