Lassen Sie uns Qypher auf Ihrer eigenen Website verwenden
Je nach Gerät müssen Sie möglicherweise tippen, anstatt zu klicken.
Derzeit werden Programme veröffentlicht, die in PHP geschrieben sind
* php-Version erfordert Ver.7.4 oder höher, Ver.8.3 oder höher wird empfohlen.
Bitte prüfen Sie vor der Implementierung von Qypher, ob Folgendes möglich ist
Muss über https-Zugriff antworten können (http:// ist nicht erlaubt)
Die Qypher-API verschlüsselt die Kommunikation intern, wird jedoch zur zusätzlichen Sicherheit nur in Umgebungen bereitgestellt, die https-Kommunikation unterstützen.
Die Qypher-API verwendet die OpenSSL-Verschlüsselungsbibliothek.
Muss in der Lage sein, Skript-Tags frei einzubetten
Die Qypher-API verwendet JavaScript für die Anzeige, die QR-Code-Analyse und die Kommunikation mit dem Qypher-Kern.
Muss mit externen Domains mittels fetch() kommunizieren können
Die Qypher-API sendet die von ihr analysierten Daten an Qypher auf einer externen Domain (https://qypher.be-on.biz) und erhält die Ergebnisse nach dem Abgleich mit den Qypher-Daten.
Muss DOM-Operationen mit input type="file" und Canvas-Elementen verwenden können
Die Qypher-API verwendet DOM-Operationen zum Hochladen von Qypher-Karte, zur QR-Code-Analyse und zur Bedienung von Schaltflächen.
Muss in der Lage sein, benutzerdefinierte Elemente in HTML einzufügen
Die Qypher-API bettet vor und nach der Anmeldung benutzerdefinierte Elemente in HTML ein.
Muss serverseitigen Code (z. B. PHP) einrichten und ausführen können
Die Qypher-API erfordert die Installation einer PHP-Datei, die den geheimen Schlüssel enthält. Diese Datei ist für die Verschlüsselung und Entschlüsselung der Kommunikation mit Qypher, die Überprüfung von Einmalschlüsseln und andere wichtige Aufgaben verantwortlich.
Sobald das Obige bestätigt wurde, fahren wir mit den Einstellungen fort.
Melden Sie sich zuerst bei Qypher an.
* Die Anmeldemethode ist in „Wie man Qypher verwendet“ beschrieben.
Klicken Sie auf Qypher-Einbindung, Einbindungsdetails von Personenbezogene Daten.
Name der Zielwebsite :
Bitte geben Sie den offiziellen Namen der Website ein, auf der Qypher implementiert wird.
Webadresse von Startseite :
Bitte geben Sie die Adresse der Start- oder Indexseite der Website ein, beginnend mit https.
Sandbox :
Solange “Sandbox” ausgewählt ist, zeigt der Produktions-Login-Bildschirm “In Bearbeitung” an und eine Anmeldung ist nicht möglich. Sobald die verschiedenen Tests abgeschlossen sind, wählen Sie “Produktionsumgebung” und klicken Sie auf “aktualisieren”.
Anzahl der Registrierten :
Dies ist die Anzahl der Benutzer, die sich über Qypher bei Ihrer registrierten Website angemeldet haben. Derselbe Benutzer wird nur einmal gezählt, auch wenn er sich mehrmals anmeldet.
Alter mit Zustimmung der Eltern erforderlich :
Legen Sie das Alter fest, ab dem die Zustimmung der Eltern erforderlich ist. Falls nicht erforderlich, wählen Sie bitte „Keine Einschränkung“.
Einsehbares Alter :
Für Websites mit Altersbeschränkungen legen Sie das Alter fest. Falls nicht erforderlich, wählen Sie bitte „Keine Einschränkung“.
Verwendete Sprache :
In Zukunft, wenn eine Liste der Websites erstellt wird, die Qypher implementieren, werden Abschnitte nach verfügbarer Sprache bereitgestellt. Wenn die automatische Übersetzung im Browser weiterhin fortschreitet, könnte dieser Abschnitt überflüssig werden.
Gewünschte Daten :
Bitte wählen Sie die Benutzerdaten aus, die Sie von Qypher abrufen möchten. Die abrufbaren Daten hängen von Ihrem Plan ab. Bitte überprüfen Sie “Planliste”.
Webadresse von Nutzungsbedingungen :
Bitte geben Sie die URL von Nutzungsbedingungen ein, beginnend mit https.
Webadresse von Datenschutzrichtlinie :
Bitte geben Sie die URL von Datenschutzrichtlinie ein, beginnend mit https.
Webadresse von nach dem Login :
Bitte geben Sie die Seitenadresse an, die nach der Anmeldung sowohl in der Sandbox- als auch in der Produktionsumgebung angezeigt werden soll, beginnend mit https.
Webadresse von Webhook :
Bitte geben Sie die URL zum Empfangen von Webhook-Informationen sowohl für Sandbox- als auch Produktionsumgebungen an, beginnend mit https. Wenn Sie es nicht verwenden, können Sie das Feld leer lassen. Webhooks sind mit Pro-Plänen oder höher verfügbar.
Ordner für den API-Schlüssel :
Wenn Sie auf „API-Set als ZIP herunterladen“ klicken, erzeugt Qypher „Geheimer Schlüsseldatei“. Bitte geben Sie den Ordner ein, in dem dieses „Geheimer Schlüsseldatei“ abgelegt wird, beginnend mit https.
Sprachtyp des API-Schlüssel :
Derzeit wird nur PHP bereitgestellt, aber die Unterstützung für andere Sprachen ist geplant. Dann können Sie hier Ihre bevorzugte Sprache auswählen.
Nutzungsplan :
Bitte wählen Sie Ihren Plan aus. Für Details lesen Sie bitte Planliste.
Bitte platzieren Sie die Login-Seite, API-Schlüssel, Nutzungsbedingungen, Datenschutzrichtlinie, Webhook und die Seite nach dem Login innerhalb derselben Domain oder innerhalb derselben Subdomain, wenn Sie Subdomains verwenden.
Für Benutzer mit Pro-Plänen oder höher, die mehrere Websites implementieren, wählen Sie bitte die Website aus, die Sie aus dem “API-Set als ZIP herunterladen”-Dropdown bearbeiten möchten.
Sobald die Einstellungen abgeschlossen sind, laden wir es herunter.
Wenn Sie auf „API-Set als ZIP herunterladen“ klicken, wird eine komprimierte Datei mit dem Namen „QypherAPIset_(WebsiteName).zip“ in Ihren Download-Ordner heruntergeladen. Bitte doppelklicken Sie darauf oder entpacken (öffnen) Sie sie auf ähnliche Weise.
Dateistruktur
QypherAPIset_(Webseitenname)/
├─ apiScript.txt ← Kopieren Sie diesen Inhalt an eine beliebige Stelle Ihrer Login-Seite.
├─ Ein öffentlicher Schlüssel mit 50 oder mehr zufälligen alphanumerischen Zeichen(1).php ← PHP-Datei zur Verarbeitung des geheimen Schlüssels (Nachfolgend als „Private-Key-Datei“ bezeichnet.)
├─ getData.php ← Bitte kopieren und fügen Sie diesen Inhalt in die Seite ein, die nach dem Login angezeigt wird.
├─ README.txt ← Bedienungsanleitung
└─ Sandbox/
├─ Sandbox_apiScript.txt ← ( für Sandbox ) Kopieren Sie diesen Inhalt an eine beliebige Stelle Ihrer Login-Seite.
├─ Sandbox_Ein öffentlicher Schlüssel mit 50 oder mehr zufälligen alphanumerischen Zeichen(2).php ← ( für Sandbox ) Geheimer Schlüsseldatei
├─ Sandbox_getData.php ← ( für Sandbox ) Bitte kopieren und fügen Sie diesen Inhalt in die Seite ein, die nach dem Login angezeigt wird.
├─ nine.jpg ← Sandbox Qypher-Karte Testbenutzer, 9 Jahre alt (Sie können Aktionen testen, die eine Zustimmung eines Erziehungsberechtigten erfordern.)
├─ eleven.jpg ← Sandbox Qypher-Karte Testbenutzer, 11 Jahre alt (Kann verwendet werden, um die Altersgrenze für die Genehmigung durch einen Erziehungsberechtigten zu überprüfen.)
├─ thirty.jpg ← Sandbox Qypher-Karte Testbenutzer, 30 Jahre alt (Kann sich als Erwachsener normal anmelden.)
└─ guardian.jpg ← Sandbox Qypher-Karte Testbenutzer als Elternteil von 9- und 11-Jährigen (Verwenden Sie dies, um den Genehmigungsprozess für Erziehungsberechtigte zu testen.)
Lassen Sie es uns in Sandbox ausprobieren
In Sandbox können Sie verschiedene Experimente und Erfahrungen im Zusammenhang mit der Qypher-Anmeldung durchführen.
Wenn Sie sich über Sandbox anmelden, bleiben alle Vorgänge innerhalb von Sandbox und werden nicht in Produktionsumgebung übernommen.
E-Mails innerhalb von Sandbox werden nur an Benutzer von Sandbox gesendet.
- Kopieren Sie den gesamten Inhalt aus der Datei Sandbox_apiScript.txt und fügen Sie ihn an einer beliebigen Stelle auf Ihrer für Sandbox-Loginseite ein.
Wenn die gewünschten Daten in das value-Attribut von <input type="hidden" id="QypherAnyKey" value=""> eingetragen werden, können sie nach dem Login übernommen werden.
( Wenn die eingegebenen Inhalte HTML-Tags, JavaScript-Code, Dateipfade oder Ähnliches enthalten, werden sie automatisch ungültig gemacht. Wenn ein schädlicher Wert erkannt wird, kann die Nutzung von Qypher gesperrt werden. )
- Bitte legen Sie Geheimer Schlüsseldatei für Sandbox an dem in Ordner für den API-Schlüssel innerhalb von QypherEinbindungsdetails festgelegten Ort ab.
Bitte platzieren Sie es am selben Ort wie für Produktionsumgebung. Verändern Sie diese Datei unter keinen Umständen. Bei Änderungen kann es durch die zentrale Prüfung von Qypher ungültig werden, wodurch die Login-Anfrage abgelehnt wird.
Benennen Sie die Datei nicht um. Qypher kann die Datei dann nicht mehr identifizieren.
Stellen Sie nach dem Hochladen sicher, dass die Dateiberechtigungen korrekt gesetzt sind.
Empfohlen 604 oder 644
*Wenn Sie einen Windows-Server verwenden, sind die oben genannten „604 / 644“-Berechtigungen nicht erforderlich, aber stellen Sie sicher, dass die Datei vom Webserver (z. B. IIS) mit den richtigen Rechten gelesen werden kann.
- Kopieren Sie den gesamten Inhalt aus Sandbox_getData.txt und verwenden Sie ihn als Grundgerüst für die für Sandbox-Seite nach dem Login.
Geben Sie den Inhalt nach erfolgreichem Login in if($Qypher["success"]){} ein und den Inhalt für einen fehlgeschlagenen Login in else{} .
Der Standardwert bei einer erfolgreichen Anmeldung enthält „Wenn Sie diese Seite neu laden, müssen Sie sich erneut anmelden.“.
Ein auf der Seite nach der Anmeldung eingefügtes PHP-Programm ruft Geheimer Schlüsseldatei auf und entschlüsselt diese Daten.
Zu diesem Zeitpunkt wird der verschlüsselte Anmeldezeitstempel als Einmalpasswort überprüft. Wenn dieser Zeitstempel um mehr als 5 Sekunden abweicht, wird die Anmeldung abgelehnt.
Dies ist eine wichtige Maßnahme, um zu verhindern, dass sich nach dem Ausloggen eines Nutzers eine andere Person zur Anmeldeseite zurückbegibt, sie neu lädt und sich so anmelden kann.
Änderungen innerhalb von Geheimer Schlüsseldatei könnten eine Sicherheitslücke erzeugen. Bitte verändern Sie Geheimer Schlüsseldatei unter keinen Umständen.
Lassen Sie uns Benutzerdaten aus Qypher abrufen
Dies kann im $Qypher-Array abgerufen werden.
$Qypher["success"] ← true = Login erfolgreich, false = Login fehlgeschlagen
$Qypher["uuid"] ← Qypher-Kennung für Login-Protokoll ( Bei Anfragen an Qypher verwenden )
$Qypher["Qypher_ID"] ← Eindeutige Benutzerkennung ( Verwenden Sie dies, um zu erkennen, welcher Benutzer sich angemeldet hat )
$Qypher["login_time(UTC)"] ← YYYY-MM-DDThh:ii:ssZ ( Die Anmeldezeit ist in UTC verfügbar )
$Qypher["meetsAgeReq"] ← „Erfüllt der Nutzer die Altersanforderung der Seite" (1 = ja, 0 = nein). Bei erfolgreicher Anmeldung in der Regel 1. Genaues Alter und Geburtsdatum werden nie übermittelt.
$Qypher["ageReq"] ← Der von der Seite festgelegte Altersschwellenwert (0 = keiner)
$Qypher["guardianApproved"] ← Ob das Alter des Nutzers unter der Schwelle für die elterliche Bestätigung liegt — der needGuardian-Wert (13 falls nicht gesetzt; unter 13-Jährige gelten immer, unabhängig von der Einstellung) (1/0). Qypher schließt eine Anmeldung nie ohne Zustimmung der Erziehungsberechtigten ab, daher bedeutet 1 einen jungen Nutzer, der mit dieser Zustimmung angemeldet ist
$Qypher["under10"] ← Ein grobes „unter 10"-Kennzeichen (1/0), um zu kindgerechter Formulierung oder Darstellung zu wechseln. Genaues Alter und Geburtsdatum werden nicht übermittelt; es wechselt nur einmal an der Grenze von 10 Jahren, sodass wiederholte Anmeldungen das Geburtsdatum nicht preisgeben können.
$Qypher["under13"] ← Ein grobes „unter 13"-Kennzeichen (1/0). Wie under10 ermöglicht es, die Formulierung nach Altersgruppe anzupassen, ohne das genaue Alter zu erhalten; es wechselt nur einmal an der Grenze von 13 Jahren.
$Qypher["QypherAnyKey"] ← Zu übertragende Daten von der Login-Seite ( Dies ist der in das value-Attribut von id="QypherAnyKey" in apiScript.txt eingetragene Wert. )
$Qypher["json"] ← JSON-Format aller Daten ( Verwenden Sie dies für die Verarbeitung mit JavaScript )
Standardmäßig stellt Qypher die oben genannten Daten bereit.Wenn Sie die einzelnen Punkte in Gewünschte Daten innerhalb von QypherEinbindungsdetails aktivieren, werden zusätzliche Daten übermittelt. Nicht freigegebene oder nicht registrierte Daten des Benutzers bleiben leer.
$Qypher["surname"] ← Nachname
$Qypher["givenName"] ← Vorname
$Qypher["nickname"] ← Spitzname
$Qypher["email"] ← E-Mail-Adresse
$Qypher["birthday"] ← Geburtsdatum
$Qypher["postalCode"] ← Postleitzahl
$Qypher["country"] ← Land / Region
$Qypher["area1"] ← Bundesland / Provinz
$Qypher["area2"] ← Stadt / Gemeinde
$Qypher["address"] ← Straßenname und Hausnummer
$Qypher["building"] ← Gebäudename
$Qypher["room"] ← Raumname
z. B. echo `Guten Tag {$Qypher["givenName"]} {$Qypher["surname"]}, Willkommen bei Qypher.`;
Bitte gehen Sie mit personenbezogenen Daten sehr sorgfältig um.
Lassen Sie uns Produktionsumgebung vorbereiten
In Produktionsumgebung unterscheiden sich die öffentlichen und privaten Schlüssel von denen in Sandbox. Das bloße Kopieren der Inhalte von Sandbox lässt Produktionsumgebung nicht funktionieren.
Richten Sie Produktionsumgebung nach denselben Schritten wie in Sandbox ein.
- Kopieren Sie den gesamten Inhalt aus der Datei apiScript.txt und fügen Sie ihn an einer beliebigen Stelle auf Ihrer für Produktionsumgebung-Loginseite ein.
Wenn die gewünschten Daten in das value-Attribut von <input type="hidden" id="QypherAnyKey" value=""> eingetragen werden, können sie nach dem Login übernommen werden.
( Wenn die eingegebenen Inhalte HTML-Tags, JavaScript-Code, Dateipfade oder Ähnliches enthalten, werden sie automatisch ungültig gemacht. Wenn ein schädlicher Wert erkannt wird, kann die Nutzung von Qypher gesperrt werden. )
- Bitte legen Sie Geheimer Schlüsseldatei für Produktionsumgebung an dem in Ordner für den API-Schlüssel innerhalb von QypherEinbindungsdetails festgelegten Ort ab.
Bitte platzieren Sie es am selben Ort wie für Sandbox. Verändern Sie diese Datei unter keinen Umständen. Bei Änderungen kann es durch die zentrale Prüfung von Qypher ungültig werden, wodurch die Login-Anfrage abgelehnt wird.
Benennen Sie die Datei nicht um. Qypher kann die Datei dann nicht mehr identifizieren.
Stellen Sie nach dem Hochladen sicher, dass die Dateiberechtigungen korrekt gesetzt sind.
Empfohlen 604 oder 644
*Wenn Sie einen Windows-Server verwenden, sind die oben genannten „604 / 644“-Berechtigungen nicht erforderlich, aber stellen Sie sicher, dass die Datei vom Webserver (z. B. IIS) mit den richtigen Rechten gelesen werden kann.
- Kopieren Sie den gesamten Inhalt aus getData.txt und verwenden Sie ihn als Grundgerüst für die für Produktionsumgebung-Seite nach dem Login.
Geben Sie den Inhalt nach erfolgreichem Login in if($Qypher["success"]){} ein und den Inhalt für einen fehlgeschlagenen Login in else{} .
Der Standardwert bei einer erfolgreichen Anmeldung enthält „Wenn Sie diese Seite neu laden, müssen Sie sich erneut anmelden.“.
- Melden Sie sich bei Qypher an, setzen Sie Sandbox in Qypher Einbindungsdetails auf Produktionsumgebung, und klicken Sie auf aktualisieren.
Wenn die Login-Seite „Überprüfung des Installationsorts“ anzeigt, prüfen Sie bitte, ob Sie nicht die Sandbox-Version verwenden oder, falls Sie Qypher auf mehreren Seiten nutzen, ob Sie die richtige Version für diese Website verwenden.
Verwenden Sie Webhook, um die Zuverlässigkeit Ihrer Informationen sicherzustellen.
Webhook ist im Pro-Tarif und höher verfügbar. Wenn die Informationen nach der Anmeldung eines Benutzers nicht ordnungsgemäß verarbeitet werden konnten, verwenden Sie bitte Webhook.
Für Benutzer des Pro-Tarifs und höher enthält der Ordner beim Herunterladen der API zwei Dateien: webhook.php und Sandbox_webhook.php. Bitte verwenden Sie diese, indem Sie sie so wie sie sind erweitern.
Das Abrufen der Daten erfolgt auf die gleiche Weise wie auf der Seite nach der Anmeldung.
Geben Sie den Speicherort der Datei in Qypher Einbindungsdetails unter Webhook ein, beginnend mit https, und klicken Sie auf aktualisieren.
Wenn Sie Webhook nicht verwenden, lassen Sie Qypher Einbindungsdetails unter Webhook leer und klicken Sie auf aktualisieren.
