Verbindung zu easyjob und CrewBrain einrichten

Ziel

Sie verbinden Scorebase mit Ihrem easyjob-Server und Ihrem CrewBrain-Konto, damit die App Projekte und Events beider Systeme lesen und – nach Ihrer Freigabe – in CrewBrain schreiben kann.

Voraussetzungen

• Die App EasyJob → CrewBrain ist für Ihre Organisation freigeschaltet.
• Sie sind Administrator (der Menüpunkt Verbindung erscheint nur für Administratoren) und haben das Recht Verbindungen bearbeiten.
• easyjob: ein Benutzer mit Zugriff auf die easyjob WebAPI und die Adresse Ihres easyjob-Servers. Scorebase greift über das Internet auf diese Adresse zu – sie muss deshalb von aussen erreichbar sein. Interne oder private Adressen (zum Beispiel localhost oder 192.168.…) werden beim Speichern abgelehnt.
• CrewBrain: die Adresse Ihrer CrewBrain-Subdomain, ein Benutzer mit Passwort sowie ein OAuth-Client (siehe unten).

Schritt 1: OAuth-Client in CrewBrain anlegen

1. Melden Sie sich in CrewBrain als Verwalter an.
2. Öffnen Sie Verwaltung → Schnittstellen → OAuth und legen Sie einen neuen OAuth-Client an.
3. Aktivieren Sie die Grant Types password und refresh_token.
4. Notieren Sie Client-ID und Client-Secret.

Tipp: Verwenden Sie für Scorebase einen eigenen CrewBrain-Benutzer. So lassen sich Änderungen der App leichter zuordnen, und Sie können den Zugang bei Bedarf gezielt sperren, ohne andere Personen zu stören.

Schritt 2: Zugangsdaten in Scorebase eintragen

1. Öffnen Sie in der App EasyJob → CrewBrain den Menüpunkt Verbindung. Die Seite heisst Verbindung einrichten.
2. Füllen Sie die drei Abschnitte aus:

Verbindungsname

Feld	Bedeutung
Name	Frei wählbarer Name, zum Beispiel „Produktion". Pflichtfeld.

easyjob

Feld	Bedeutung
Benutzername	easyjob-Benutzer für die WebAPI
Passwort	Passwort dieses Benutzers
Server-URL	Adresse Ihres easyjob-Servers, zum Beispiel https://server.beispiel.ch:8009. Mit https://, wenn der Server verschlüsselt (bei easyjob auf eigenem Server üblich). Ein Schrägstrich am Ende wird entfernt.
Selbstsigniertes Zertifikat akzeptieren	Nur für https-Adressen. Setzen Sie das Häkchen, wenn Ihr easyjob-Server ein selbst ausgestelltes Zertifikat verwendet. Die Identität des Servers wird dann nicht geprüft – sinnvoll nur für den eigenen easyjob-Server.

CrewBrain

Feld	Bedeutung
Subdomain-URL	Nur die Adresse ohne Pfad, zum Beispiel https://meinefirma.crewbrain.com
Client-ID	Aus Schritt 1. Pflichtfeld.
Client-Secret	Aus Schritt 1
Benutzername	CrewBrain-Benutzer
Passwort	Passwort dieses Benutzers

3. Klicken Sie auf Speichern. Die Meldung „Verbindung gespeichert" bestätigt den Vorgang.

Passwörter, Benutzernamen und das Client-Secret werden verschlüsselt gespeichert. Mit dem Augen-Symbol neben einem Passwortfeld blenden Sie Ihre Eingabe ein oder aus.

Schritt 3: Verbindung testen

Nach dem ersten Speichern erscheinen in beiden Abschnitten die Knöpfe EasyJob testen und CrewBrain testen.

1. Klicken Sie auf EasyJob testen. Eine grüne Meldung „EasyJob: …" bedeutet: Anmeldung erfolgreich.
2. Klicken Sie auf CrewBrain testen. Eine grüne Meldung „CrewBrain: …" bedeutet: Anmeldung erfolgreich.
3. Wechseln Sie zu Projekte und klicken Sie auf Daten aktualisieren, um die ersten Daten zu holen.

Zugangsdaten später ändern

Sind bereits Zugangsdaten gespeichert, bleiben die Felder für Benutzername, Passwort und Client-Secret leer und zeigen „Zugangsdaten bereits gespeichert. Neu eingeben zum Überschreiben."

• Leer lassen = der gespeicherte Wert bleibt unverändert.
• Neu eingeben = der gespeicherte Wert wird ersetzt.

Server-URL, Subdomain-URL, Client-ID und das Häkchen für das Zertifikat sehen Sie immer im Klartext und können sie direkt ändern.

Verbindung löschen

1. Klicken Sie unten auf Verbindung löschen und bestätigen Sie die Rückfrage.
2. Die Verbindung wird deaktiviert (Meldung „Verbindung deaktiviert"). Dashboard, Projekte, Regeln und Einstellungen zeigen danach „Keine Verbindung konfiguriert".

Dafür brauchen Sie das Recht Verbindungen löschen. In CrewBrain und easyjob wird dabei nichts gelöscht. Speichern Sie später wieder Zugangsdaten, ist die Verbindung erneut aktiv.

Wenn etwas nicht klappt

Symptom	Ursache	Lösung
„Ungültige EasyJob-URL (interne/private Adressen sind nicht erlaubt)"	Die Adresse zeigt auf ein internes Netz, zum Beispiel localhost oder eine private IP	Tragen Sie die öffentlich erreichbare Adresse Ihres easyjob-Servers ein. Fragen Sie im Zweifel Ihre IT.
„Selbstsigniertes Zertifikat akzeptieren ergibt nur mit einer https-Adresse Sinn"	Häkchen gesetzt, Adresse beginnt aber mit http://	Entweder https:// verwenden oder das Häkchen entfernen
„Zugangsdaten unvollständig …"	Beim ersten Speichern fehlen Benutzername, Passwort oder Client-Secret	Alle drei Geheimnisse beim ersten Mal ausfüllen
EasyJob-Test meldet einen Zertifikatsfehler	Der Server verwendet ein selbst ausgestelltes Zertifikat	Häkchen Selbstsigniertes Zertifikat akzeptieren setzen und speichern
EasyJob-Test meldet „404" oder „nicht gefunden"	Falsche Server-URL, zum Beispiel mit zusätzlichem Pfad	Nur Protokoll, Server und Port eintragen, ohne Pfad dahinter
CrewBrain-Test schlägt fehl, Benutzer und Passwort stimmen	OAuth-Client ohne die Grant Types „password" und „refresh_token" oder falsche Client-ID	In CrewBrain beide Grant Types aktivieren, Client-ID und Client-Secret neu eintragen
Die Test-Knöpfe fehlen	Die Verbindung ist noch nicht gespeichert	Zuerst Speichern
Der Menüpunkt Verbindung fehlt	Sie sind kein Administrator	Wenden Sie sich an Ihre Administratorin

Weiterlesen

• EasyJob → CrewBrain im Überblick
• Projekte vergleichen und abgleichen
• Häufige Fragen