Marketplace

Das Veröffentlichen einer App im Marketplace macht sie für andere Kazzle Spaces verfügbar, um sie zu entdecken und zu installieren.

Was Veröffentlichung bewirkt

Veröffentlichung macht die App installierbar für andere Spaces. Nutzer sehen den Namen, Untertitel, das Symbol, den Herausgeber und die Sichtbarkeit der App und installieren sie dann in ihrem eigenen Space. Veröffentlichung erfordert einen subtitle in kazzle.config.ts — einen einzeiligen Slogan unter dem App-Namen. Die veröffentlichte Version verwendet den neuesten Commit auf main. Es gibt keinen separaten Release-Branch für veröffentlichte Apps. Standardmäßig öffnet ein Klick auf eine veröffentlichte App ihre bereitgestellte Benutzeroberfläche. Apps können optional eine benutzerdefinierte Start-URL festlegen, Kazzle-Identität vor dem Öffnen erfordern oder Webhooks für Installation und Deinstallation empfangen. Siehe Veröffentliche deine App für Anweisungen zum Veröffentlichen einer App.

Installationen

Wenn jemand eine veröffentlichte App installiert, erstellt Kazzle einen Installationsdatensatz in ihrem Space. Der installierende Space besitzt die Installation und alle damit verbundenen Daten.

Benutzeridentität

Wenn ein angemeldeter Kazzle-Nutzer eine installierte App öffnet, stellt Kazzle der App Informationen über den aktuellen Nutzer bereit. Kazzle fügt ein kurzlebiges JWT als Bearer-Token an. Die App kann das Token gegen Kazzles öffentliches JWKS verifizieren, um den Nutzer, Space und die Installation zu lesen. Das Token enthält diese Claims:

Claim	Bedeutung
`aud`	`kazzle:app`
`iss`	`https://api.kazzle.app`
`sub`	Kazzle-Nutzer-ID
`user`	`{ id, email }` des Nutzers
`space`	ID des Spaces, in dem die App installiert ist
`install`	ID dieser spezifischen Installation

Beispiel-Verifizierung:

import { jwtVerify, createRemoteJWKSet } from 'jose';

const JWKS = createRemoteJWKSet(new URL('https://api.kazzle.app/auth/.well-known/jwks.json'));

async function getUserFromToken(token: string) {
  const { payload } = await jwtVerify(token, JWKS, {
    audience: 'kazzle:app',
    issuer: 'https://api.kazzle.app',
  });
  return payload;
}

Zwei Felder im App-Manifest steuern das Startverhalten für veröffentlichte Apps:

kazzleAuth: required bedeutet, dass nur angemeldete Kazzle-Nutzer die App öffnen können; optional erlaubt das Öffnen der App ohne Kazzle-Identität.
launchUrl: überschreibt den Einstiegspunkt, der sich öffnet, wenn ein Nutzer auf die App klickt.

Webhooks

Wenn das Manifest eine webhookUrl enthält, sendet Kazzle HTTP-POST-Anfragen an diese URL, wenn die App installiert oder deinstalliert wird. app.installed enthält den Install-Schlüssel, den das Backend des Herausgebers zur Authentifizierung gegenüber der Pro-Installation-API verwenden kann:

{
  "event": "app.installed",
  "installId": "...",
  "appId": "...",
  "spaceId": "...",
  "apiUrl": "https://api.kazzle.app",
  "installKey": "kzl_inst_...",
  "user": { "id": "...", "email": "..." }
}

app.uninstalled enthält das Event, die Install-ID, die App-ID, die Space-ID und die API-URL. Der Herausgeber sollte die Verwendung des Install-Schlüssels nach Erhalt dieses Events einstellen.

Pro-Installation-API

Jede Installation kann eine begrenzte API auf https://api.kazzle.app aufrufen. Aufrufe werden authentifiziert mit entweder dem Install-Schlüssel (vom Backend des Herausgebers) oder dem Benutzeridentitäts-Token (von der gehosteten Benutzeroberfläche). Alle Operationen sind automatisch auf diese Installation begrenzt. Verfügbare Endpunkte: Vollständige Request- und Response-Schemas sind in der Kazzle OpenAPI-Spezifikation unter https://api.kazzle.app/openapi.json unter diesen Pfaden veröffentlicht.

Methode	Pfad	Beschreibung
GET	`/apps/secrets`	Liste der für die Installation gespeicherten Geheimnisnamen
GET	`/apps/secrets/:name`	Geheimniswert lesen
PUT	`/apps/secrets/:name`	Geheimniswert speichern
DELETE	`/apps/secrets/:name`	Geheimnis löschen
GET	`/apps/metadata`	Nicht-geheime Metadaten für die Installation lesen
PUT	`/apps/metadata`	Updates in die Metadaten der Installation zusammenführen

Geheimnisse, die über diese API geschrieben werden, sind im Ruhezustand verschlüsselt und isoliert auf die spezifische Installation. Sie sind getrennt von Geheimnissen, die im Vault eines Spaces gespeichert sind.

Nächste Schritte

Veröffentliche deine App — wie man eine App veröffentlicht und was danach passiert.
Konfiguration — vollständige Manifest-Referenz, einschließlich kazzleAuth, launchUrl und webhookUrl.

Erste Schritte

Erstellen

Nutzer und Daten

Veröffentlichen

Kazzle verwenden

Sicherheit

Referenz

Marketplace

Marketplace

Was Veröffentlichung bewirkt

Installationen

Benutzeridentität

Webhooks

Pro-Installation-API

Nächste Schritte

​Marketplace

​Was Veröffentlichung bewirkt

​Installationen

​Benutzeridentität

​Webhooks

​Pro-Installation-API

​Nächste Schritte

Marketplace

Was Veröffentlichung bewirkt

Installationen

Benutzeridentität

Webhooks

Pro-Installation-API

Nächste Schritte