oxtotp/README.md

83 lines
3.2 KiB
Markdown
Raw Normal View History

2022-09-30 09:25:37 +02:00
[![deutsche Version](https://logos.oxidmodule.com/de2_xs.svg)](README.md)
[![english version](https://logos.oxidmodule.com/en2_xs.svg)](README.en.md)
2020-12-22 09:33:38 +01:00
2023-01-26 00:12:47 +01:00
# 2-Faktor-Authentisierung (Einmalpasswort) für OXID eShop
2020-12-22 09:33:38 +01:00
2023-01-26 00:12:47 +01:00
Dieses Modul stellt eine 2-Faktor-Authentisierung (zeitabhängiges Einmalpasswort / TOTP) zum Login in Front- und Backend zusätzlich zu Benutzername und Passwort zur Verfügung.
2020-12-22 09:33:38 +01:00
2022-09-30 09:25:37 +02:00
## Features
2020-12-22 09:33:38 +01:00
2022-09-30 09:25:37 +02:00
- 2-Faktor-Authentisierung für Logins in Front- und Backend zusätzlich zu Benutzername und Passwort
- Aktivierung und Einrichtung im Front- und Backend möglich
- Authentisierung wird bei Benutzerkonten gezeigt, die dieses aktiviert haben - sonst die übliche Standardanmeldung
- Einrichtung des Zugangs in der Auth-App kann durch scanbaren QR-Code oder kopierbare Zeichenkette erfolgen
- Validierung der Einmalpassworte und Generierung der QR-Codes werden ausschließlich innerhalb des Shops durchgeführt - keine Kommunikation nach außen nötig
2020-12-22 09:33:38 +01:00
- statische Backupcodes ermöglichen auch eine (begrenzte) Anmeldung ohne Zugang zum Generierungstool
2022-09-30 09:25:37 +02:00
- für Adminbenutzer kann die Einrichtung des zweiten Faktors verpflichtend eingestellt werden
### Einrichtung
![Einrichtung Backend](assets/setup_backend.jpg "Einrichtung Backend")
![Einrichtung Frontend](assets/setup_frontend.jpg "Einrichtung Frontend")
### Login
2022-11-25 20:35:55 +01:00
![Login Backend](assets/login_backend.png "Login Backend")
![Login Frontend](assets/login_frontend.png "Login Frontend")
2022-09-30 09:25:37 +02:00
## Systemanforderungen
Dieses Paket erfordert einen mit Composer installierten OXID eShop in einer der folgenden Versionen:
- 6.3.x
- 6.4.x
- 6.5.x
und dessen Anforderungen.
2022-11-25 20:35:55 +01:00
Im Standard wird das Flow- und Wave-Theme unterstützt. Andere Themes können Anpassungen erfordern.
2022-09-30 09:25:37 +02:00
## Erste Schritte
2023-01-26 00:12:47 +01:00
Öffnen Sie eine Kommandozeile und navigieren Sie zum Stammverzeichnis des Shops (Elternverzeichnis von source und vendor). Führen Sie den folgenden Befehl aus. Passen Sie die Pfadangaben an Ihre Installationsumgebung an.
2022-09-30 09:25:37 +02:00
```
2023-01-26 00:12:47 +01:00
composer require d3/oxid-twofactor-onetimepassword
2022-09-30 09:25:37 +02:00
```
Aktivieren Sie das Modul im Shopadmin unter "Erweiterungen -> Module".
Die nötige Konfiguration finden Sie im selben Bereich im Tab "Einstell.".
## Changelog
Siehe [CHANGELOG](CHANGELOG.md) für weitere Informationen.
## Beitragen
Wenn Sie eine Verbesserungsvorschlag haben, legen Sie einen Fork des Respoitories an und erstellen Sie einen Pull Request. Alternativ können Sie einfach ein Issue erstellen. Fügen Sie das Projekt zu Ihren Favoriten hinzu. Vielen Dank.
- Erstellen Sie einen Fork des Projekts
- Erstellen Sie einen Feature Branch (git checkout -b feature/AmazingFeature)
- Fügen Sie Ihre Änderungen hinzu (git commit -m 'Add some AmazingFeature')
- Übertragen Sie den Branch (git push origin feature/AmazingFeature)
- Öffnen Sie einen Pull Request
## Lizenz
(Stand: 17.10.2018)
Vertrieben unter der GPLv3 Lizenz.
```
Copyright (c) D3 Data Development (Inh. Thomas Dartsch)
Diese Software wird unter der GNU GENERAL PUBLIC LICENSE Version 3 vertrieben.
```
Die vollständigen Copyright- und Lizenzinformationen entnehmen Sie bitte der [LICENSE](LICENSE.md)-Datei, die mit diesem Quellcode verteilt wurde.
## Credits
Zu diesem Modul haben beigetragen:
- Tobias Matthaiou
Vielen Dank.