Marketplace

Publicar una aplicación en el marketplace la hace disponible para que otros espacios de Kazzle la descubran e instalen.

Qué hace la publicación

La publicación hace que la aplicación sea instalable por otros espacios. Las personas ven el nombre, subtítulo, icono, editor y visibilidad de la aplicación, y luego la instalan en su propio espacio. La publicación requiere un subtitle en kazzle.config.ts — un eslogan de una línea bajo el nombre de la aplicación. La versión publicada usa el último commit en main. No hay una rama de lanzamiento separada para aplicaciones publicadas. La definición de la aplicación elige explícitamente si hacer clic en una aplicación instalada abre un componente, abre una URL incrustada o externa, o no tiene superficie de lanzamiento. Las aplicaciones también pueden requerir identidad de Kazzle antes de abrirse o recibir webhooks de ciclo de vida. Consulta Publica tu aplicación para saber cómo publicar una aplicación.

Instalaciones

Cuando alguien instala una aplicación publicada, Kazzle crea un registro de instalación dentro de su espacio. El espacio que instala es propietario de la instalación y de cualquier dato asociado con ella.

Identidad del usuario

Cuando un usuario de Kazzle que ha iniciado sesión abre una aplicación instalada, Kazzle proporciona a la aplicación información sobre el usuario actual. Kazzle adjunta un JWT de corta duración como token portador. La aplicación puede verificar el token contra el JWKS público de Kazzle para leer el usuario, espacio e instalación. El token contiene estos claims:

Claim	Significado
`aud`	`kazzle:app`
`iss`	`https://api.kazzle.app`
`sub`	ID de usuario de Kazzle
`user`	`{ id, email }` del usuario
`space`	ID del espacio donde está instalada la aplicación
`install`	ID de esta instalación específica

Ejemplo de verificación:

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 definición de la aplicación controla el comportamiento de lanzamiento para aplicaciones publicadas:

launch: selecciona none, un componente de aplicación nombrado, o una URL con un destino incrustado o externo explícito.
kazzleAuth: required significa que solo los usuarios de Kazzle que han iniciado sesión pueden abrir la aplicación; optional permite que la aplicación se abra sin una identidad de Kazzle.

Webhooks

Si la definición de la aplicación incluye una webhookUrl, Kazzle envía solicitudes HTTP POST cuando la aplicación se instala o desinstala. app.installed incluye la clave de instalación que el backend del editor puede usar para autenticarse en la API por instalación:

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

app.uninstalled contiene el evento, ID de instalación, ID de aplicación, ID de espacio y URL de API. El editor debe dejar de usar la clave de instalación después de recibir este evento.

API por instalación

Cada instalación puede llamar a una API con alcance en https://api.kazzle.app. Las llamadas se autentican con la clave de instalación (desde el backend del editor) o el token de identidad del usuario (desde la interfaz alojada). Todas las operaciones se limitan automáticamente a esa instalación. Endpoints disponibles: Los esquemas completos de solicitud y respuesta se publican en la especificación OpenAPI de Kazzle en https://api.kazzle.app/openapi.json bajo estas rutas.

Método	Ruta	Descripción
GET	`/apps/secrets`	Lista los nombres de secretos almacenados para la instalación
GET	`/apps/secrets/:name`	Lee un valor de secreto
PUT	`/apps/secrets/:name`	Almacena un valor de secreto
DELETE	`/apps/secrets/:name`	Elimina un secreto
GET	`/apps/metadata`	Lee metadatos no secretos para la instalación
PUT	`/apps/metadata`	Fusiona actualizaciones en los metadatos de la instalación

Los secretos escritos a través de esta API se cifran en reposo y se aíslan a la instalación específica. Son independientes de los secretos almacenados en el vault de un espacio.

Próximos pasos

Publica tu aplicación — cómo publicar una aplicación y qué sucede después.

Empezar

Construir

Usuarios y datos

Publicar

Usar Kazzle

Seguridad

Referencia

Marketplace

Marketplace

Qué hace la publicación

Instalaciones

Identidad del usuario

Webhooks

API por instalación

Próximos pasos

​Marketplace

​Qué hace la publicación

​Instalaciones

​Identidad del usuario

​Webhooks

​API por instalación

​Próximos pasos

Marketplace

Qué hace la publicación

Instalaciones

Identidad del usuario

Webhooks

API por instalación

Próximos pasos