Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- dienste:qr_code_generator [2024/07/19 21:04] – [Benutzung] andre
+++ dienste:qr_code_generator [2024/07/19 21:22] (aktuell) – [Benutzung] andre
@@ Zeile 1: / Zeile 1: @@
 ====== QR Code Generator ======
-Die Wiki-QR-Codes fungieren als Ampel-System zur Benutzung von Maschinen und Werkzeugen und ebenso als Hilfestellung bei der Verwendung selbiger, indem man die Wiki-Seite sehr einfach mit einem QR-Code-Reader aufrufen kann. Dort findet man normalerweise die Bedienungsanleitungen und Sicherheitshinweise.
+Die Wiki-QR-Codes fungieren als Ampel-System zur Anzeige der zulässigen Benutzung von Maschinen und Werkzeugen und ebenso als Hilfestellung bei der Verwendung selbiger, indem man die Wiki-Seite sehr einfach mit einem QR-Code-Reader aufrufen kann. Dort findet man normalerweise die Bedienungsanleitungen und Sicherheitshinweise.
   * Service URL: https://qr-code-generator.sternenlabor.de/
@@ Zeile 7: / Zeile 7: @@
 ===== Benutzung =====
-Der Zugriff auf den QR-Code Generator ist mittels reCAPTCHA gegen Spam gesichert. Diese Mensch-Prüfung muss nur initial durchgeführt werden oder solange die Browser Session gültig ist (Cookie).
+Der Zugriff auf den QR-Code Generator ist mittels reCAPTCHA gegen Spam gesichert. Diese Mensch-Prüfung muss nur initial durchgeführt werden oder solange die Browser-Session gültig ist (Cookie).
 Die URL der Wiki-Seite aus der Browser Adress-Leiste kopieren und in das Eingabefeld "Wiki URL" eintragen. Zusätzlich kann noch die Farbe des QR Codes ausgewählt werden (Rot, Gelb, Grün). Welche Farbe auszuwählen ist, hängt von der Art der Benutzung ab. Diese ist normalerweise auf der Wiki-Seite ersichtlich.
-Alle gültigen Links werden automatisch gekürzt (Short Link). Dazu wird der Service unter https://s.sternenlabor.de/ genutzt. Der gekürzte Link ist nur im QR-Code enthalten (das Eingabefeld aktualisiert sich nicht!).
+Alle gültigen Links werden automatisch gekürzt (Short Link). Dazu wird der Service unter https://s.sternenlabor.de/ genutzt. Der gekürzte Link ist nur im QR-Code enthalten (das Eingabefeld aktualisiert sich nicht!). Dies ist notwendig, da ansonsten der QR-Code zu schlecht lesbar sein würde (für QR Reader) und außerdem haben wir ansonsten keine Möglichkeit die URL einfach zu ändern, wenn die Wiki-Seite verschoben oder umbenannt wird
-Danach kann man eine fertige SVG Grafik mit dem QR-Code durch drücken der Schaltfläche "Download QR Code als SVG" herunterladen.
+Danach kann man eine fertige SVG-Grafik mit dem QR-Code durch drücken der Schaltfläche "Download QR Code als SVG" herunterladen.
-**Hinweis:** Eine Erweiterung der Download-Möglichkeiten als PNG Grafik und als fertiges PDF mit allen erstellen QR-Codes wird gerade noch umgesetzt.
+**Hinweis:** Eine Erweiterung der Download-Möglichkeiten als PNG-Grafik und als fertiges PDF mit allen erstellen QR-Codes wird gerade noch umgesetzt.
 ===== Technisches =====
@@ Zeile 21: / Zeile 21: @@
 Der QR-Code Generator ist eine custom Implementation und basiert nicht auf vorhandenen Tools. Der Source-Code kann unter https://github.com/Sternenlabor/qr-code-generator eingesehen werden.
-Gehostet ist der Generator bei All-Inkl. (Sternenlabor) und auf dem Server unter dem Pfad /qr-code-generator.sternenlabor.de zu finden. Der Generator benötigt keine eigene Datenbank.
+Gehostet ist der Generator bei All-Inkl. (Sternenlabor) und auf dem Server unter dem Pfad /qr-code-generator.sternenlabor.de zu finden. Der Generator benötigt keine eigene Datenbank. Die Subdomain ist mit SSL (Let's Encrypt) gesichert.
+Der Zugriff ist mittels reCAPTCHA gesichert (Sternenlabor Google Konto): https://www.google.com/u/1/recaptcha/admin/site/705927238
+Wird eine URL eigegeben, wird diese auf Erreichbarkeit geprüft (HTTP Code 2xx). Ist diese valide, wird zusätzlich geschaut, ob die Seite den Text "Dieses Thema existiert noch nicht" beinhaltet. Falls der Text darin vorkommt, wird die URL als ungültig betrachtet.
+Zum Abruf der URL wird ein CORS Proxy verwendet (qr-code-generator.sternenlabor.de/cors-proxy.php).
+Ist die URL gültig, wird die YOURLS API unter https://s.sternenlabor.de/public-api.php aufgerufen - allerdings nicht direkt, sondern wiederum über den CORS Proxy. Dieser fügt automatisch den Signature Token für den YOURLS-API-Aufruf hinzu, da der Token ansonsten public einsehbar wäre und von Bots mißbraucht werden könnte.