Маркетплейс

Публикация приложения на маркетплейсе делает его доступным для обнаружения и установки другими пространствами Kazzle.

Что делает публикация

Публикация делает приложение доступным для установки другими пространствами. Люди видят имя приложения, подзаголовок, значок, издателя и видимость, а затем устанавливают его в своё пространство. Для публикации требуется subtitle в kazzle.config.ts — однострочный слоган под названием приложения. Опубликованная версия использует последний коммит в main. Для опубликованных приложений нет отдельной ветки релиза. По умолчанию клик на опубликованное приложение открывает его развёрнутый интерфейс. Приложения могут опционально установить пользовательский URL запуска, требовать идентификацию Kazzle перед открытием или получать вебхуки установки и удаления. Инструкции по публикации приложения см. в разделе Публикация приложения.

Установки

Когда кто-то устанавливает опубликованное приложение, Kazzle создаёт запись об установке в их пространстве. Пространство, выполняющее установку, владеет установкой и всеми связанными с ней данными.

Идентификация пользователя

Когда авторизованный пользователь Kazzle открывает установленное приложение, Kazzle предоставляет приложению информацию о текущем пользователе. Kazzle прикрепляет недолгоживущий JWT в качестве токена-носителя. Приложение может проверить токен по открытому JWKS Kazzle, чтобы прочитать пользователя, пространство и установку. Токен содержит эти утверждения:

Утверждение	Значение
`aud`	`kazzle:app`
`iss`	`https://api.kazzle.app`
`sub`	ID пользователя Kazzle
`user`	`{ id, email }` пользователя
`space`	ID пространства, в котором установлено приложение
`install`	ID этой конкретной установки

Пример проверки:

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

Два поля в манифесте приложения управляют поведением запуска для опубликованных приложений:

kazzleAuth: required означает, что только авторизованные пользователи Kazzle могут открыть приложение; optional позволяет открыть приложение без идентификации Kazzle.
launchUrl: переопределяет точку входа, которая открывается при клике пользователя на приложение.

Вебхуки

Если манифест включает webhookUrl, Kazzle отправляет HTTP POST запросы на него при установке или удалении приложения. app.installed включает ключ установки, который бэкенд издателя может использовать для аутентификации к API для конкретной установки:

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

app.uninstalled содержит событие, ID установки, ID приложения, ID пространства и URL API. Издатель должен прекратить использование ключа установки после получения этого события.

API для конкретной установки

Каждая установка может вызывать ограниченный API на https://api.kazzle.app. Вызовы аутентифицируются либо ключом установки (из бэкенда издателя), либо токеном идентификации пользователя (из размещённого интерфейса). Все операции автоматически ограничены этой установкой. Доступные эндпоинты: Полные схемы запросов и ответов опубликованы в спецификации OpenAPI Kazzle по адресу https://api.kazzle.app/openapi.json под этими путями.

Метод	Путь	Описание
GET	`/apps/secrets`	Список имён секретов, сохранённых для установки
GET	`/apps/secrets/:name`	Чтение значения секрета
PUT	`/apps/secrets/:name`	Сохранение значения секрета
DELETE	`/apps/secrets/:name`	Удаление секрета
GET	`/apps/metadata`	Чтение несекретных метаданных для установки
PUT	`/apps/metadata`	Объединение обновлений в метаданные установки

Секреты, записанные через этот API, зашифрованы в покое и изолированы для конкретной установки. Они отделены от секретов, хранящихся в хранилище пространства.

Следующие шаги

Публикация приложения — как опубликовать приложение и что происходит после.
Конфигурация — полный справочник манифеста, включая kazzleAuth, launchUrl и webhookUrl.

Начало работы

Создание

Пользователи и данные

Публикация

Использование Kazzle

Безопасность

Справочник

Маркетплейс

Маркетплейс

Что делает публикация

Установки

Идентификация пользователя

Вебхуки

API для конкретной установки

Следующие шаги

​Маркетплейс

​Что делает публикация

​Установки

​Идентификация пользователя

​Вебхуки

​API для конкретной установки

​Следующие шаги

Маркетплейс

Что делает публикация

Установки

Идентификация пользователя

Вебхуки

API для конкретной установки

Следующие шаги