Все инструменты / VAPID Keys Generator

VAPID Keys Generator

Создайте пару криптографических ключей VAPID для push-уведомлений в браузере. Public — в фронтенд, private — на сервер. Всё генерируется локально через Web Crypto API.

Генерация

Пуш-сервисы требуют mailto: или https:// — сюда придут письма при проблемах с рассылкой.

Готовый блок для .env



        
—

VAPID Public Key



        
—
Передаётся в браузер как applicationServerKey при pushManager.subscribe(). Не секрет.

VAPID Private Key



        
—
Секрет. Храните только в .env, config или Secret Manager.

Как сгенерировать пару на своём сервере

Ключи можно сгенерировать не только в браузере, но и прямо на сервере — из CI/CD, из терминала или из кода бэкенда. Ниже — готовые команды для популярных стеков. Результат совпадает с тем, что даёт этот инструмент: 65-байтный public в Base64url и 32-байтный private в Base64url.

Установка
npm install -g web-push
Генерация
npx web-push generate-vapid-keys --json
Пример вывода
{
  "publicKey": "BNbxGYNMhEIi9zrneh7mqV4oUay...",
  "privateKey": "4bsMhp1Y9wZQK0dBTaLhT6JLmT..."
}

Самый быстрый путь для Node.js. Пакет генерирует ключи через встроенный crypto и сразу печатает готовый JSON или набор строк для .env. Флаг --json удобно парсить в скриптах деплоя.

Установка
composer require minishlink/web-push
Генерация (artisan-команда)
php artisan tinker
>>> \Minishlink\WebPush\VAPID::createVapidKeys();
Или разово через tinker в .env
$keys = \Minishlink\WebPush\VAPID::createVapidKeys();
file_put_contents('.env', PHP_EOL
    . 'VAPID_PUBLIC_KEY=' . $keys['publicKey'] . PHP_EOL
    . 'VAPID_PRIVATE_KEY=' . $keys['privateKey'] . PHP_EOL, FILE_APPEND);

Библиотека отдаёт ключи в том же Base64url-формате, что и этот инструмент. Public сразу годится для applicationServerKey на фронте.

Установка
pip install py-vapid
Генерация
vapid --applicationServerKey
В коде
from py_vapid import Vapid

v = Vapid()
v.generate_keys()
print("PUBLIC:",  v.public_key_urlsafe_base64())
print("PRIVATE:", v.private_key_urlsafe_base64())

py-vapid — низкоуровневая библиотека, на ней же работает pywebpush. Методы *_urlsafe_base64() возвращают ровно те строки, которые ждут push-сервисы.

Генерация P-256 ключа
openssl ecparam -name prime256v1 -genkey -noout -out vapid_private.pem
Публичный ключ в raw-формате (65 байт)
openssl ec -in vapid_private.pem -pubout -outform DER \
  | tail -c 65 \
  | base64 \
  | tr '+/' '-_' \
  | tr -d '='
Приватный скаляр d (32 байта)
openssl ec -in vapid_private.pem -text -noout \
  | sed -n '/priv:/,/pub:/p' \
  | grep -v 'priv:\|pub:' \
  | tr -d ' :\n' \
  | xxd -r -p \
  | base64 \
  | tr '+/' '-_' \
  | tr -d '='

Работает на любом Linux/macOS из коробки. Первый вывод — ваш VAPID_PUBLIC_KEY, второй — VAPID_PRIVATE_KEY. Секретный PEM-файл после этого лучше удалить или убрать в Secret Manager.

Создаем файл GenerateVapidKeys

php artisan make:command GenerateVapidKeys

app/Console/Commands/GenerateVapidKeys.php
<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;
use Minishlink\WebPush\VAPID;

class GenerateVapidKeys extends Command
{
    protected $signature   = 'vapid:generate {--write : Дописать ключи в .env}';
    protected $description = 'Генерирует пару VAPID-ключей для Web Push';

    public function handle(): int
    {
        $keys = VAPID::createVapidKeys();

        $this->line('VAPID_PUBLIC_KEY='  . $keys['publicKey']);
        $this->line('VAPID_PRIVATE_KEY=' . $keys['privateKey']);

        if ($this->option('write')) {
            file_put_contents(
                base_path('.env'),
                PHP_EOL
                    . 'VAPID_PUBLIC_KEY='  . $keys['publicKey']  . PHP_EOL
                    . 'VAPID_PRIVATE_KEY=' . $keys['privateKey'] . PHP_EOL,
                FILE_APPEND
            );
            $this->info('Ключи дописаны в .env');
        }

        return self::SUCCESS;
    }
}
Запуск
php artisan vapid:generate
php artisan vapid:generate --write

Зачем нужны VAPID-ключи

VAPID Keys Generator создаёт пару ключей для подписи Web Push-уведомлений. Работает целиком в браузере: private-ключ не отправляется на сервер, не логируется и не покидает вашу вкладку.

Что умеет инструмент

Генерирует пару ECDSA P-256 через Web Crypto API. Public-ключ выводится как 65-байтная несжатая точка в Base64url — ровно в том виде, который принимает applicationServerKey в PushManager.subscribe(). Private-ключ — как 32-байтный скаляр d в Base64url. Есть готовый блок .env и отдельные кнопки копирования для каждого значения.

Как использовать

Скопируйте обе строки в .env вашего бэкенда: VAPID_PUBLIC_KEY и VAPID_PRIVATE_KEY. Добавьте VAPID_SUBJECT — mailto или https URL с контактом администратора. На фронте передайте publicKey в applicationServerKey при подписке: pushManager.subscribe({ userVisibleOnly: true, applicationServerKey }). На сервере подключите web-push / minishlink/web-push и передайте те же три значения в конфиг.

Почему безопасно

Ключи создаются через window.crypto.subtle.generateKey() — CSPRNG операционной системы, без Math.random и без сетевых запросов. Приватная часть существует только в вашей вкладке и в буфере обмена, пока вы сами её не сохраните. Мы принципиально не логируем и не отправляем сгенерированные значения никуда.

Что запомнить

VAPID_PRIVATE_KEY — это секрет. Он живёт только в .env, Secret Manager или переменных окружения CI/CD. В git его быть не должно: ни в коде, ни в истории, ни в docker-образе. При ротации старые подписки перестают работать, поэтому рассылку об обновлении public-ключа стоит делать заранее.

Советы по использованию

Public — на фронт, private — только на сервер

VAPID_PUBLIC_KEY передаётся браузеру в applicationServerKey при pushManager.subscribe(). VAPID_PRIVATE_KEY подписывает JWT на сервере и никогда не должен попасть в JS, HTML или репозиторий.

Формат ключей

Public — 65-байтная несжатая точка P-256 в Base64url (87 символов). Private — 32-байтный скаляр d в Base64url (43 символа). Именно в таком виде их ждут web-push, minishlink/web-push и pywebpush.

VAPID_SUBJECT обязателен

Пуш-сервисы (FCM, Mozilla, Apple) требуют контакт администратора: mailto:admin@example.com или https://example.com. С этим адресом к вам придут в случае проблем с рассылкой.

Частые вопросы

Как сгенерировать VAPID-ключи на своём сервере?

Node.js: npx web-push generate-vapid-keys --json. PHP: composer require minishlink/web-push и VAPID::createVapidKeys() в tinker. Python: pip install py-vapid и команда vapid --applicationServerKey. OpenSSL: см. блок «Как сгенерировать пару на своём сервере» ниже на этой странице.

Что такое VAPID-ключи?

VAPID (Voluntary Application Server Identification, RFC 8292) — пара ключей P-256 (ECDSA), которой push-сервер подтверждает, что уведомление отправлено именно вашим приложением. Public-ключ идёт в браузер, private остаётся на сервере и подписывает JWT с claim aud и sub.

Как сгенерировать VAPID-ключи в терминале?

Node.js: npx web-push generate-vapid-keys. PHP: openssl ecparam -name prime256v1 -genkey -noout | openssl ec -text. Этот инструмент делает то же самое через Web Crypto API браузера — без установки зависимостей.

Можно ли использовать одни ключи на нескольких серверах?

Да, если это один и тот же сервис (горизонтальное масштабирование). Ключи должны быть идентичны на всех инстансах, иначе браузеры будут получать push от «разных» приложений. Для разных доменов/сервисов — свои ключи.

Что делать, если private-ключ утёк?

Немедленно перегенерируйте пару, задеплойте new public на фронт и разошлите его всем подписчикам (PushManager.subscribe нужно вызвать заново — старые subscription, привязанные к старому ключу, перестанут работать). Уведомьте пользователей о переподписке.

Ключи всё время одни и те же — это нормально?

Да. VAPID-ключи генерируются один раз на приложение и живут долго. Ротация нужна только при компрометации private или переезде домена. Постоянство ключа = стабильность endpoint-ов у браузеров.

Работает ли это с Safari и Apple Push?

Да. Safari 16+ на macOS Ventura и iOS 16.4+ поддерживает Web Push через Apple Push Notification service. VAPID-ключи работают так же, но push-эндпоинт будет на домене push.apple.com, а не fcm.googleapis.com.