Marketplace

Opublikowanie aplikacji na marketplace’u udostępnia ją innym przestrzeniom Kazzle do odkrycia i instalacji.

Co robi publikacja

Publikacja sprawia, że aplikacja może być instalowana przez inne przestrzenie. Użytkownicy widzą nazwę aplikacji, podtytuł, ikonę, wydawcę i widoczność, a następnie instalują ją w swojej przestrzeni. Publikacja wymaga subtitle w kazzle.config.ts — jednolinijkowego sloganu pod nazwą aplikacji. Opublikowana wersja używa najnowszego commita na main. Nie ma osobnej gałęzi wydania dla opublikowanych aplikacji. Definicja aplikacji jawnie wybiera, czy kliknięcie zainstalowanej aplikacji otwiera komponent, otwiera osadzony lub zewnętrzny adres URL, czy nie ma powierzchni uruchamiania. Aplikacje mogą również wymagać tożsamości Kazzle przed otwarciem lub otrzymywać webhooki cyklu życia. Przeczytaj Publikuj swoją aplikację, aby dowiedzieć się, jak opublikować aplikację.

Instalacje

Gdy ktoś instaluje opublikowaną aplikację, Kazzle tworzy rekord instalacji w ich przestrzeni. Instalująca przestrzeń jest właścicielem instalacji i wszelkich danych z nią związanych.

Tożsamość użytkownika

Gdy zalogowany użytkownik Kazzle otwiera zainstalowaną aplikację, Kazzle dostarcza aplikacji informacje o bieżącym użytkowniku. Kazzle dołącza krótkotrwały JWT jako token nośnika. Aplikacja może zweryfikować token względem publicznego JWKS Kazzle, aby odczytać użytkownika, przestrzeń i instalację. Token zawiera te roszczenia:

Roszczenie	Znaczenie
`aud`	`kazzle:app`
`iss`	`https://api.kazzle.app`
`sub`	ID użytkownika Kazzle
`user`	`{ id, email }` użytkownika
`space`	ID przestrzeni, w której aplikacja jest zainstalowana
`install`	ID tej konkretnej instalacji

Przykład weryfikacji:

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

Definicja aplikacji kontroluje zachowanie uruchamiania dla opublikowanych aplikacji:

launch: wybiera none, nazwany komponent aplikacji lub adres URL z jawnym osadzonym lub zewnętrznym celem.
kazzleAuth: required oznacza, że tylko zalogowani użytkownicy Kazzle mogą otworzyć aplikację; optional pozwala na otwarcie aplikacji bez tożsamości Kazzle.

Webhooki

Jeśli definicja aplikacji zawiera webhookUrl, Kazzle wysyła żądania HTTP POST do niego, gdy aplikacja jest instalowana lub odinstalowywana. app.installed zawiera klucz instalacji, który backend wydawcy może użyć do uwierzytelnienia się w interfejsie API dla każdej instalacji:

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

app.uninstalled zawiera zdarzenie, ID instalacji, ID aplikacji, ID przestrzeni i adres URL API. Wydawca powinien przestać używać klucza instalacji po otrzymaniu tego zdarzenia.

Interfejs API dla każdej instalacji

Każda instalacja może wywoływać interfejs API o ograniczonym zakresie na https://api.kazzle.app. Wywołania są uwierzytelniane za pomocą klucza instalacji (z backendu wydawcy) lub tokenu tożsamości użytkownika (z hostowanego interfejsu użytkownika). Wszystkie operacje są automatycznie ograniczone do tej instalacji. Dostępne punkty końcowe: Pełne schematy żądań i odpowiedzi są opublikowane w specyfikacji OpenAPI Kazzle na stronie https://api.kazzle.app/openapi.json w tych ścieżkach.

Metoda	Ścieżka	Opis
GET	`/apps/secrets`	Wyświetl nazwy sekretów przechowywanych dla instalacji
GET	`/apps/secrets/:name`	Odczytaj wartość sekretu
PUT	`/apps/secrets/:name`	Przechowuj wartość sekretu
DELETE	`/apps/secrets/:name`	Usuń sekret
GET	`/apps/metadata`	Odczytaj metadane niezwiązane z sekretami dla instalacji
PUT	`/apps/metadata`	Scal aktualizacje w metadanych instalacji

Sekrety zapisane za pośrednictwem tego interfejsu API są szyfrowane w spoczynku i izolowane do konkretnej instalacji. Są oddzielone od sekretów przechowywanych w magazynie przestrzeni.

Następne kroki

Publikuj swoją aplikację — jak opublikować aplikację i co się dzieje potem.

Pierwsze kroki

Budowanie

Użytkownicy i dane

Publikowanie

Korzystanie z Kazzle

Bezpieczeństwo

Materiały referencyjne

Marketplace

Marketplace

Co robi publikacja

Instalacje

Tożsamość użytkownika

Webhooki

Interfejs API dla każdej instalacji

Następne kroki

​Marketplace

​Co robi publikacja

​Instalacje

​Tożsamość użytkownika

​Webhooki

​Interfejs API dla każdej instalacji

​Następne kroki

Marketplace

Co robi publikacja

Instalacje

Tożsamość użytkownika

Webhooki

Interfejs API dla każdej instalacji

Następne kroki