Magento Extension zur Einbindung der Identitäts- und Altersprüfung mit "Deutsche Post " Diese Extension bindet das Identifikations- und Altersprüfungssystem der Deutschen Post AG in Magento ein. Modulversion: 13.02.28 Firma: Netresearch App Factory AG Autoren: André Herrn, Sebastian Ertner Datum: 28.02.2013 Stand: 28.02.2013 1/19
- Benutzerdokumentation 1 Einleitung 3 2 Voraussetzungen 4 3 Installation 5 3.1 Apache Webserver konfiguration 5 4 Konfiguration 6 4.1 Basiskonfiguration 6 4.2 Stammdaten 7 4.3 ID-Cards 8 4.4 Schnittstellen URLs 9 4.5 Kriterien zur Altersprüfung 10 4.6 Checkout 11 5 Identifikation und Altersprüfung 12 5.1 Verhalten im Warenkorb 12 5.2 Speichern der Verifizierungsdaten 14 6 Ermittlung des Mindestalters 15 7 Warenkorb / Checkout 16 7.1 Checkout / Adressdaten - Übernahme 17 8 Kundenadministration 18 9 Deinstallation 19 9.1 Per Magento Connect Manager 19 9.2 Auf Dateiebene 19 9.3 Datenbank 19 Stand: 28.02.2013 2/19
1 Einleitung Mit bietet die Deutsche Post eine Online Lösung zur Altersprüfung und Identifizierung von Ihren Nutzern im Internet an. Es werden folgende Anwendungsfälle unterstützt: 1. Altersprüfung: Das Alter Ihrer Nutzer wird gegen ein hinterlegtes Mindestalter geprüft. Somit ist das Geburtsdatum durch die Deutsche Post AG verifiziert. 2. Identifikation mit Altersprüfung: Zusätzlich zur Altersprüfung erhalten Sie eine geprüfte Identität Ihrer Nutzer durch die Deutsche Post (z.b. Anschrift). 3. Identifikation ohne Altersprüfung: Sie erhalten die geprüfte Identität des Nutzers ohne das Alter zu prüfen. Im Folgenden werden die Voraussetzungen sowie die Installation und Konfigurationseinstellungen zur Einbindung der Magento Extension erläutert. Stand: 28.02.2013 3/19
2 Voraussetzungen PHP 5.2+ Ein Magento der Version Community Edition 1.5.x Community Edition 1.6.x Community Edition 1.7.0.2 Ihre Geschäftskunden-Adminstrator-Zugangsdaten bei E-POST inkl. Zugriff auf hinterlegtes Mobiltelefon Ein eingerichteter und aktiver Dienst mit folgenden Einrichtungsinformationen: Client ID ClientSecret Hinweis: Wie Sie einen aktiven Dienst erhalten, erfahren Sie im Einrichtungsleitfaden für. SSL-Zertifikat (HTTPS) im Shop für die Warenkorb- und Checkout-Seiten Webserverkonfiguration muss GET-Parameter mit einer Länge bis zu 4096 Bytes (Apache suhosin.get.max_value_length = 4096) unterstützen Stand: 28.02.2013 4/19
3 Installation 1. Kopieren Sie den "Extension Key" von der MagentoCommerce-Webseite (http://www.magentocommerce.com/magento-connect/catalog/product/view/id/16560/) 2. Melden Sie sich in Ihrem Magento Backend an 3. Navigieren Sie zu "System" -> "Magento Connect" -> "Magento Connect Manager" 4. Melden Sie sich im "Magento Connect Manager" an 5. Wählen Sie den Tab "Extensions" 6. Tragen Sie den kopierten Key von der MagentoCommerce-Webseite in das Feld "Paste extension key to install" ein und wählen Sie "Install" 7. Unter Umständen müssen Sie danach die Installation mit einem Klick auf den Button "Proceed" bestätigen. 8. In der schwarzen Installations-Konsole sollte anschließend die Meldung "Package... installed successfully" zu sehen sein. Das Modul ist nun korrekt installiert. 9. Apache Webserver muss so konfiguriert sein das GET-Parameter mit einer Länge bis zu 4096 Zeichen unterstützt werden. 3.1 Apache Webserver konfiguration Sollte sie auf Ihrem Webserver die Suhosin Erweiterung (http://www.hardened-php.net/suhosin/) installiert haben, kann es unter Umständen notwendig sein, dass Sie die erlaubte Länge der GET-Parameter ändern müssen. Hierzu ist in der php.ini der Eintrag "suhosin.get.max_value_length = 4096" vorzunehmen. Anschließend muss der Apache-Webserver neu gestartet werden. Mehr Informationen dazu finden Sie unter: http://www.hardened-php.net/suhosin/configuration.html Sollten Sie keine Möglichkeit haben diesen Wert selbständig anzupassen, wenden Sie sich bitte an Ihren Hosting-Betreiber. Stand: 28.02.2013 5/19
4 Konfiguration Die -Konfiguration ist im Magento-Backend unter "System" -> "Konfiguration" -> "Verkäufe" -> "" aufrufbar. 4.1 Basiskonfiguration Basiskonfiguration Aktiviert Konfiguration Logging aktiviert Beschreibung Wählen Sie hier, ob das -Modul aktiviert sein soll. Standardmäßig ist es nach der Installation deaktiviert. Diese Einstellung ist standardmäßig auf "Nein" gestellt. Aktivieren Sie diese Einstellung um Request und Response zu loggen. Bei der Inbetriebnahme des Moduls empfiehlt es sich, das Logging zu aktivieren, damit Fehler (ggf. vom Support) besser analysiert werden können. Konfiguration Register "Basiskonfiguration" Stand: 28.02.2013 6/19
4.2 Stammdaten Tragen Sie hier Ihre Zugangsdaten ein. Stammdaten Konfiguration Domain-URI Client ID Check-Connect Button ClientSecret Alias Beschreibung Dies ist die aktuelle Shop-URI. Hier haben Sie keine Einstellmöglichkeiten, da immer die aktuelle Shop-URI angezeigt wird. Bei Multishop-Umgebungen wird je nach Konfigurations-Scope die SHOP-URI des aktuellen Store-Views angezeigt. Die Client ID entspricht der Identifikationsnummer jeder Domain eines Dienstanbieters und wird bei der Anlage einer Domain im Deutsche Post Selbstadministrationsportal automatisch vergeben. stellt Ihnen den Service Check-Connect zur Verfügung. Gegen diese Schnittstelle können Sie Ihre grundsätzliche Anbindung an sowie die korrekte Zusammensetzung aus Client ID und Domain-URI überprüfen. Tragen Sie hier den von Ihnen selbst gewählten ClientSecret aus dem Deutsche Post Selbstadministrationsportal ein. Tragen Sie hier den von Ihnen selbst gewählten Alias aus dem Deutsche Post Selbstadministrationsportal ein. Konfiguration Register "Stammdaten" Stand: 28.02.2013 7/19
4.3 ID-Cards Hier finden Sie die Konfigurations-Optionen der zu benutzenden ID-Card. ID-Cards Konfiguration ID-Card Name Testmodus Beschreibung Wählen Sie hier die für Ihren Anwendungsfall passende ID-Card. Für eine Übersicht zu den ID-Cards und Parametern klicken Sie auf den Link im Kommentarbereich. Bei aktiviertem Testmodus wird eine kostenlose Test-ID-Card verwendet. Diese ID-Card liefert folgende Werte Ihres Geschäftskunden-Administrators: Vorname, Nachname, Geburtsdatum, E-POSTBRIEF Adresse und Mobilfunknummer. Im Testmodus können Sie Ihren Dienst nur mit Ihrem Geschäftskunden-Administrator testen. Konfiguration Register "ID-Cards" Stand: 28.02.2013 8/19
4.4 Schnittstellen URLs Hier finden Sie Einstellmöglichkeiten der zu verwendenden Schnittstellen-URLs. Bitte ändern Sie die voreingestellten URLs nur nach expliziter Aufforderung seitens Deutsche Post. Schnittstellen-URL's Konfiguration Check Connect URL URL Access-Ticket URL Identitätsdaten URL Beschreibung Die Schnittstellen URL für die Check-Connect Prüfung ist vorkonfiguriert (https://ident.epost.de/oauth2/clientverification). Die Schnittstellen URL für den Request ist vorkonfiguriert (https://ident.epost.de/oauth2/login). Die Schnittstellen URL für das Anfordern des Access-Tickets ist vorkonfiguriert (https://ident.epost.de/oauth2/token). Die Schnittstellen URL für das Abrufen der Identitätsdaten ist vorkonfiguriert (https://ident.epost.de/oauth2/identdata). Konfiguration Register "Schnittstellen URLs" Stand: 28.02.2013 9/19
4.5 Kriterien zur Altersprüfung Hier finden Sie Einstellmöglichkeiten für die entsprechenden Kriterien zur Altersprüfung. Kriterien zur Altersprüfung Konfiguration Art der Verifikation Mindestalter Bei jedem Checkout verifizieren Beschreibung Hier können Sie die Verifizierungsart festlegen. Bei der Einstellung "Global" wird das in der Konfiguration hinterlegte Mindestalter für die Verifizierung verwendet. Bei der Einstellung "Produktspezifisch" gilt das am Produkt festgelegte Mindestalter für die Verifizierung. Sofern Sie die Einstellung "Beides" auswählen, wird sowohl das in der Konfiguration gesetzte Mindestalter als auch das am Produkt hinterlegte Mindestalter für die Verifizierung herangezogen. Es wird das höhere Mindestalter von beiden Optionen verwendet und dagegen verifiziert. Eine detaillierte Aufstellung dazu finden Sie in Kapitel Verhalten im Warenkorb. Feld leer lassen bzw. 0 eintragen, sofern keine Altersverifikation durchgeführt werden soll. Das Mindestalter, sofern ausgefüllt, gilt als Kriterium für alle Käufe, um den Checkout betreten und die Bestellung abschließen zu können. Derzeit sind nur Werte größer oder gleich 18 empfohlen. Eine detaillierte Aufstellung dazu finden Sie in Kapitel Verhalten im Warenkorb. Wenn Sie diese Option aktivieren, wird bei jedem Checkoutprozess eine Verifikation via verlangt, selbst wenn für diesen Kunden schon verifizierte Daten existieren. Konfiguration Register "Verifikationskriterien" Stand: 28.02.2013 10/19
4.6 Checkout Verifikationskriterien Konfiguration Adressdaten benutzen Beschreibung Wenn Sie diese Option aktivieren, hat der Kunde die Möglichkeit, die Rechnungs- und Lieferadresse mit seinen verifizierten -Daten vorausfüllen zu lassen. Konfiguration Register "Checkout" Stand: 28.02.2013 11/19
5 Identifikation und Altersprüfung Beim Aufruf des Warenkorbes und des Checkouts wird geprüft, ob eine Identifikation und Altersprüfung notwendig ist (Modul aktiviert und geeignetes Mindestalter hinterlegt). Wie in der Einleitung bereits erläutert, können Sie zwischen den folgenden drei Anwendungsfällen wählen. Hierzu nehmen Sie diese Einstellungen vor: 1. Zur Altersprüfung Wählen Sie unter den Konfigurations-Optionen "ID Cards" die ID Card "Altersprüfung" aus. Tragen Sie das gewünschte Mindestalter in den Konfigurations-Optionen "Kriterien zur Altersprüfung" ein. Derzeit sind nur Werte größer oder gleich 18 empfohlen. 2. Zur Identifikation mit Altersprüfung Wählen Sie unter den Konfigurations-Optionen "ID Cards" die ID Card "Identitätsprüfung Basis" oder "Identitätsprüfung Premium" aus. Tragen Sie das gewünschte Mindestalter in den Konfigurations-Optionen "Kriterien zur Altersprüfung" ein. Derzeit sind nur Werte größer oder gleich 18 empfohlen. 3. Zur Identifikation ohne Altersprüfung Wählen Sie unter den Konfigurations-Optionen "ID Cards" die ID Card "Identitätsprüfung Basis" oder "Identitätsprüfung Premium" aus. Tragen Sie in den Konfigurations-Optionen "Kriterien zur Altersprüfung" eine "0" als gewünschtes Mindestalter ein. Falls eine Identifikation oder Altersprüfung notwendig ist, wird geprüft, ob der User schon einmal mit altersgeprüft oder identifiziert worden ist. Liegt beispielsweise das verifizierte Geburtsdatum vor und wurde bei der Einstellung "Bei jedem Checkout verifizieren":"nein" gewählt, erfolgt keine erneute Altersprüfung. Falls nicht, wird der Nutzer zur Altersprüfung aufgefordert. 5.1 Verhalten im Warenkorb Die folgende Tabelle beschreibt das Verhalten im Warenkorb/Checkout in Bezug auf die Einstellungen im Konfigurationsbereich (siehe Kapitel Kriterien zur Altersprüfung) und an den Produkten. Erläuterung am Beispiel 3 (Global/18/21/18 => Checkout ohne nicht erlauben): Im Konfigurationsbereich ist für die Option "Art der Verifikation" der Wert "Global" eingestellt und für das "Globale Mindestalter" der Wert 18 hinterlegt. Für eines der Produkte im Warenkorb wurde ein Mindestalter von 21 Jahren konfiguriert. Bei der Ermittlung des zu prüfenden Mindestalters wird in diesem Fall nur das im Konfigurationsbereich hinterlegte Mindestalter von 18 Jahren herangezogen, da "Art der Verifikation" auf "Global" gestellt ist. Stand: 28.02.2013 12/19
Art der Verifikation Globales Mindestalter Reaktionen im Warenkorb/Checkout Produkt Mindestalter max. Mindestalter im WK Reaktion im WK/Checkout Global 0 0 0 Checkout ohne erlauben Global 18 0 18 Checkout ohne nicht erlauben Global 18 21 18 Checkout ohne nicht erlauben Produktspezifisch 0 0 0 Checkout ohne erlauben Produktspezifisch 18 0 0 Checkout ohne erlauben Produktspezifisch 0 18 18 Checkout ohne nicht erlauben Produktspezifisch 21 18 18 Checkout ohne nicht erlauben Produktspezifisch 18 21 21 Checkout ohne nicht erlauben Beides 0 0 0 Checkout ohne erlauben Beides 18 0 18 Checkout ohne nicht erlauben Beides 0 18 18 Checkout ohne nicht erlauben Beides 18 21 21 Checkout ohne nicht erlauben Stand: 28.02.2013 13/19
5.2 Speichern der Verifizierungsdaten Sofern der Kunde erfolgreich verifiziert wurde, speichert das Modul die von übermittelten Kundendaten an der Quote. Nach jeder erfolgreichen Bestellung werden die an der Quote gespeicherten Daten auch am Kundenobjekt gespeichert. Für den Fall, dass im Backend die Konfigurationsoption "Bei jedem Checkout verifizieren" aktiviert ist, muss der Kunde für jeden Bestellvorgang die Verifizierung per erneut durchführen. Dies hat zu Folge, dass die gegebenenfalls bereits am Kunden gespeicherten -Daten nach einem erfolgreichen Bestellvorgang mit den aktuellen Verifizierungsdaten überschrieben werden. Stand: 28.02.2013 14/19
6 Ermittlung des Mindestalters Die Ermittlung des Mindestalters wird anhand der Konfigurationseinstellung "Art der Verifikation" vorgenommen. Wird die Einstellung "Global" verwendet, gilt im ganzen Shop das im Konfigurationsbereich festgelegte Mindestalter. Bei der Einstellung "Produktspezifisch" wird das am Produkt(siehe Bild "Mindestalter am Produkt") hinterlegte Mindestalter benutzt. Es werden alle im Warenkorb vorhandenen Produkte auf Vorhandensein eines Mindestalters überpüft und das höchste Mindestalter ermittelt. Wenn Sie die Einstellung "Beides" verwenden, werden beide Optionen für die Berechnung des Mindestalters berücksichtigt. Ist im Shop zum Beispiel ein globales Mindestalter von 18 Jahren konfiguriert, an manchen Produkten aber ein produktspezifisches Mindestalter von 21 Jahren hinterlegt und befindet sich solch ein Produkt im Warenkorb, so wird das am Produkt konfigurierte Mindestalter verwendet, da es höher ist als das global konfigurierte. Mindestalter am Produkt Stand: 28.02.2013 15/19
7 Warenkorb / Checkout Das Modul integriert sich in den normalen Checkout-Prozess von Magento. Sobald Sie das Modul aktiviert haben und bei den Kriterien zur Altersprüfung ein Mindestalter eingetragen haben, wird beim Aufruf des Warenkorbs überprüft, ob eine Alters- oder Identitätsprüfung per durchgeführt werden soll. Bei einer "Altersprüfung" oder "Identifikation mit Altersprüfung" wird der "Zur Kasse" Button durch die Buttons "Jetzt Alter prüfen" bzw. "Jetzt identifizieren" ersetzt. Bei einer "Identifikation ohne Altersprüfung" bleibt der "Zur Kasse" Button erhalten. In diesem Fall wird zusätzlich der "Jetzt identifizieren" Button angezeigt. Des weiteren wird bei jedem Checkout-Schritt geprüft, ob der Warenkorb eine Verifizierung benötigt. Wird festgestellt, dass eine Verifizierung nötig ist, wird der Kunde mit einer Hinweisnachricht wieder zum Warenkorb geleitet, wo er den "Jetzt Alter prüfen"- bzw. "Jetzt identifizieren"-button betätigen muss. Mit diesem Verfahren wird sichergestellt, dass kein Kunde ohne Verifizierung eine Bestellung abschließen kann. Stand: 28.02.2013 16/19
7.1 Checkout / Adressdaten - Übernahme Sofern die Konfigurationsoption "Adressdaten übernehmen" aktiviert ist, werden die Rechnungs- und Versandadresse mit den verifizierten Daten aus vorausgefüllt. Dies geschieht nur, wenn die zu prüfenden Felder: Präfix Vorname Nachname Straße und Hausnummer Adresszusatz Stadt PLZ Land und Geburtsdatum leer sind. Wenn die Felder hingegen nicht leer sind und die bereits vorhanden Werte der Felder nicht mit den Daten aus übereinstimmen, wird ein Button "-Adresse übernehmen" eingeblendet. Beim Klick auf den Button werden die Formularfelder mit den durch verifizierten Daten ersetzt. Neben dem Button existiert ein Fragezeichen "?", welches beim Darüberfahren mit dem Zeiger ("mouseover") ein Popup angezeigt und die -Daten in einer Vorschau darstellt. Stand: 28.02.2013 17/19
8 Kundenadministration Unter Kunden -> Kunden verwalten -> Kunden in Übersicht auswählen -> Daten, sehen sie eine Übersicht der am Kunden hinterlegten und durch verifizierten Daten. Sollte der Kunde noch keine durch verifizierten Daten besitzen, erscheint ein Hinweistext "Für diesen Kunden existieren keine verifizierte Daten". Kundenadministration " Daten" Stand: 28.02.2013 18/19
9 Deinstallation Sollten Sie die Erweiterung nicht mehr benötigen, können Sie diese aus Ihrer Magento-Installation entfernen. 9.1 Per Magento Connect Manager Sofern Sie das Modul mittels des Magento Connect Managers installiert haben, gehen Sie bitte wie folgt vor. 1. Melden Sie sich in Ihrem Magento Backend an 2. Navigieren Sie zu "System" -> "Magento Connect" -> "Magento Connect Manager" 3. Melden Sie sich im "Magento Connect Manager" an 4. Wählen Sie den Tab "Extensions" 5. Wählen Sie für die -Extension die Aktion "Uninstall" und betätigen Sie anschließend den Button "Commit Changes" 9.2 Auf Dateiebene Um das Modul manuell zu deinstallieren, löschen Sie bitte die folgenden Dateien und Ordner: app/code/community/deutschepost/postident/ app/etc/modules/deutschepost_postident.xml app/locale/de_de/deutschepost_postident.csv js/postident js/postident/ app/design/adminhtml/default/default/layout/postident.xml app/design/adminhtml/default/default/template/postident app/design/frontend/base/default/layout/postident.xml app/design/frontend/base/default/template/postident/ skin/frontend/base/default/css/postident.css skin/frontend/base/default/images/postident/ 9.3 Datenbank Bitte führen Sie sowohl bei der manuellen Deinstallation als auch bei der Deinstallation per Magento Connect Manager folgende SQL-Befehle aus: ALTER TABLE sales_flat_quote DROP COLUMN postident_verification_data; DELETE FROM eav_attribute where attribute_code='postident_verification_data'; DELETE FROM eav_attribute where attribute_code='epostident_minage'; Stand: 28.02.2013 19/19