Przejdź do treści
Perly
ZacznijZacznij za darmo

Poradniki

Przepis: klucze licencyjne

Sprzedawaj aplikację desktopową, CLI, wtyczkę lub szablon z kluczami licencyjnymi. Aplikacja sprawdza klucz bez żadnego sekretu w środku.

Otwórz jako Markdown

Perly Pay wydaje klucz, gdy płatność zostanie zrealizowana, liczy aktywacje na urządzeniach i odpowiada na pytanie „czy ten klucz jest ważny dla tego produktu tutaj?” przez publiczne endpointy. Program, który dystrybuujesz, używa LicenseClient — nie potrzebuje klucza tajnego.

Z asystentem: ten przepis realizuje w Twoim projekcie skill sell-license-keys wtyczki Perly Pay. Działający przykład to examples/license-keys (MIT) w repozytorium wtyczki.

Jak to działa

  1. 1

    Produkt wydający klucze

    issues_license: true i license_activation_limit (urządzeń na klucz), z ceną jednorazową, dożywotnią, okresową albo subskrypcją.

  2. 2

    Sprzedaż

    Link do płatności na stronie albo faktura dla każdego kupującego.

  3. 3

    Wyślij klucz

    Po webhooku license.created (jego obiekt to klucz) albo przez licenseKeys.list({ customer }) po invoice.fulfilled. Paragon nie zawiera klucza.

  4. 4

    Aktywacja w aplikacji

    activate({ key, product, instance_name }) z nazwą, która nie zmienia się na tym urządzeniu; zapisz identyfikator aktywacji.

  5. 5

    Sprawdzenie przy starcie

    validate({ key, product, instance }). Wyraźne valid: false blokuje; bez sieci przez kilka dni obowiązuje ostatnia dobra odpowiedź.

import { LicenseClient } from "perly-pay";

const licenses = new LicenseClient(); // no secret key, ever
const result = await licenses.activate({ key, product: "prod_…", instance_name: deviceName });
if (!result.valid) showWhy(result.reason); // limit_reached, revoked, expired, …

Uruchom przykład

  1. 1

    Zainstaluj

    npm install w examples/license-keys (Node 20.12+).

  2. 2

    Klucz

    Skopiuj .env.example do .env i wpisz klucz testowy (sk_test_…) w PERLY_PAY_SECRET_KEY.

  3. 3

    Przygotuj

    npm run setup tworzy produkt i cenę Twoim kluczem i drukuje ich identyfikatory do .env.

  4. 4

    Uruchom

    npm start (lub npm run dev), jak mówi jego README.

  5. 5

    Zapłać bez portfela

    npm run buy-test -- you@example.com kupuje kopię w trybie testowym i drukuje klucz; potem npm run app -- activate <key> i npm run app -- pro hello.

Pułapki

  • Klucz sk_… w aplikacji. Wyciągnie go każdy; program, który dystrybuujesz, używa tylko LicenseClient.
  • Bez product wywołanie jest odrzucane (parameter_missing). Podawaj go zawsze; klucz do czegokolwiek innego daje wrong_product.
  • instance_name, który zmienia się przy każdym uruchomieniu: każde uruchomienie zjada aktywację.