@privacyportal.org/privacy-kit

privacy-kit

A lightweight browser library for integrating awesome privacy features to your website, proudly offered as Free and Open Source Software (FOSS) by our team at Privacy Portal.

Features in this library could require users to sign-in or register free accounts on Privacy Portal. This account registration is required for the operation of the user requested features.

Please check our Privacy Policy and Terms Of Service for more information.

Live Demo

🚀 Experience privacy-kit live: privacyportal.github.io/privacy-kit-demo

Installation

npm/yarn/pnpm: (best for privacy)

npm install @privacyportal.org/privacy-kit

import PrivacyKit from '@privacyportal.org/privacy-kit'

PrivacyKit.run({
  // Learn how you can get a client_id in the configuration section below
  client_id: process.env.CLIENT_ID
})

Manual: (best for privacy)

<!-- Manually download the privacy-kit.umd.js file from our latest GitHub Release -->
<script src="/assets/privacy-kit.umd.js"></script>
<script>
  window.PrivacyKit.run({
    client_id: "<YOUR_OAUTH_CLIENT_ID>"
  });
</script>

CDN (Script Tag):

<!-- Specific version with SRI -->
<script 
  src="https://cdn.jsdelivr.net/npm/@privacyportal.org/privacy-kit@0.1.6/dist/privacy-kit.umd.js"
  integrity="sha384-Cgp+UAQtl4xg4oLDL4kOKEhfn4PSUjdzw4Z29qFM+S1l4lm0im8l3hK0sq1wRRq4"
  crossorigin="anonymous"
></script>

<!-- Latest minor version -->
<script
  src="https://cdn.jsdelivr.net/npm/@privacyportal.org/privacy-kit@0/dist/privacy-kit.umd.js"
  crossorigin="anonymous"
></script>

Manual + base64 encoded:

For websites created using Content Management Systems like WordPress (WP), if previous options are unavailable or restricted, you can embed privacy-kit directly into your website using Base64 encoding. In WP, this can be done by adding a 'Custom HTML' block and including a <script> tag with the Base64-encoded library code.

<!-- replace {{BASE64_ENCODED_LIB}} with the base64 encoded content of privacy-kit.umd.js -->
<script src="data:application/javascript;base64,{{BASE64_ENCODED_LIB}}"></script>

Configuration

PrivacyKit.run({
  client_id: "<YOUR_OAUTH_CLIENT_ID>",
  hide_my_email: true,
  subscribe_anonymoulsy: true,          // accepted values: [undefined, true, false, { set_name_field: true }]
  on_error: "alert"                     // accepted values: ["ignore", "alert", loggerObject]
});

How to get a client_id?

Privacy-Kit authorizes users using Privacy Portal's Open Authentication service. When a user requests a new alias, a Privacy Portal popup appears allowing users to securely authenticate with Privacy Portal and authorize your application to receive an email alias for the user.

In order to get a client_id, you must register your website as an OAuth Application on Privacy Portal. Learn More

Features

Hide-My-Email

Integrate Hide My Email functionality to your website without requiring any browser extension or app installation. Simply install the library on your website using one of the installation steps above and make sure hide_my_email is configured to true (it is enabled by default).

When enabled, if a user clicks on an email input field, they are prompted to use "Hide My Email" to generate a Privacy Email Alias instead of their personal email. This email alias protects the user's privacy and only accepts emails from your registered domains thus preventing email address theft by third parties and completely eliminating unsollicited mail.

In order to use Hide My Email, you will need to register your application as an OAuth application on Privacy Portal. Our free plan is very generous and should cover most websites.

Subscribe Anonymously to Newsletter

Allow users to subscribe anonymously to your existing newsletter using email aliases instead of their personal email addresses. Simply install the library on your website using one of the installation steps above and make sure subscribe_anonymoulsy is configured to true (it is enabled by default).

This features can very easily be integrated to your newsletter simply by adding an HTML button inside your form.

<form>
  <input type="email" name="form_fields[email]" id="form-field-email" placeholder="Email" required="required">
  <button type="submit">Subscribe</button>
  <!-- Add the following button to your newsletter form -->
  <button type="button" data-pp-action="subscribe-anonymously">
    <span>Subscribe Anonymously</span>
    <span>with Privacy Portal</span>
  </button>
</form>

/* you can style the subscribe anonymously button with some css like the following */
button[data-pp-action="subscribe-anonymously"] {
  display: flex;
  flex-direction: column;
  justify-content: center;
  background-color: black;
  color: white;
  height: auto;
  padding: 0.5rem;
  gap: 0.1rem;
}

button[data-pp-action="subscribe-anonymously"] > span:last-child {
  font-size: xx-small;
}

In order to use Subscribe Anonymously, you will need to register your application as an OAuth application on Privacy Portal. Our free plan is very generous and should cover most websites.