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.
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.
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/healthDer 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 bereitstellenEine 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.
- Lies die On-Premises-Seite und das technische Whitepaper.
- Schreib an support@airrange.io oder klicke in der App unter Upgrade Your Plan auf Custom.
- 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.