ariesw / web-push-encryption

Encryption Utilities for Web Push protocol

Push Encryption (node)

This library provides the functions necessary to encrypt a payload for sending with the Web Push protocol. It also includes a helper function for actually send the message to the Web Push endpoint.

What is this for?

The Push API allow users to subscribe for notifications from a web site, which can be delivered to them even if the browser has been closed. This was first shipped as part of Chrome 42, but the push message could not contain any payload data.

As of Chrome 50 and Firefox 44 (desktop-only) payloads are supported, but the server must encrypt the payload or the receiving browser will reject it.

This library implements the necessary encryption as a Node module.

Overview

Install the module using npm:

npm install web-push-encryption

Require the module:

var webpush = require('web-push-encryption');

Send a message:

webpush.sendWebPush('Yay! Web Push!', subscription);

Google Cloud Messaging (GCM), used as the push service by Chrome, requires authentication. You can use the setGCMAPIKey method to let the library know your API key and it will automatically send it with any GCM push requests.

webpush.setGCMAPIKey(MY_GCM_KEY);

Docs

You can find docs here.

Support

If you've found an error in this library, please file an issue: https://github.com/GoogleChrome/web-push-encryption/issues

Patches are encouraged, and may be submitted by forking this project and submitting a pull request through GitHub.

License

Copyright 2016 Google, Inc.

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.