Zum Inhalt springen

Fragen zu UniCore

Antworten zum Verkauf Ihrer API, von Plänen und Limits bis zu Zahlung und Steuer. Außerdem zum Selbstbetrieb von UniCore und zu Erweiterungen auf Anfrage.

Häufige Fragen

Ihre Frage ist nicht dabei? Schreiben Sie uns kurz, worum es geht.

Verkaufen und abrechnen

Ihre API bleibt, wie sie ist. Ein Relay veröffentlicht sie über das API-Gateway von UniCore und setzt Anmeldung, Berechtigungen und Limits davor. Die Routen stammen aus Ihrem OpenAPI-Dokument oder werden von Hand angelegt. UniCore setzt Ihre Zugangsdaten zur API selbst ein, sodass sie für Aufrufer unsichtbar bleiben. Streaming und WebSockets werden weitergeleitet. Pläne, Verbrauchsmessung und Abrechnung gelten dann für die Aufrufe über das Relay.

Per Karte über Stripe oder per Überweisung. Sie verbinden Ihr eigenes Stripe-Konto, Ihre Kunden zahlen also direkt an Sie, ohne Umsatzbeteiligung von UniCore. Beim ersten Kauf wird die Karte gespeichert, spätere Rechnungen werden automatisch abgebucht. Überweisungen buchen Sie selbst ein. Weitere Zahlungsdienstleister können bei Bedarf hinzugefügt werden.

Die Umsatzsteuer wird je Verkauf bestimmt. UniCore unterstützt Steuersätze je Land, die Kleinunternehmerregelung nach § 19 UStG und das Reverse-Charge-Verfahren in der EU mit VIES-Prüfung der USt-IdNr. des Kunden. Verkauft wird nur in Länder, für die Sie einen Steuersatz hinterlegt haben. So wird kein Verkauf versehentlich mit null Prozent besteuert. Jede Rechnung und jede Gutschrift ist eine PDF/A-3-Datei mit angehängten E-Rechnungsdaten nach EN 16931 (ZUGFeRD, Factur-X), bei Leitweg-ID des Käufers eine XRechnung. Rechnungen werden ausgestellt, sobald die Angaben zu Verkäufer und Käufer vollständig sind. Steuersätze und Verkäuferangaben hinterlegen Sie selbst, am besten gemeinsam mit Ihrer Steuerberatung.

Das legen Sie je Limit fest. Ein harter Stopp antwortet mit HTTP 429, dem Zeitpunkt des Zurücksetzens und einem Retry-After-Header. Bei leerem Guthaben antwortet die API mit HTTP 402. Bei Mehrverbrauch wird alles, was über das enthaltene Kontingent hinausgeht, zum Ende des Abrechnungszeitraums abgerechnet, je Einheit, gestaffelt oder nach Volumen. Voraussetzung ist, dass der Kunde die Abrechnung nach Verbrauch eingeschaltet und die Preise bestätigt hat. Mit einem Kostendeckel begrenzen Sie den Mehrverbrauch. Ist er erreicht, antwortet die API ebenfalls mit 429, genau wie bei Rate-Limits.

Ja. Die Shop-Bausteine liefern Ihrem Web-Team React-Komponenten für Preisseite, Warenkorb, Kasse, Verbrauch, Rechnungen und den 14-tägigen Widerruf, dazu einen generierten TypeScript-Client für den Rest. Sie binden sie in Ihre eigene Website ein, und ein fertiges Referenzportal zeigt, wie das geht. Ein Planwechsel wird zum Ende des laufenden Abrechnungszeitraums wirksam.

Eine Kartenabbuchung wird bis zu viermal versucht, mit einem, drei und fünf Tagen Abstand zwischen den Versuchen. Drei Tage nach der ersten fehlgeschlagenen Abbuchung wird das Abonnement ausgesetzt und der Zugang pausiert, während die übrigen Versuche weiterlaufen. Sobald der Kunde zahlt, wird das Abonnement wieder aktiviert. Bleibt die Zahlung aus, endet es 30 Tage nach der Aussetzung. Alle Fristen sind Standardwerte, die Sie anpassen können. Ihre Kunden erhalten Abrechnungshinweise per E-Mail und in der App.

Aktuell melden sich Benutzer mit Passwort oder über Google, Microsoft oder einen beliebigen OIDC-Anbieter an, den Ihr Mandant anbindet, etwa Keycloak. Die Anmeldung mit Apple steht in mobilen Apps zur Verfügung. Die Passwort-Anmeldung bleibt neben einem externen Anbieter bestehen. Sie können den Zugriff nach IP-Adresse beschränken, und API-Aufrufer verwenden API-Schlüssel statt Passwörtern. Eine Erweiterung um SAML und Zwei-Faktor-Anmeldung ist geplant.

Aktuell werden Planwechsel zum Ende des Abrechnungszeitraums unterstützt, eine anteilige Verrechnung gibt es dabei nicht. Einmalige Plugin-Gebühren werden nicht in Rechnung gestellt. Die Zahlungsanbindung läuft über den Zahlungsdienstleister Stripe. Weitere Dienstleister und Abrechnungsoptionen können bei Bedarf hinzugefügt werden, sprechen Sie uns gerne an.

Betrieb

Auf Ihrem eigenen Server, als Single-Server-Compose-Bundle oder als vier getrennte Dienste mit dem Betreiber-Dashboard. Das Bundle startet PostgreSQL, einen einmaligen Schema-Updater, die API, das API-Gateway, den Job-Executor, das Betreiber-Dashboard und optional einen nginx-TLS-Proxy. Die Grenzen für den Arbeitsspeicher summieren sich auf rund 2,7 GB, ausgelegt für einen Server mit 4 GB. UniCore ist für den Betrieb auf Ihrer eigenen Infrastruktur gebaut, damit Ihre Daten auf Ihren Servern bleiben. Wünschen Sie einen betreuten Betrieb, sprechen Sie uns gerne an.

PostgreSQL oder Microsoft SQL Server, jeweils mit eigenen Migrationen. Das Bundle bringt einen vorkonfigurierten PostgreSQL-Container mit. Für SQL Server oder eine vorhandene PostgreSQL-Instanz setzen Sie Datenbanktyp und Verbindungszeichenfolge und lassen den Container weg.

Sie führen deploy.sh aus. Das Skript erzeugt Datenbankpasswort, Verschlüsselungsschlüssel und den Pepper für API-Schlüssel, fragt das Passwort des ersten Administrators ab, schreibt die Host-Konfiguration und startet den Stack. Sie liefern die Lizenzdatei, ein Lesetoken für unsere Container-Registry und, mit dem Proxy, eine Domain samt TLS-Zertifikat. Ein einmaliger Updater migriert die Datenbank und spielt Startdaten ein, bevor die Hosts hochfahren.

Ja. Auf einem Rechner mit Internetzugang laden Sie die Images, speichern sie als Archive, kopieren sie auf den Server und führen das Offline-Deployment-Skript aus. Installation und Lizenzprüfung laufen auf dem Server vollständig offline. Eine Internetverbindung brauchen nur Kartenzahlung über Stripe, die VIES-Prüfung von USt-IdNrn. und die Anmeldung über Google oder Microsoft, sobald Sie diese nutzen.

Laden Sie die neuen Images und starten Sie neu. Verwenden Sie dabei ein festes Versions-Tag statt latest. Der einmalige Updater migriert die Datenbank, bevor die Hosts starten. Sichern Sie die Datenbank deshalb vorher. Plugin-Updates steuern Sie getrennt davon. Eine neuere Plugin-Assembly wird als ausstehendes Update markiert, und Sie lösen das Upgrade aus, wenn es für Sie passt.

Sichern Sie die Datenbank. Bewahren Sie außerdem Kopien der Lizenzdatei und der .env-Datei auf. Die .env-Datei enthält den Verschlüsselungsschlüssel und den Pepper für API-Schlüssel. Beide Werte müssen unverändert erhalten bleiben. Nur mit demselben Schlüssel bleiben verschlüsselte Werte lesbar, und nur mit demselben Pepper bleiben ausgestellte API-Schlüssel gültig.

Lizenzierung

Modulweise. Module sind einzeln lizenzierbar und zu Paketen gebündelt, damit Sie nur den Umfang bezahlen, den Sie nutzen. Ihre Lizenzdatei nennt die lizenzierten Module, Beginn und Ende der Gültigkeit und eine optionale Kulanzfrist, und jeder Host prüft sie.

Eine Lizenz wird beim Start eines Hosts geprüft. In der Kulanzfrist nach dem Enddatum starten die Hosts weiterhin. Danach braucht ein neu gestarteter Host eine neue Lizenzdatei und nennt Ihnen beim Start den Grund. Laufende Hosts arbeiten ohne erneute Prüfung weiter. Notieren Sie sich das Enddatum, damit die neue Lizenzdatei rechtzeitig bereitliegt. Ihre Daten bleiben in jedem Fall, wo sie sind.

Ja. Wir stellen eine befristete Lizenz für die Module aus, die Sie ausprobieren möchten, auf Wunsch mit Kulanzfrist. Sie unterscheidet sich von einer Produktivlizenz nur durch Module und Enddatum. Nennen Sie uns den Umfang, den Sie testen möchten.

Lizenzen werden mit ML-DSA-87 signiert, dem als FIPS 204 standardisierten Post-Quanten-Signaturverfahren. Die Prüfung stützt sich allein auf dieses Verfahren, ohne klassische Zweitsignatur als Rückfallebene. Der Signaturkontext ist eigens für Lizenzen festgelegt, sodass eine Lizenzsignatur ausschließlich als Lizenz gilt.

Die Prüfung läuft vollständig offline. Ein Host prüft seine Lizenzdatei gegen einen in die Software eingebauten öffentlichen Schlüssel, ganz ohne Verbindung zu uns. Eine ausgestellte Lizenz bleibt deshalb bis zu ihrem Enddatum gültig und kann aus der Ferne nicht widerrufen werden.

Daten und Compliance

Ihnen. UniCore läuft auf Ihrer Infrastruktur. Kundendaten, Rechnungen und Nutzungsdaten bleiben also in Ihrer Datenbank. Als Anbieter sind Sie der Verkäufer, mit eigenem Stripe-Konto und eigenen Rechnungen.

Ausgewählte Spalten werden mit AES-GCM und einem Schlüssel, den Sie beim Deployment setzen, verschlüsselt gespeichert. Dazu gehören abgelegte Dateien (Ressourcen-Inhalte) und Geheimnisse wie Zugangsdaten zu Ihrer API, Stripe-Schlüssel, Client-Secrets der Anmeldung, Webhook-Secrets und Messenger-Tokens. Übrige Daten, etwa Benutzer und Rechnungen, schützen Sie mit der Datenbank- oder Datenträgerverschlüsselung Ihrer Infrastruktur. Bewahren Sie den Schlüssel sicher und unverändert auf, denn nur mit ihm bleiben verschlüsselte Werte lesbar.

Benutzer können ihre Daten als JSON exportieren und die Löschung beantragen. Das Konto wird sofort gesperrt und nach einer Wartezeit anonymisiert. Bis dahin lässt sich die Löschung noch abbrechen. Offener Verbrauch wird zuvor auf einer Schlussrechnung abgerechnet, ausgestellte Rechnungen bleiben als Buchungsbeleg vollständig erhalten. Plugins lesen eine Liste der gelöschten Benutzer, die frei von personenbezogenen Daten ist, und löschen ihre eigenen Daten.

Ja, mit dem Modul Auditierung aus dem Paket Platform. Es erfasst Änderungen und Lesezugriffe und lässt sich je Entität einzeln einstellen.

Darauf aufbauen

Nur wenn Sie Plugins schreiben, denn Plugins sind .NET-Assemblies. Beim API-Relay-Weg sind Sie frei in der Wahl. Ihre API kann in beliebiger Sprache geschrieben sein, weil UniCore vor Ihrer API steht und deren Code unberührt lässt.

Ja, auch ein Dritter kann es bauen. Das SDK ist ein Paket, und ein Analyzer hält ein Plugin vom Plattform-Quellcode getrennt. Es lässt sich also allein mit dem SDK schreiben. Ein Plugin läuft als voll vertrauenswürdiger Code im Host, mit dessen Rechten. Deshalb legen Sie fest, wem Sie vertrauen. Produktive Hosts laden nur Plugins, die mit einem von Ihnen als vertrauenswürdig festgelegten Schlüssel signiert sind, und das Hochladen ist Administratoren Ihres Hauptmandanten vorbehalten.

Eine Erweiterung um SAML und Zwei-Faktor-Anmeldung ist geplant. Weitere Funktionen setzen wir bei Bedarf oder auf Anfrage um. Dazu gehören eine Sandbox oder ein Marktplatz für Plugins Dritter, eigene Endpunkte über Datenabfragen und Formulare hinaus, Cloud-Speicher-Adapter als Ergänzung zur Dateiablage in der Datenbank, SMS als weiterer Kanal neben E-Mail, Telegram, Discord und WhatsApp, zusätzliche Pipeline-Bausteine wie Schleifen, Warteschritte, Mehrfachverzweigungen und Code-Blöcke sowie ein betreuter Betrieb. Was für das Verkaufen und Abrechnen gilt, steht oben unter „Verkaufen und abrechnen“. Sprechen Sie uns gerne an.

Fünf Leistungen mit festem Umfang: Onboarding und Go-live, ein API-Monetarisierungs-Sprint (Relay, Pläne, Kontingente), ein Plugin-Grundgerüst-Sprint, Betreiber-Schulung und eine Go-live-Bereitschaftsprüfung. Sie sind optional, weil die Plattform dokumentiert ist, und helfen am meisten beim ersten Produktivbetrieb. Die Preisseite nennt jede mit ihrem Umfang.

Lassen Sie sich UniCore an Ihrem eigenen Anwendungsfall zeigen