Herzlich Willkommen zum Webinar!

Das Serviceportal Baden-Württemberg Herzlich Willkommen zum Webinar! Thema: Integration in kommunale Webangebote 09.12.2016

Ihre Referenten Daniel Gantert Technical Consultant Thomas Lederer Head of Business Development

Agenda Einführung Anbindung der REST-API Einbindung der Online-Antragsverfahren Integration des Servicekontos Offene Fragerunde

Erstellung und Verwaltung von Daten Admin Center Kommunales CMS Öffnungszeiten Ansprechpartner Adressen...

Schnittstellentechnologien des Serviceportals REST-API Neue Technologie In Weiterentwicklung: v2 in Q2/2017 SOAP-Schnittstelle 15.12.2015 heute Legacy Abwärtskompatibel Wird nicht weiterentwickelt

REST-Operationen 1. GET (abrufen) 2. POST (komplexe Suchabfragen) Weitere Operationen (nicht in Verwendung) PATCH HEAD OPTIONS CONNECT TRACE PUT DELETE

Beispielanfrage Abrufen von Öffnungszeiten 1. ID der Organisationseinheit ermitteln über den Pfad /search/de q mit Bürgerbüro Konstanz belegen und den Filter f mit organisationseinheit Die Suche liefert jetzt nur Organisationseinheiten zurück. Anfrage: GET http://servicegateway:8083/search/de?q=bürgerbüro %20Konstanz&f=organisationseinheit Antwort: "id": "6017"

Beispielanfrage Abrufen von Öffnungszeiten 2. Ermitteln der aktuellen Öffnungszeiten einer Organisationseinheit über den Pfad /organisationseinheiten/{id}/infooeffnungszeitenstrukturiert Anfrage: GET http://servicegateway:8083/organisationseinheiten/6017 /infooeffnungszeitenstrukturiert

Beispielanfrage Abrufen von Öffnungszeiten Antwort [ { ] } "id": "6017", "typ": "ALLGEMEINE_OEFFNUNGSZEIT", "i18n": [ { "id": 5638, "sprache": "de", "hinweistext": "Service-Telefonzeiten" } ], "regulaerezeiten": [ { "tagesposition": "Jeder", "tagestyp": "Arbeitstag Mo-Fr", "start": "07:00", "end": "19:00", "zusatz": "" } ], "abweichendezeiten": [ { "id": 5638, "beginn": "", "ende": "", } ],... Kommunale Webseite

Übersicht aller Operationen REST-API Dokumentation https://sgw.service-bw.de/rest-documentation/ Service-BW Blog: Informationen zu Releases, Updates, Hotfixes https://www.service-bw.de/web/mitteilungen

Welche Daten können abgefragt werden? Lebenslagen Lebenslagen Beschreibungstext Lebenslagen Referenzen Leistungen Leistungen Beschreibungstext Leistungen Referenzen Organisationseinheiten Organisationseinheiten Beschreibungstext Mandanten Kontaktpersonen Zuständigkeiten Stichworte Stichworte - Referenzen Externe Formularanzeige Externe Formulare Gebiete Schnittstellen Benutzer Weitere Informationen Suchindex: Suche

Beantragung eines Zugangs 1. E-Mail an: service-bw@im.bwl.de mit Ansprechpartner (E-Mail) AGS oder Gemeindename 2. Benutzerservice erzeugt Zugang inkl. Berechtigungen und übergibt Benutzername (ws_11223344) Passwort ID des Mandanten / X-SP-Mandant (132) 3. Kommune gibt Zugangsdaten des API-Benutzers ggf. an ihren Dienstleister weiter (NIE der Benutzerservice selbst!)

Erzeugung eines Tokens

Erzeugung eines Tokens API-Token

Formulare erstellen

Prozesse modellieren

Antrag stellen

Ausbaustufen Stufe 1 Absprung durch Link, neues Fenster Authentisierung via Servicekonto Darstellung im service-bw Design

Prozessintegration (Beispiel Stufe 1) http://www.konstanz.de

Schematische Darstellung der Einbindung Stufe 1 Abruf der Prozess-URL über REST-API Link auf Prozess-URL

Ausbaustufen Stufe 1 Stufe 2 Absprung durch Link, neues Fenster Authentisierung via Servicekonto Darstellung im service-bw Design Absprung durch Link, neues Fenster Authentisierung via Servicekonto Anzeige des Behördenlogos Verwendung eigener Schriftarten, -farben, -größen ( CSS )

Prozessintegration (Beispiel Stufe 2) http://www.konstanz.de

Schematische Darstellung der Einbindung Stufe 2 Abruf der Prozess-URL über REST-API Link auf Prozess-URL CSS

Ausblick: Vollintegration (Stufe 3)

Einbindung in kommunale Webseiten (Stufe 3) Schematische Darstellung der Einbindung (Vollintegration) Abruf der Prozess-URL über REST-API Link auf Prozess-URL

Prozessintegration in Kommunenwebseiten Hohe Sicherheit und Transparenz Einhaltung Datensicherheit Nutzerfreundlich Integration in das Design kommunaler Webseiten Möglichst geringer Einrichtungsaufwand für Kommunen

Anbindung Servicekonto an Dienste Dritter Ziel: Kommunale Anwendungen mit wenig Aufwand an Servicekonto anbinden Identity Management Service (Login) SAML-Standard ( Security Assertion Markup Language ) Zugriff auf Servicekonto-Eigenschaften (ID, Vorname, Nachname, ) Zentrale Kontoverwaltungsdienste (Passwort ändern / zurücksetzen,...)

Anbindung Servicekonto an Dienste Dritter Branding der Login-Seite mit einem Kommunen-Logo inklusiv Single Sign-On (SSO) Integration mit Servicekonto-Dienste Verschlüsseltes Postfach...

Offene Fragerunde (bis 10.30 Uhr) Stellen Sie Ihre Frage gerne über die Chat-Funktion: Wir versuchen Ihre Frage live und für alle Teilnehmer zu beantworten.

Weiterführende Informationen Hilfreiche Links Kurzanleitungen und Dokumentationen F https://www.service-bw.de/web/handreichungen-und-dokumente/ Online-Hilfe (Admin Center) F https://www.service-bw.de/web/online-hilfe REST-API Dokumentation F https://sgw.service-bw.de/rest-documentation/

Vielen Dank! Ministerium für Inneres, Digitalisierung und Migration Baden-Württemberg Willy-Brandt-Straße 41 70173 Stuttgart www.im.baden-wuerttemberg.de SEITENBAU GmbH Seilerstraße 7 78467 Konstanz www.seitenbau.com