Überblick
Die Tools laufen ohne Konto im Browser. Was hier steht, braucht den PAX-Server und meist den Team-Tarif. Grundregel überall: Eine Integration sieht nie mehr als die Person, die sie einrichtet. Private Dokumente und private Einträge gehen nie hinaus.
📥 Import Free
Jira (CSV, JSON), Trello (JSON) und MS Project (XML) als neues Kanban-Board oder Gantt-Projekt. Ohne Konto, ganz im Browser.
💬 Benachrichtigungen Team
Nachrichten an Microsoft Teams, Slack oder per Mail, wenn Dokumente angelegt, geändert oder gelöscht werden.
🔗 Webhooks Team
JSON an deine eigene Adresse, signiert, mit Wiederholung und Zustellprotokoll.
🔑 API-Schlüssel Team
Für n8n, Make, Zapier und eigene Skripte: Dokumente lesen und schreiben, Kalender lesen, Webhooks anmelden.
📅 Outlook Team
Urlaube, Termine, Sprints und Meilensteine aus dem Team-Jahreskalender im eigenen Outlook-Kalender.
🧩 Einbetten Team+
Tools in Confluence und SharePoint, mit Anmeldung und gemeinsamen Daten.
- Import aus Jira, Trello und MS Project
- Benachrichtigungen an Teams, Slack und E-Mail
- Webhooks und Signatur
- API und API-Schlüssel
- n8n, Make und Zapier
- Outlook-Kalender
- Einbetten in Confluence und SharePoint
- schauben-Konto für die Dienste von schauben_
Ob eine Integration bei dir zur Verfügung steht, siehst du im Admin Panel unter Integrationen oben in der Statuszeile. Einrichten dürfen Personen mit dem Team-Recht „Integrationen verwalten“ (Besitzer und Administratoren).
Import aus Jira, Trello und MS Project
Im Kanban-Board und im Gantt Chart gibt es den Knopf 📥 Importieren. Er legt immer ein neues Board bzw. Projekt an, nichts wird überschrieben. Die Datei bleibt in deinem Browser.
| Quelle | Datei | Was übernommen wird |
|---|---|---|
| Jira | Filter › Exportieren › CSV (alle Felder), englisch oder deutsch; oder JSON der REST-API | Zusammenfassung, Schlüssel, Status (wird Spalte), Priorität, zugewiesene Person, Fälligkeit, Startdatum, Labels, Beschreibung, Epic (im Gantt eine Gruppe) |
| Trello | Board-Menü › Drucken, Exportieren und Teilen › Als JSON exportieren | Listen (werden Spalten), Karten, Mitglieder, Fälligkeit, Labels mit Farbe, Checklisten als Text und Fortschritt; archivierte Karten nicht |
| MS Project | Datei › Speichern unter › Dateityp XML-Format (*.xml) | Vorgänge mit Start und Ende, Meilensteine, Fortschritt, Vorgänger, Ressourcen, Notizen; Sammelvorgänge werden Gruppen |
Online abrufen (Team-Tarif, wenn euer PAX-Server es kann): Jira Cloud mit Adresse, Mail und API-Token und einer JQL-Abfrage, Trello mit Board-Link, Key und Token. PAX nutzt die Zugangsdaten nur für diesen Abruf und speichert sie nicht.
Benachrichtigungen an Teams, Slack und E-Mail
Admin Panel › Integrationen › + Neu. Ereignisse: Dokument angelegt, geändert, gelöscht, Mitglied beigetreten oder ausgetreten; auf Wunsch nur für ein Tool. Änderungen am selben Dokument fasst PAX zusammen (höchstens eine Nachricht je 30 Sekunden).
Microsoft Teams
- Im gewünschten Kanal: ⋯ › Workflows › Vorlage „Bei Empfang einer Webhook-Anforderung im Kanal posten“.
- Den Workflow anlegen und die angezeigte Adresse kopieren (sie beginnt mit https:// und enthält logic.azure.com oder powerplatform.com).
- In PAX Art „Microsoft Teams“ wählen, Adresse einfügen, Testen.
Slack
- Unter api.slack.com/apps eine App anlegen, Incoming Webhooks einschalten, „Add New Webhook to Workspace“, Kanal wählen.
- Die Adresse (https://hooks.slack.com/services/…) in PAX unter Art „Slack“ eintragen, Testen.
Geht nur an aktive Mitglieder des Teams (keine Gäste, keine fremden Adressen). Die Mail enthält Titel, Tool und Link, nie den Inhalt.
Adressen von Teams und Slack sind selbst ein Geheimnis. PAX speichert sie verschlüsselt und zeigt sie nur gekürzt an.
Webhooks und Signatur
PAX schickt ein POST mit JSON an deine Adresse (nur https, keine internen Netze). Beim Anlegen zeigt PAX einmal das Geheimnis whsec_….
Nutzlast
{
"id": "5f0c…", // eindeutig je Ereignis, für Duplikate
"ereignis": "dokument.geaendert",
"zeit": "2026-11-03T10:15:00.000Z",
"team": { "id": "…", "name": "Beispiel-Team" },
"objekt": { "art": "dokument", "id": "…", "tool": "kanban", "toolName": "Kanban-Board",
"titel": "Sprint-Board", "version": 12,
"url": "https://pax-tools.de/tools/kanban.html?dok=…" },
"von": { "id": "…", "anzeigename": "Ada Beispiel" }
}
Ereignisse: dokument.erstellt, dokument.geaendert, dokument.geloescht, mitglied.beigetreten, mitglied.ausgetreten, beim Testen test. Inhalte schickt PAX nie; den Inhalt holst du bei Bedarf über die API.
Köpfe und Signatur prüfen
X-PAX-Ereignis, X-PAX-Zustellung und X-PAX-Signatur: t=<Unix-Sekunden>,v1=<HMAC-SHA256>. Die Signatur ist HMAC-SHA256 über <t>.<Rumpf> mit dem Geheimnis, als Hex.
// Node.js
const crypto = require('crypto');
function echt(rumpf, kopf, geheimnis) {
const [, t, v1] = /t=(\d+),v1=([0-9a-f]{64})/.exec(kopf) || [];
if (!t || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false; // höchstens 5 Minuten alt
const soll = crypto.createHmac('sha256', geheimnis).update(`${t}.${rumpf}`).digest('hex');
return crypto.timingSafeEqual(Buffer.from(soll), Buffer.from(v1));
}
# Python
import hmac, hashlib, re, time
def echt(rumpf: bytes, kopf: str, geheimnis: str) -> bool:
m = re.match(r"t=(\d+),v1=([0-9a-f]{64})", kopf or "")
if not m or abs(time.time() - int(m[1])) > 300: return False
soll = hmac.new(geheimnis.encode(), m[1].encode() + b"." + rumpf, hashlib.sha256).hexdigest()
return hmac.compare_digest(soll, m[2])
Wiederholungen
Antwortet deine Adresse nicht mit 2xx, versucht PAX es nach 1, 5, 30, 120 und 360 Minuten erneut. Antworten 4xx (außer 408 und 429) gelten sofort als endgültig. 410 Gone pausiert den Webhook (so meldet ihn ein Dienst ab). Nach 20 endgültig fehlgeschlagenen Zustellungen in Folge pausiert PAX ihn und schickt der anlegenden Person eine Mail. Das Protokoll der letzten 30 Tage steht im Admin Panel.
API und API-Schlüssel
Admin Panel › Integrationen › API-Schlüssel. Der Schlüssel (pax_…) ist nur einmal sichtbar, PAX speichert nur einen Prüfwert. Er handelt mit den Rechten der Person, die ihn angelegt hat, und gilt nur, solange sie im Team ist und „Integrationen verwalten“ darf. Höchstens 60 Anfragen je Minute und Schlüssel.
Adresse: https://app.pax-tools.de/api/v1/extern · Kopf: Authorization: Bearer pax_…
| Aufruf | Recht | Was |
|---|---|---|
| GET /ich | – | Team, Schlüssel und Rechte |
| GET /dokumente?tool=kanban | dokumente:lesen | Liste der Dokumente, die die Person sehen darf (ohne private), seitenweise über weiter |
| GET /dokumente/{id} | dokumente:lesen | Inhalt (JSON wie beim Export des Tools) |
| POST /dokumente | dokumente:schreiben | neues Dokument im Team: { "tool", "titel", "inhalt" } |
| PUT /dokumente/{id} | dokumente:schreiben | ändern: { "inhalt", "basisVersion" }, bei fremder Änderung 409 mit dem aktuellen Stand |
| GET /kalender?von=&bis= | kalender:lesen | Team-Jahreskalender nach den Rechten der Person, private nur als „belegt“ |
| GET /ereignisse | – | alle Ereignisse mit Beispiel-Nutzlast |
| POST /webhooks | webhooks | Webhook anmelden: { "url", "ereignisse": [ … ] } → { id, geheimnis } |
| DELETE /webhooks/{id} | webhooks | Webhook abmelden |
curl -H "Authorization: Bearer pax_ab12cd34_…" \
"https://app.pax-tools.de/api/v1/extern/dokumente?tool=statusreport"
Fehler kommen als { "fehler": { "code", "text" } } mit passendem Status: 401 Schlüssel ungültig, 403 Recht fehlt, 404 nicht gefunden (auch bei privaten Dokumenten), 409 Konflikt, 429 zu viele Anfragen.
n8n, Make und Zapier
Es gibt (noch) keine fertigen Bausteine im Katalog dieser Dienste. Die allgemeinen HTTP- und Webhook-Bausteine reichen aber für alles.
n8n
- Auslöser: Knoten „Webhook“ (POST) anlegen, die Produktions-Adresse in PAX als Webhook eintragen. Optional einen „Code“-Knoten mit der Signaturprüfung von oben dahinter.
- Aktion: Knoten „HTTP Request“ mit Credential „Header Auth“ (Name
Authorization, WertBearer pax_…), URL z. B.…/extern/dokumente/{{ $json.objekt.id }}.
Make
- Auslöser: „Webhooks › Custom webhook“, Adresse kopieren und in PAX eintragen, in PAX Testen drücken, damit Make die Struktur lernt.
- Aktion: „HTTP › Make a request“ mit Kopf
Authorization: Bearer pax_….
Zapier
- Auslöser: „Webhooks by Zapier › Catch Hook“, Adresse in PAX eintragen, Test schicken.
- Aktion: „Webhooks by Zapier › Custom Request“ oder „GET“ mit dem Kopf wie oben.
- Wer eine eigene Zapier-Integration baut: REST-Hooks über
POST /extern/webhooksanmelden, beim AbschaltenDELETE /extern/webhooks/{id}; Beispiel-Daten liefertGET /extern/ereignisse.
Outlook-Kalender
Jede Person verbindet ihr Microsoft-365-Konto im Panel › Verbindungen. PAX legt dort einen eigenen Kalender „PAX · Teamname“ an und schreibt hinein:
- Nur meine Einträge oder Team-Sicht: genau das, was die Person im Team-Jahreskalender sieht, dazu Sprints und Meilensteine aus Gantt, Dev Tracker und PI Planning; Feiertage auf Wunsch.
- Private Einträge nur als „Belegt“ (in Outlook als privat markiert), Notizen nie. Eigene Urlaube erscheinen als „abwesend“.
- Nur in eine Richtung: Änderungen machst du in PAX. Was du im PAX-Kalender in Outlook änderst, überschreibt der nächste Abgleich.
- Abgleich nach jeder Änderung im Team (gebündelt) und sonst stündlich. Trennen löscht den PAX-Kalender in Outlook.
PAX bekommt nur die Rechte „Kalender lesen und schreiben“ und „Profil lesen“, keinen Zugriff auf Mails. Manche Firmen verlangen eine Freigabe durch die IT (Entra ID › Unternehmensanwendungen). Administratoren schalten den Abgleich fürs Team im Admin Panel ab. Ohne Microsoft geht weiter das Kalender-Abo (ICS) im Jahreskalender.
Einbetten in Confluence und SharePoint
Mit Team+ laufen die Tools direkt in eurem Wiki, mit Anmeldung und den gemeinsamen Daten des Teams.
1. Einschalten
- Admin Panel › Integrationen › Einbetten: die Domain eures Wikis eintragen, z. B.
firma.atlassian.netoderfirma.sharepoint.com, dann einschalten. - Tool und optional ein Dokument wählen. PAX zeigt die Adresse (
https://app.pax-tools.de/api/v1/einbetten/…) und den fertigen HTML-Code.
2. Confluence
- Confluence Cloud: Seite bearbeiten,
/iframeoder Makro „iFrame“, Adresse einfügen, Höhe 800. Alternativ „Embed“/„Smart Link“ als Einbettung. - Confluence Data Center: Makro „HTML“ (muss ein Confluence-Admin erlauben) mit dem HTML-Code aus dem Admin Panel. Das Makro „Widget Connector“ kennt PAX nicht.
3. SharePoint Online
- Websiteeinstellungen › HTML-Feldsicherheit:
app.pax-tools.dezu den erlaubten Domains hinzufügen (macht ein Website-Besitzer). - Seite bearbeiten › Webpart Einbetten › HTML-Code aus dem Admin Panel einfügen.
4. Anmelden im Wiki
Browser geben eingebetteten Seiten meist keine Cookies. Deshalb öffnet Anmelden im eingebetteten Tool ein kleines Fenster von pax-tools.de. Dort meldest du dich wie gewohnt an (mit zweitem Faktor) und gibst die Anmeldung mit einem Klick an das Tool weiter. Sie gilt nur für dieses Team, nur für die Tools (nicht für Konto oder Admin Panel), höchstens einen Arbeitstag und endet, wenn du dich bei PAX abmeldest.
Popups erlauben: Blockt der Browser das Anmeldefenster, erlaube Popups für die Wiki-Seite. In Confluence muss das iFrame-Makro Popups zulassen (Standard).
Andere Seiten als die eingetragenen können PAX nicht einbetten: Der Browser blockt das (Content-Security-Policy frame-ancestors). Wird ein Tool ohne die PAX-Hülle eingebettet, läuft es wie ein normales Tool ohne Konto.
schauben-Konto für die Dienste von schauben_
Dein PAX-Konto ist zugleich dein schauben-Konto: Bei quickcopy, cloud-transfair und cloud-traum meldest du dich mit „Mit schauben-Konto anmelden“ an. Beim ersten Mal fragt PAX, welche Angaben der Dienst bekommt (Name, Mail, auf Wunsch die Abos). Abos werden je Dienst getrennt abgerechnet, Pakete über mehrere Dienste sind möglich. Verbundene Dienste siehst und trennst du im Panel › Verbindungen.
Für Entwickler der Dienste
OpenID Connect, Authorization Code mit PKCE (S256 Pflicht). Discovery: https://app.pax-tools.de/api/v1/oidc/.well-known/openid-configuration. Scopes: openid profile email abos offline_access. Clients registriert der Betreiber im Super Admin. Abos melden die Dienste mit ihren Client-Zugangsdaten über PUT /api/v1/schauben/abos/{sub}.