Marketplace

Pubblicare un’app nel marketplace la rende disponibile per altri space Kazzle per scoprirla e installarla.

Cosa fa la pubblicazione

La pubblicazione rende l’app installabile da altri space. Le persone vedono il nome dell’app, il sottotitolo, l’icona, l’editore e la visibilità, quindi la installano nel proprio space. La pubblicazione richiede un subtitle in kazzle.config.ts — un tagline di una riga sotto il nome dell’app. La versione pubblicata utilizza il commit più recente su main. Non esiste un ramo di rilascio separato per le app pubblicate. La definizione dell’app sceglie esplicitamente se fare clic su un’app installata apre un componente, apre un URL incorporato o esterno, o non ha una superficie di avvio. Le app possono anche richiedere l’identità Kazzle prima dell’apertura o ricevere webhook del ciclo di vita. Vedi Pubblica la tua app per come pubblicare un’app.

Installazioni

Quando qualcuno installa un’app pubblicata, Kazzle crea un record di installazione all’interno del loro space. Lo space che installa possiede l’installazione e tutti i dati ad essa associati.

Identità utente

Quando un utente Kazzle connesso apre un’app installata, Kazzle fornisce all’app informazioni sull’utente corrente. Kazzle allega un JWT di breve durata come bearer token. L’app può verificare il token rispetto al JWKS pubblico di Kazzle per leggere l’utente, lo space e l’installazione. Il token contiene questi claim:

Claim	Significato
`aud`	`kazzle:app`
`iss`	`https://api.kazzle.app`
`sub`	ID utente Kazzle
`user`	`{ id, email }` dell’utente
`space`	ID dello space in cui l’app è installata
`install`	ID di questa installazione specifica

Esempio di verifica:

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;
}

La definizione dell’app controlla il comportamento di avvio per le app pubblicate:

launch: seleziona none, un componente app denominato, o un URL con una destinazione incorporata o esterna esplicita.
kazzleAuth: required significa che solo gli utenti Kazzle connessi possono aprire l’app; optional consente l’apertura dell’app senza un’identità Kazzle.

Webhook

Se la definizione dell’app include un webhookUrl, Kazzle invia richieste HTTP POST quando l’app viene installata o disinstallata. app.installed include la chiave di installazione che il backend dell’editore può utilizzare per autenticarsi all’API per installazione:

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

app.uninstalled contiene l’evento, l’ID installazione, l’ID app, l’ID space e l’URL API. L’editore dovrebbe smettere di utilizzare la chiave di installazione dopo aver ricevuto questo evento.

API per installazione

Ogni installazione può chiamare un’API con ambito su https://api.kazzle.app. Le chiamate sono autenticate con la chiave di installazione (dal backend dell’editore) o il token di identità utente (dall’interfaccia ospitata). Tutte le operazioni sono automaticamente limitate a quella installazione. Endpoint disponibili: Gli schemi completi di richiesta e risposta sono pubblicati nella specifica OpenAPI di Kazzle su https://api.kazzle.app/openapi.json in questi percorsi.

Metodo	Percorso	Descrizione
GET	`/apps/secrets`	Elenca i nomi dei segreti archiviati per l’installazione
GET	`/apps/secrets/:name`	Leggi un valore segreto
PUT	`/apps/secrets/:name`	Archivia un valore segreto
DELETE	`/apps/secrets/:name`	Elimina un segreto
GET	`/apps/metadata`	Leggi i metadati non segreti per l’installazione
PUT	`/apps/metadata`	Unisci gli aggiornamenti nei metadati dell’installazione

I segreti scritti tramite questa API sono crittografati a riposo e isolati all’installazione specifica. Sono separati dai segreti archiviati nel vault di uno space.

Passaggi successivi

Pubblica la tua app — come pubblicare un’app e cosa succede dopo.

Per iniziare

Costruire

Utenti e dati

Pubblicare

Usare Kazzle

Sicurezza

Riferimento

Marketplace

Marketplace

Cosa fa la pubblicazione

Installazioni

Identità utente

Webhook

API per installazione

Passaggi successivi

​Marketplace

​Cosa fa la pubblicazione

​Installazioni

​Identità utente

​Webhook

​API per installazione

​Passaggi successivi

Marketplace

Cosa fa la pubblicazione

Installazioni

Identità utente

Webhook

API per installazione

Passaggi successivi