On-Premises Excel API: Deine Daten, deine Infrastruktur

On-Premises Excel API: Volle Kontrolle über deine Daten

Dein Finanzteam hat ein komplexes Preismodell in Excel gebaut. Deine Aktuare pflegen Risikoberechnungen, an denen jahrelang gefeilt wurde. Deine Steuerabteilung hat Formeln für Grenzfälle, die sonst niemand versteht.

Jetzt sollen andere Systeme diese Berechnungen nutzen. Aber die Daten einer Berechnung dürfen dein Netzwerk nicht verlassen, wegen Datenschutzrecht, Branchenregulierung oder eurer eigenen Sicherheitsrichtlinie.

Die Herausforderung: Excel-Logik als API ohne Cloud

Die üblichen Optionen:

  • Alles neu schreiben. Die Excel-Logik in Python, Java oder JavaScript nachbauen und danach zwei Versionen synchron halten.
  • Manuell bleiben. Excel-Dateien weiter herumreichen, mit den Fehlern und Versionskonflikten, die das mit sich bringt.
  • Eine Cloud-API nutzen. Dann werden die Werte jeder Berechnung auf fremden Servern verarbeitet.

Für sensible Modelle passt keine der drei.

Die Lösung: In der App bauen, auf eigenen Servern betreiben

SpreadAPI Runtime berechnet deine Services auf Infrastruktur, die du selbst betreibst. Deine Anwendungen rufen den Service in deinem eigenen Netzwerk auf, und die Werte eines Aufrufs verlassen es nicht.

SpreadAPI On-Premises in drei Schritten: im Browser bauen, Paket exportieren, intern betreiben
SpreadAPI On-Premises in drei Schritten: im Browser bauen, Paket exportieren, intern betreiben

Schritt 1: Den Service in der App bauen

Du baust den Service in der SpreadAPI-App im Browser, wie für die Cloud: Excel-Arbeitsmappe importieren, Eingaben und Ausgaben wählen und die Berechnung auf dem Tab Konfiguration testen. Das Testpanel rechnet im Editor in deinem Browser.

Schritt 2: Das Runtime-Paket exportieren

Öffne das Drei-Punkte-Menü im Kopf des Service und wähle Für Runtime exportieren, dann klicke auf Runtime-Paket exportieren. Eine JSON-Datei wird auf deinen Computer geladen. Sie enthält die vollständige Service-Konfiguration und die Daten der Arbeitsmappe, einschließlich der Formeln.

Behandle diese Datei wie die ursprüngliche Excel-Datei: sicher aufbewahren und nur innerhalb deiner Organisation weitergeben.

Schritt 3: Auf deiner Infrastruktur betreiben

Installiere SpreadAPI Runtime auf deinem Server und importiere das Paket. Der Service steht dann als REST-API in deinem Netzwerk bereit. Wenn sich die Arbeitsmappe oder die Parameter ändern, exportierst du das Paket erneut und lädst die neue Datei in die Runtime.

Die Arbeitsmappe schon beim Bauen aus der Cloud heraushalten

Standardmäßig wird ein Service, den du baust, in deinem SpreadAPI-Konto gespeichert. Das technische Whitepaper beschreibt einen zweiten Modus für Organisationen, die auch das nicht möchten: In der Speicher-Einstellung der App wählst du Privat statt Cloud, der Service wird dann in deinem Browser gehalten, und du exportierst das Runtime-Paket von dort. Wenn dir das wichtig ist, sprich es an, wenn du die Runtime anfragst, damit die Einrichtung für deine Umgebung geprüft wird.

SpreadAPI Datenfluss: Berechnungsdaten bleiben in deinem privaten Netzwerk
SpreadAPI Datenfluss: Berechnungsdaten bleiben in deinem privaten Netzwerk

Die Runtime

Die folgenden Punkte stammen aus dem technischen Whitepaper (englisch).

  • Betrieb: als Docker-Container oder als Node.js-Anwendung.
  • Speicher: das lokale Dateisystem. Service-Definitionen und Arbeitsmappen-Daten sind JSON-Dateien. Eine externe Datenbank ist nicht nötig.
  • Netzwerk: Ausgehende Verbindungen sind nicht erforderlich. Die Runtime eignet sich für Umgebungen ohne Verbindung zum Internet.
  • Updates: Du aktualisierst den Container selbst, nach deinem Zeitplan.
  • Skalierung: horizontal, mit mehreren Containern hinter deiner Container-Orchestrierung.
  • Eingabe- und Ergebniswerte: werden verarbeitet, nicht gespeichert.

Den Container starten

Wie im Whitepaper beschrieben:

docker pull spreadapi/runtime:latest

docker run -d -p 3001:3001 \
  -v ./services:/app/services \
  -v ./logs:/app/logs \
  spreadapi/runtime:latest

curl http://localhost:3001/api/health

Der Zugang zur Runtime ist Teil deiner Vereinbarung; siehe unten "So bekommst du sie".

Die API der Runtime

GET       /api/health         Health-Check und Version
GET       /api/services       Bereitgestellte Services auflisten
GET       /api/services/{id}  Metadaten und Schema eines Service
GET/POST  /api/execute/{id}   Eine Berechnung ausführen
POST      /api/upload         Ein Service-Paket bereitstellen

Eine Berechnung wird über REST mit JSON aufgerufen, wie ein Cloud-Service. Die Adresse ist die deiner eigenen Runtime, nicht spreadapi.io:

curl -X POST http://localhost:3001/api/execute/{id} \
  -H "Content-Type: application/json" \
  -d '{"inputs": {"quantity": 100, "region": "EU"}}'

Unterstützte Excel-Funktionen

Die Berechnungs-Engine listet mehr als 500 Excel-Funktionen, darunter:

  • Verweise: SVERWEIS, WVERWEIS, XVERWEIS, INDEX, VERGLEICH
  • Dynamische Arrays: FILTER, SORTIEREN, SORTIERENNACH, EINDEUTIG, SEQUENZ
  • LET und LAMBDA, mit Helfern wie MAP, REDUCE und BYROW
  • Finanzen: NBW, IKV, RMZ, ZW, BW, ZINS, XKAPITALWERT, XINTZINSFUSS
  • Statistik- und Mathematikfunktionen

VBA-Makros laufen nicht, und Verknüpfungen zu anderen Arbeitsmappen werden nicht verfolgt. Siehe Unterstützte Excel-Funktionen.

Wir veröffentlichen keine Performance-Zahlen für die Runtime, weil sie von deiner Arbeitsmappe und deiner Hardware abhängen. Für die Cloud haben wir eine Arbeitsmappe gemessen und beschreiben die Methode in Excel API Antwortzeit.

Was die Runtime für eine Sicherheitsprüfung bedeutet

Aus der Checkliste im Whitepaper:

  • Datenstandort: Alle Daten liegen auf deiner Infrastruktur.
  • Daten bei der Übertragung: nur innerhalb deines Netzwerks.
  • Gespeicherte Daten: deine Verschlüsselung, deine Richtlinien.
  • Zugriffskontrolle: Du stellst die Runtime hinter deine eigene Zugriffsverwaltung.
  • Externe Abhängigkeiten: keine. Sie läuft offline.
  • Zugriff des Herstellers: SpreadAPI hat keinen Zugriff auf die Daten in deiner Runtime.

Eines ist die Runtime nicht: ein Zertifikat. Sie ist eine Software-Komponente, die in deiner Infrastruktur läuft. Die Compliance-Zertifizierung bleibt Aufgabe deiner Organisation, auf Grundlage eures gesamten Sicherheitskonzepts.

Für wen sie gedacht ist

  • Organisationen, deren Daten auf den eigenen Servern bleiben müssen, zum Beispiel in Finanzdienstleistung, Versicherung, Gesundheitswesen oder Beratung.
  • Teams mit Compliance-Regeln, die es nicht erlauben, Berechnungsdaten in einer externen Cloud zu verarbeiten.
  • Umgebungen ohne Verbindung zum Internet.

Wenn die Cloud für deine Daten in Ordnung ist, brauchst du die Runtime nicht. Ein regulärer Plan ist einfacher.

So bekommst du sie

Die On-Premises-Runtime gehört zum Custom-Plan und wird individuell vereinbart. In Basic und Pro ist sie nicht enthalten.

  1. Lies die On-Premises-Seite und das technische Whitepaper.
  2. Schreib an support@airrange.io oder klicke in der App unter Upgrade Your Plan auf Custom.
  3. Beschreibe deine Umgebung: wo die Runtime laufen soll, wie viele Services und Aufrufe du erwartest und welche Compliance-Regeln gelten.

Den Service kannst du schon vorher in der App bauen und testen.

Mehr erfahren

Verwandte Artikel