Technische Umsetzung

Wir haben dein Interesse geweckt und du möchtest nun wissen, wie du einen DocCheck Login implementieren kannst? Hier findest du alle nötigen Informationen.

Mit deinem persönlichen DocCheck User-Account hast du Zugriff auf DocCheck Access. Dort kannst du einen Firmenaccount anlegen, Lizenzen buchen und verwalten, in Projekten deine Login-Clients erstellen, weitere Administratoren einladen und vieles mehr. Daher empfehlen wir dir, den kostenlosen Firmenaccount gleich zu Beginn anzulegen und einen Basic-Login darin zu erstellen. Ein Upgrade auf eine Economy oder Business Lizenz ist jederzeit möglich.

Das ermöglicht dir, deinen Login grundsätzlich eigenständig zu verwalten. Die Basic-Lizenz ist automatisch für jeden Login-Client verfügbar. Mit der Economy- und Business-Lizenz bekommst du ab Buchung dann zusätzliche Funktionalitäten auf deinem Login-Client zur Verfügung gestellt. 

Basic Lizenz und Testlizenz

Mit der Basic-Lizenz kannst du den Prozess ohne Lizenzgebühren durchlaufen und dich mit dem Produkt vertraut machen. Wenn dir das nicht reicht und du neugierig auf die Funktionen der Economy- oder Business-Lizenz bist, kannst du dir in DocCheck Access jederzeit eigenständig eine kostenlose 14-tägige Testlizenz für einen Login-Client deiner Wahl aktivieren.

Bitte beachte dabei, dass der Login-Client für eine Testlizenz zuvor in der Umgebung "Entwicklungssystem" (Dev) angelegt werden muss. Damit kannst du gemeinsam mit deinem technischen Team alle Funktionen der jeweiligen Lizenz in Ruhe testen.

Das Setup - Economy- oder Business-Lizenz

Wenn du dich für ein kostenpflichtiges Modell entschieden hast, kannst du direkt in DocCheck Access ein neues Lizenz-Abo abschließen oder zunächst ein Angebot anfragen, indem du die Bestellung dort im System speicherst.

Nachdem die Lizenz gebucht ist, stehen dir die erweiterten Features für deinen Login-Client zur Verfügung. Für die Einbindung der zusätzlichen Sicherheit durch den OAuth2-Standard stellen wir dir das Client-Secret direkt im System bereit; du kannst es ganz einfach in DocCheck Access in den erweiterten Einstellungen deines Login-Clients einsehen.

Die Implementierung

Die Implementierung im Webumfeld ist ganz einfach mithilfe unseres generierten Codes möglich. In DocCheck Access steht dir dafür der Button-Konfigurator zur Verfügung. Dort erhältst du ein aktuelles Javascript und ein HTML-Element, welches den DocCheck Login-Button rendert und leicht in deine Webseite eingebaut werden kann.

Bei der Economy- und der Business-Lizenz kommen weitere Funktionen hinzu, die zusätzliche serverseitige Schritte in deinem System erfordern. Details hierzu findest du in unserer technischen Dokumentation bei den jeweiligen Lizenzkapiteln.

Worauf genau du bei der Absicherung über den OAuth2-Standard achten musst, haben wir dir im Bereich "OAuth2 Service" zusammengefasst. Dort findest du auch detaillierte Informationen zu unseren Endpunkten und Empfehlungen zur Einrichtung.

Im Rahmen der Economy- und Business-Lizenz konfigurierst du pro Login-Client ein transparentes Consent-Formular, in dem die Nutzer der Übergabe ihrer Daten an dich zustimmen können. Gleichzeitig erklärst du deinen Nutzern, warum du welche Daten benötigst. Das sichere Abholen der freigegebenen Daten erfolgt dann kontrolliert über unseren Userdaten-Endpunkt. Um die Möglichkeiten zur Nutzung dieser Daten für euch abzustecken, sprich bitte im Bedarfsfall mit eurer Rechtsabteilung. 

Wenn du ein Content-Management-System (CMS) wie WordPress nutzt, kannst du dir ein Custom Plugin bauen oder auf Open Source Plugins zurückgreifen und diese für deine Zwecke individualisieren. Bitte verstehe, dass wir keinen Support für Fragen zu Drittanbieter-Plugins (wie z.B. für WordPress oder TYPO3) leisten können, da wir diese nicht entwickelt haben.

Für die Implementierung in einer App bieten wir Beispiel-Projekte (z. B. für React Native), die dir die Implementierung der Login-Funktionalität in dein App-Projekt erleichtern sollen. Dieses findest du in unserem Github Repository.

Ich weiß noch gar nicht, was ich brauche!

Wir beraten dich gerne. Verrate uns dazu bei deiner Anfrage gleich etwas mehr zu dem geplanten Projekt, z.B.:

  • Welches System bzw. welche Inhalte sollen geschützt werden?
  • Welche technische Infrastruktur wird genutzt?
  • Hast du schon einen Login-Client in DocCheck Access erstellt?
  • Wie hoch ist euer benötigter Sicherheitsstandard?
  • Werden detailliertere Informationen über eure Nutzer benötigt?
  • Welche Zielgruppe (Berufsgruppen) soll Zugriff auf die Informationen haben?

Unsere Dokumentation

Hier haben wir dir alle Dokumente zusammengestellt, die dir bei der Entscheidung helfen, welche Lizenz du brauchst und wie du diese erlangst.

  1. Lizenzbroschüre
  2. Technische Dokumentation
  3. OAuth2-Doku
  4. PHP Provider
  5. Wordpress
  6. Demo-Projekt

 

Bitte beachte, dass wir für Produkte anderer Firmen (beispielsweise Wordpress-Plugin, Typo3-Plugin) nur eingeschränkten Support leisten können.

Sprich uns an:

0221 92053595
0221 92053595