FAQ Dienstleister

Brauche ich einen Zugang zur Integrationstestplattform (ITU)?

Wo finde ich die OASIS Webservices (WS) Schnittstellenbeschreibung?

Wie wird die OASIS Webservice (WS) Schnittstelle angesprochen?

Welche Zeichencodierung verwendet die OASIS Webservice Schnittstelle?

Welche Verschlüsselungsprotokolle und Cipher Suiten verwendet OASIS?

Wie funktioniert die Ähnlichkeitssuche?

Welche Browserversionen werden unterstützt?

Welche Monitorauflösung wird empfohlen?

Welche Werte sollen als Timeout beim Verbindungsaufbau gesetzt werden?

Wann soll die Spielerstatusabfrage ausgeführt werden?

Der Response einer Abfrage gibt mir den Fehler "0014 / Das XML ist nicht schemakonform." zurück. Wer kann mir helfen?

Wer ist Ansprechpartner für Fragen, die sich bei der Entwicklung der Schnittstelle ergeben?

Welcher Teil des Personalausweises soll ausgelesen werden (nur für terrestrische Angebote)?

Welche Schritte sind notwendig, um eine Freigabeerklärung für meine WS Schnittstelle zu erhalten?

Wann brauche ich eine neue Freigabeerklärung?

Wie erhalte ich die (neuen) OASIS Zertifikate?

Kann ich pro Betriebsstätte nur ein Zertifikat installieren?

Wie gehe ich beim Austausch der Zertifikate am besten vor?

Benutzen alle Betriebsstätten eines Veranstalters das gleiche Zertifikat?

Wer darf das Batchverfahren nutzen?

Gibt es ein „best practice“ für das Batch-Verfahren?

Wir haben hin und wieder Probleme mit der Batchbearbeitung, woran kann das liegen?

Welche Schnittstelle soll für Marketingabfragen verwendet werden?

Welche Regelungen gelten für die Schnittstellen "Werbung" und "Boni und Rabatte"?

Brauche ich einen Zugang zur Integrationstestplattform (ITU)?

Ja, für die Entwicklung Ihrer Anschlusslösung ist der ITU-Zugang unbedingt nötig. Testdatensätze dürfen nicht in die Produktionsumgebung. Weitere Informationen dazu finden Sie auf dieser Seite.

Wo finde ich die OASIS Webservices (WS) Schnittstellenbeschreibung?

Die Dokumentation zu OASIS WS gibt es in deutscher und englischer Sprache. Sie finden diese Dokumente im Bereich der technischen Vorgaben zu OASIS.

Wie wird die OASIS Webservice (WS) Schnittstelle angesprochen?

Die WS-Schnittstelle ist eine REST API und verwendet XML-Schemata zur Validierung der Daten. Die Schema-Dateien finden Sie hier.

Welche Zeichencodierung verwendet die OASIS Webservice Schnittstelle?

Unterstützt wird ausschließlich die Kodierung UTF-8 ohne BOM!

Welche Verschlüsselungsprotokolle und Cipher Suiten verwendet OASIS?

Für die Verbindungsaufnahme mit dem OASIS-Service wird zurzeit ausschließlich TLS 1.2 angeboten.

Der Ciphernkatalog ist auf die folgende Auswahl begrenzt:
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256

Ab November 2021 wird TLS 1.3 unterstützt. Es können dann folgende Verschlüsselungsprotokolle und Cipher Suiten verwendet werden:

# TLS 1.3 (suites in server-preferred order) // Neu
TLS_AES_256_GCM_SHA384 //Neu
TLS_CHACHA20_POLY1305_SHA256 // Neu
TLS_AES_128_GCM_SHA256 // Neu

# TLS 1.2 (suites in server-preferred order)
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_CCM // Neu
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
TLS_DHE_RSA_WITH_AES_128_CCM  // Neu

Wie funktioniert die Ähnlichkeitssuche?

Die Ähnlichkeitssuche ist beschrieben im Dokument „OASIS Konzept - Transliteration – Permutation

Welche Browserversionen werden unterstützt?

Für Version 6.0 werden folgende Browserversionen unterstützt:
Google Chrome, ab Version 90.0.4430.85 (Offizielles Build) (32-Bit)
Mozilla Firefox, ab Version 78.10.0esr.0
Microsoft Edge, ab Version 90.0.818.56 (Offizielles Build) (64-Bit)

Die Abwärtskompatibilität (Verwendbarkeit älterer Versionen) ist nicht gewährleistet.
Die Kompatibilität zu neueren Versionen kann nicht gewährleistet werden, obwohl eine Inkompatibilität unwahrscheinlich ist.
JavaScript muss aktiviert sein.

Welche Monitorauflösung wird empfohlen?

Empfohlene Monitorauflösung: mindestens 1280*1024 Pixel

Welche Werte sollen als Timeout beim Verbindungsaufbau gesetzt werden?

Allgemeines:

Grundsätzlich sollten ALLE Parameter für Verbindungsaufbau, Nutzung von Sicherheitsfeatures und Protokollen variabel einstellbar sein.

Setzen Sie als Timeout zum Verbindungsaufbau 10 Sekunden (jeweils für Request Timeout und Connect Timeout). Im Fehlerfall sollten Sie mindestens eine Wiederholung der Anfrage durchführen. Wir empfehlen jedoch 2 Wiederholungen.

Wiederverwendung von Ports auf Netzwerkkomponenten:
Ein Port sollte auf einer Firewall mindestens 15 Sekunden ruhen, bevor dieser erneut für die Verbindung zu OASIS genutzt wird.

Wann soll die Spielerstatusabfrage ausgeführt werden?

Der Zeitpunkt der Spielerstatusabfrage richtet sich nach den Vorgaben der jeweiligen glücksspielrechtlichen Erlaubnis.

Der Response einer Abfrage gibt mir den Fehler "0014 / Das XML ist nicht schemakonform." zurück. Wer kann mir helfen?

Bitte senden Sie Ihre Anfrage an die HZD.

Wer ist Ansprechpartner für Fragen, die sich bei der Entwicklung der Schnittstelle ergeben?

Fachliche Fragen ( z. B. rechtliche Fragen) senden Sie bitte per E-Mail an das Regierungspräsidium Damstadt.

Technische Fragen (z. B. zum Qualifizierungstest oder den Fragen zur Nutzung) senden Sie bitte an die HZD.

Welcher Teil des Personalausweises soll ausgelesen werden (nur für terrestrische Angebote)?

Nur der lesbare Bereich eines amtlichen Ausweisdokumentes in lateinischer Schrift kann eingelesen werden. Der maschinenlesbare Bereich wird nicht unterstützt!

Welche Schritte sind notwendig, um eine Freigabeerklärung für meine WS Schnittstelle zu erhalten?

Alle erforderlichen Informationen befinden sih auf dieser Seite.

Wann brauche ich eine neue Freigabeerklärung?

Bei einer neuen Version Ihrer Software muss die Freigabeerklärung erneuert werden. Wie bei der Ersterteilung ist der Antrag per E-Mail and das Regierungspräsidium Darmstadt zu richten.

Wie erhalte ich die (neuen) OASIS Zertifikate?

Neue Zertifikate werden automatisiert von OASIS erstellt und rechtzeitig vor Ablauf des alten Zertifikats an die in OASIS hinterlegte E-Mail-Adresse des Veranstalters versandt. Sofern Zertifikate direkt an einen Dienstleister übermittelt werden sollen, ist dies dem Regierungspräsidium Darmstadt durch den Veranstalter per E-Mail mitzuteilen.

Kann ich pro Betriebsstätte nur ein Zertifikat installieren?

Nein. In OASIS werden pro Veranstalter maximal 2 Zertifikate hinterlegt. Dies dient zum reibungslosen Übergang von einem Zertifikat zum anderen. Daher überlappen sich die Gültigkeitszeiträume meist um mehrere Wochen.

Wie gehe ich beim Austausch der Zertifikate am besten vor?

In OASIS GlüStV können pro Veranstalter maximal 2 Zertifikate hinterlegt werden. Dies dient zum reibungslosen Übergang von einem Zertifikat zum anderen. Daher überlappen sich die Gültigkeitszeiträume meist um mehrere Wochen. Sie können das neue Zertifikat direkt nach Erhalt tauschen und brauchen nicht bis zum Ablaufdatum zu warten. Im Übrigen sind die Ausführungen in der Installationsanleitung für OASIS-Zertifikate zu beachten.

Benutzen alle Betriebsstätten eines Veranstalters das gleiche Zertifikat?

Ja, die Zertifikate sind den Veranstaltern zugeordnet.

Wer darf das Batchverfahren nutzen?

Das Batchverfahren wird aktuell nicht unterstützt, da Spielerstatusabfragen aus rechtlichen Gründen der Aktualität als Einzelabfragen getätigt werden sollen.

Gibt es ein „best practice“ für das Batch-Verfahren?

Ja, da Batch ein asynchrones Verfahren ist, gibt es einen präferierten Workflow:

  1. Hochladen des Batches
  2. Entgegennehmen der Batch-ID
  3. Status des Batches mit ID Abfragen (Mindestabstand zwischen zwei Abfragen: 30 Sekunden).
  4. Wenn der Batch erfolgreich oder mit Fehlern abgeschlossen wurde, kann das Ergebnis der Batchbearbeitung mit der ID heruntergeladen werden.
    Werden feste Zeiten hinterlegt, kann es dazu führen, dass die Batchverarbeitung nicht innerhalb des Zeitfensters abgeschlossen wird.

Wir haben hin und wieder Probleme mit der Batchbearbeitung, woran kann das liegen?

Nutzen Sie den präferierten Workflow (s. oben). Sollten fachliche Fehler dazu geführt haben, dass ein Batch nicht bearbeitet wurde, prüfen Sie, ob Sie die Rahmenbedingungen - wie in der Schnittstellenbeschreibung beschrieben - einhalten. Oftmals sind es Zeichenfehler oder unzulässige Geburtsdaten, die Fehler erzeugen.

Welche Schnittstelle soll für Marketingabfragen verwendet werden?

Für diese Zwecke wurde die Schnittstelle „Boni und Rabatte“ entwickelt. Die Schnittstelle "Werbung" wird ab der OASIS Version 6.2 verfügbar sein (voraussichtlich im Januar 2022). Weitere Infos dazu folgen in Kürze.
Benutzen Sie für Marketingabfragen nicht die Schnittstelle für Spielerstatusabfragen!

Welche Regelungen gelten für die Schnittstellen "Werbung" und "Boni und Rabatte"?

  • Die Schnittstelle "Werbung" wird erst ab der OASIS Version 6.2 verfügbar sein.
  • Die Schnittstellen sollten vorzugsweise von 0 Uhr nachts bis 11 Uhr vormittags verwendet werden.
  • Außerhalb dieser Zeiten können die Verfügbarkeit und die Leistungsfähigkeit dieser beiden Schnittstellen eingeschränkt sein.
  • Die Kosten der Abfragen an "Werbung" und "Boni und Rabatte" sind gleich den Kosten der Spielerstatusabfragen.
  • Bei den jeweiligen Schnittstellen sind 5 gleichzeitige Threats zur Abfrage möglich.
  • Die Spieler, deren Abfrageergebnis „0031/Der Spieler darf Boni oder Rabatte erhalten“ gebracht hat, dürfen 2 Stunden gecached werden.

Hessen-Suche