Marketplace

Publicar um aplicativo no marketplace o torna disponível para que outros espaços Kazzle o descubram e instalem.

O que a publicação faz

A publicação torna o aplicativo instalável por outros espaços. As pessoas veem o nome, subtítulo, ícone, editor e visibilidade do aplicativo e o instalam em seu próprio espaço. A publicação requer um subtitle em kazzle.config.ts — um slogan de uma linha sob o nome do aplicativo. A versão publicada usa o commit mais recente em main. Não há um branch de lançamento separado para aplicativos publicados. Por padrão, clicar em um aplicativo publicado abre sua interface implantada. Os aplicativos podem opcionalmente definir uma URL de inicialização personalizada, exigir identidade Kazzle antes de abrir ou receber webhooks de instalação e desinstalação. Veja Publique seu aplicativo para saber como publicar um aplicativo.

Instalações

Quando alguém instala um aplicativo publicado, Kazzle cria um registro de instalação dentro de seu espaço. O espaço que instala é proprietário da instalação e de todos os dados associados a ela.

Identidade do usuário

Quando um usuário Kazzle conectado abre um aplicativo instalado, Kazzle fornece ao aplicativo informações sobre o usuário atual. Kazzle anexa um JWT de curta duração como um token de portador. O aplicativo pode verificar o token contra o JWKS público de Kazzle para ler o usuário, espaço e instalação. O token contém estas declarações:

Declaração	Significado
`aud`	`kazzle:app`
`iss`	`https://api.kazzle.app`
`sub`	ID do usuário Kazzle
`user`	`{ id, email }` do usuário
`space`	ID do espaço onde o aplicativo está instalado
`install`	ID desta instalação específica

Exemplo de verificação:

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

Dois campos no manifesto do aplicativo controlam o comportamento de inicialização para aplicativos publicados:

kazzleAuth: required significa que apenas usuários Kazzle conectados podem abrir o aplicativo; optional permite que o aplicativo seja aberto sem uma identidade Kazzle.
launchUrl: substitui o ponto de entrada que abre quando um usuário clica no aplicativo.

Webhooks

Se o manifesto incluir uma webhookUrl, Kazzle envia solicitações HTTP POST para ela quando o aplicativo é instalado ou desinstalado. app.installed inclui a chave de instalação que o backend do editor pode usar para autenticar na API por instalação:

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

app.uninstalled contém o evento, ID de instalação, ID do aplicativo, ID do espaço e URL da API. O editor deve parar de usar a chave de instalação após receber este evento.

API por instalação

Cada instalação pode chamar uma API com escopo em https://api.kazzle.app. As chamadas são autenticadas com a chave de instalação (do backend do editor) ou o token de identidade do usuário (da interface hospedada). Todas as operações são automaticamente limitadas a essa instalação. Endpoints disponíveis: Os esquemas completos de solicitação e resposta são publicados na especificação OpenAPI de Kazzle em https://api.kazzle.app/openapi.json sob estes caminhos.

Método	Caminho	Descrição
GET	`/apps/secrets`	Listar nomes de segredos armazenados para a instalação
GET	`/apps/secrets/:name`	Ler um valor de segredo
PUT	`/apps/secrets/:name`	Armazenar um valor de segredo
DELETE	`/apps/secrets/:name`	Deletar um segredo
GET	`/apps/metadata`	Ler metadados não secretos para a instalação
PUT	`/apps/metadata`	Mesclar atualizações nos metadados da instalação

Segredos escritos através desta API são criptografados em repouso e isolados para a instalação específica. Eles são separados dos segredos armazenados no vault de um espaço.

Próximos passos

Publique seu aplicativo — como publicar um aplicativo e o que acontece depois.
Configuração — referência completa do manifesto, incluindo kazzleAuth, launchUrl e webhookUrl.

Começar

Construir

Usuários e dados

Publicar

Usar o Kazzle

Segurança

Referência

Marketplace

Marketplace

O que a publicação faz

Instalações

Identidade do usuário

Webhooks

API por instalação

Próximos passos

​Marketplace

​O que a publicação faz

​Instalações

​Identidade do usuário

​Webhooks

​API por instalação

​Próximos passos

Marketplace

O que a publicação faz

Instalações

Identidade do usuário

Webhooks

API por instalação

Próximos passos