Zum Inhalt springen
Alle Hilfeartikel

Integrationen und Verbindungen einrichten

Aktualisiert am · Für Administration

Verbinden Sie Bauspur sicher mit Memomeister, PDS, Microsoft 365 und Anfragequellen und prüfen oder pausieren Sie jeden Konnektor einzeln.

Jede Verbindung hat einen eigenen Aktiv-Schalter und eine letzte technische Prüfung. Daten fließen erst über einen zusätzlich eingerichteten Ablauf.
Auf dieser Seite
  1. Verbindung und Ablauf unterscheiden
  2. Die Liste der Verbindungen
  3. Eine Verbindung anlegen
  4. Microsoft 365 verbinden
  5. Zugangsdaten sicher wechseln
  6. Eine Verbindung prüfen
  7. Eine Verbindung pausieren

Eine Verbindung speichert den technischen Zugang zu einem externen System. Bauspur verschlüsselt geheime Token, API-Schlüssel und Zertifikatsschlüssel. Ein Ablauf verwendet die Verbindung danach als Quelle oder Ziel.

Verbindung und Ablauf unterscheiden

  • Die Verbindung beantwortet: Auf welche Instanz oder welchen Mandanten darf Bauspur zugreifen?
  • Der Ablauf beantwortet: Welche Bauspur-Daten sollen wann und nach welchen Regeln fließen?

Eine aktive Verbindung startet noch keine beliebige Übertragung. Dafür muss zusätzlich der passende Ablauf eingerichtet und freigegeben sein.

Verbindungen, Firmen und Abläufe richtet nur ein Admin ein. Mit jeder anderen Rolle öffnen sich diese Bereiche nicht (Benutzer und Rechte).

Die Liste der Verbindungen

Unter Einstellungen → Verbindungen steht jede Verbindung als eine Zeile: Name, Integration, der Schalter „Verbindung aktiv“ und das Ergebnis der letzten Prüfung. Bei mehreren Firmen steht auch die Firma in der Zeile. Ein Hinweis wie „Deaktiviert“ oder „API-Schlüssel fehlt“ zeigt, wo Sie handeln müssen.

Wählen Sie den Namen einer Verbindung, um ihre Einstellungen zu öffnen. Eine Verbindung mit fehlgeschlagener Prüfung, fehlendem API-Schlüssel oder fehlender PDS-Instanz ist schon geöffnet.

Eine Verbindung anlegen

  1. Öffnen Sie Einstellungen → Verbindungen.
  2. Wählen Sie Verbindung anlegen.
  3. Wählen Sie die Integration und vergeben Sie einen eindeutigen Namen.
  4. Ordnen Sie bei mehreren Firmen den passenden Geltungsbereich zu.
  5. Tragen Sie die geforderten Zugangsdaten ein.
  6. Speichern Sie. Die neue Verbindung öffnet sich in der Liste.
  7. Wählen Sie dort Prüfen.

Der Typ einer Verbindung lässt sich später nicht ändern. Ein anderes Zielsystem oder ein anderer ERP-Mandant benötigt eine neue Verbindung und einen neuen Ablauf.

Auch die Basis-URL einer PDS-Verbindung gehört fest zu ihr. Ein anderes PDS-Ziel braucht eine neue Verbindung und einen neuen Ablauf mit eigenem Verlauf. Sonst würden schon übertragene Daten im neuen Ziel fälschlich als vorhanden gelten. Bauspur unterstützt derzeit nur PDS-Cloud-Adressen unter pdscloud.de, keine eigenen Domains und keine lokalen Installationen. Nach dem Speichern ist das Feld gesperrt. Nur eine gespeicherte Adresse, die Bauspur nicht verwenden kann, lässt sich korrigieren.

Microsoft 365 verbinden

Bauspur meldet sich als App-Registrierung bei Microsoft 365 an, ohne Benutzerkonto und ohne Kennwort. Dafür dient ein Zertifikat, dessen privaten Schlüssel nur Bauspur kennt.

  • Tenant-ID und Client-ID stehen in Entra ID auf der Übersichtsseite der App-Registrierung. Sie gehören fest zu dieser Verbindung. Ein anderer Tenant braucht eine neue Verbindung.
  • Ein neues Zertifikat laden Sie zuerst in der App-Registrierung unter „Zertifikate & Geheimnisse“ hoch. Danach tragen Sie es in Bauspur zusammen mit seinem privaten Schlüssel ein.
  • Prüfen holt ein Token und liest einen Benutzer des Verzeichnisses.

Microsoft 365 lässt die App nur auf die Kalender der direkten Mitglieder einer Gruppe zugreifen. Tragen Sie unter „Zugriffsgruppe“ die Objekt-ID dieser Gruppe aus Entra ID ein, und machen Sie die App dort zum Besitzer. Dann nimmt Bauspur die Postfächer, die am Kalender-Abgleich teilnehmen, selbst in die Gruppe auf und entfernt sie wieder. Bauspur entfernt nur Postfächer, die es selbst aufgenommen hat. Nach einer Aufnahme gibt Microsoft 365 den Zugriff erst nach bis zu zwei Stunden frei. Bleibt das Feld leer, verwalten Sie die Gruppe selbst.

Zugangsdaten sicher wechseln

Öffnen Sie die Verbindung in der Liste. Die Zugangsdaten stehen am Ende, mit dem Knopf Zugangsdaten speichern. Gespeicherte Geheimnisse zeigt Bauspur nicht wieder im Klartext an. Lassen Sie das Feld für ein neues Token leer, wenn der vorhandene Wert bleiben soll.

Verwenden Sie ein neues Token nur für dasselbe Konto und denselben Mandanten. Eine Verbindungsprüfung bestätigt den technischen Zugriff, kann aber nicht sicher erkennen, ob Sie versehentlich zu einem anderen Mandanten gewechselt haben.

Eine Verbindung prüfen

Öffnen Sie die Verbindung und wählen Sie Prüfen. Die Zeile zeigt danach Zeitpunkt und Ergebnis der letzten Prüfung. Ein Fehlertext nennt die Antwort des verbundenen Systems, ohne das gespeicherte Geheimnis anzuzeigen.

Bei einer Anfragequelle prüfen Sie stattdessen Webhook-Adresse und API-Schlüssel. Ein neu erzeugter Schlüssel wird nur einmal angezeigt und muss danach im sendenden System hinterlegt werden.

Eine Verbindung pausieren

Schalten Sie „Verbindung aktiv“ in der Zeile der Verbindung aus, wenn ein Zugang widerrufen wurde oder ein System vorübergehend nicht erreichbar ist. Sonst scheitert jeder Lauf und meldet einen Fehler. Hintergrundläufe rufen die Verbindung dann nicht mehr auf. Abläufe, Regeln, Zuordnungen und Verlauf bleiben erhalten. Prüfen bleibt möglich: So testen Sie ein neues Token oder einen neuen Schlüssel, bevor Sie die Verbindung wieder einschalten.

Bei einer deaktivierten Memomeister-Verbindung stoppt nur der Import neuer Inhalte. Bereits in Bauspur vorhandene Mappen können über einen aktiven Ziel-Konnektor weiter übertragen werden.

Noch eine Frage?

Schreiben Sie kurz, wo Sie gerade nicht weiterkommen. Nennen Sie wenn möglich den Bereich und den angezeigten Status.

Support kontaktieren