← Zurück zum Blog

Persönliche Schlüssel für die MainPath API

Persönliche Schlüssel geben Skripten und Pipelines Zugang zu MainPath, auch wenn niemand am Browser sitzt.

AutomatisierungZugangsdaten
Persönliche Schlüssel für die MainPath API

Ein Skript soll nachts einen Bericht abrufen oder nach einem Build auf MainPath zugreifen. Beides braucht eine Anmeldung, die ohne offenen Browser funktioniert. Seit dem 5. August 2026 kannst du dafür persönliche Schlüssel für die MainPath API anlegen.

Erstellen, ansehen und widerrufen

Die Schlüsselverwaltung findest du in deinen Kontoeinstellungen. Dort erstellst du neue Schlüssel, siehst die vorhandenen Einträge und widerrufst Schlüssel, die du nicht mehr brauchst.

Der geheime Wert wird direkt nach dem Erstellen einmalig angezeigt. Kopiere ihn in die Geheimnisverwaltung deiner Pipeline oder in deinen Passwortmanager. Danach lässt er sich nicht erneut abrufen. Geht er verloren, erstellst du einen neuen Schlüssel und widerrufst den alten. So kann auch jemand mit Zugriff auf dein Konto den gespeicherten geheimen Wert später nicht auslesen.

Anmeldung für Skripte und Pipelines

Mit einem persönlichen Schlüssel authentifiziert sich die mp CLI, ohne dass du dich vorher im Browser anmeldest. Dasselbe gilt für eigene Skripte, die mit der MainPath API arbeiten. Typische Einsatzzwecke sind:

  • Abläufe nach einem Build: Eine Pipeline löst auf MainPath einen Schritt aus oder liest Daten ab.
  • Wiederkehrende Aufgaben: Auswertungen, Aufräumarbeiten oder Berichte laufen nach Zeitplan.
  • Eigene Werkzeuge: Interne Kommandozeilenprogramme oder kleine Oberflächen greifen auf Plattformdaten zu.

Für diese Abläufe muss während der Ausführung niemand einen Anmeldedialog bestätigen.

Pipeline für Kunden-App

test
build
publish
release
Ein persönlicher Schlüssel authentifiziert den Zugriff aus einer Pipeline.

Weitere Zugänge außerhalb der Weboberfläche

MainPath bietet neben der Weboberfläche die MainPath Toolbox für den Desktop, die mp CLI für die Kommandozeile und ein Plugin für VS Code. Über einen MCP Server können auch Agenten für die Softwareentwicklung mit MainPath arbeiten und Funktionen aufrufen, die du sonst manuell bedienst.

Ein Schlüssel für jeden Zweck

Lege für jeden Einsatzzweck einen eigenen Schlüssel an, etwa für die Pipeline, dein lokales Werkzeug und das nächtliche Skript. Musst du einen davon ersetzen, betrifft das nur den zugehörigen Ablauf.

Schlüssel sind persönlich. Aktionen mit deinem Schlüssel werden dir zugeordnet. Braucht eine andere Person Zugriff, erstellt sie einen eigenen Schlüssel. Landet deiner an der falschen Stelle, widerrufst du ihn und erstellst einen neuen.

Speichere Schlüssel niemals im Repository, auch nicht kurz zum Testen. Ein späteres Löschen aus der Datei entfernt den Wert nicht aus der bisherigen Git Historie.

Vom Schlüssel zum automatisierten Ablauf

Wähle zunächst den Ablauf, für den du einen Schlüssel brauchst, und lege fest, wo sein geheimer Wert gespeichert wird. Die Anleitung zu CLI und Plugin für Agenten beschreibt die Einrichtung der Werkzeuge. Wie automatisierte Abläufe zusammenhängen, zeigt die Seite zur Automatisierung mit CI/CD.

Bereite deinen ersten automatisierten Ablauf vor

Lege in den Kontoeinstellungen einen Schlüssel für dein Skript an und hinterlege ihn in der dafür vorgesehenen Geheimnisverwaltung.

Danke für deine Anfrage

Wir haben deine Anfrage erhalten und melden uns schnellstmöglich bei dir.

Du möchtest direkt mit uns sprechen?

Buche hier einen passenden Termin für ein Erstgespräch mit Robin.

Kalender in einem neuen Tab öffnen