Encryption (@webex/plugin-encryption)

npm install --save @webex/plugin-encryption

In addition to the module consumption via NPMJS, this module can also be consumed via our CDN. See the below examples of how to consume this via CDN:

<html>
  <head>
    <!-- via unpkg -->
    <script crossorigin src="https://unpkg.com/webex@latest/umd/encryption.min.js"></script>

    <!-- via jsdelivr -->
    <script crossorigin src="https://cdn.jsdelivr.net/npm/webex/umd/encryption.min.js"></script>
  </head>
  <!-- ...application html... -->
</html>

Usage

This is a plugin for the Cisco Webex JS SDK. Please see our developer portal and the API reference for full details.

API Docs and Sample App

API Reference: https://webex.github.io/webex-js-sdk/plugin-encryption/
Hosted Sample App: https://webex.github.io/webex-js-sdk/samples/plugin-encryption/
See https://github.com/webex/webex-js-sdk/tree/next/docs/samples/plugin-encryption for a reference implementation

Sample Code

import Webex from '@webex/plugin-encryption';

const webex = Webex.init({
  credentials: {
    access_token
  }
});

webex.once('ready', () => {
  webex.cypher.register().then(async () => {
    try {
      const attachmentURL = 'https:/myfileurl.xyz/zzz/fileid?keyUri=somekeyuri&JWE=somejwe';
      const options = {
        useFileService: false,
        jwe: somejwe, // Provide the JWE here if not already present in the attachmentURL
        keyUri: someKeyUri, // Provide the keyURI here if not already present in the attachmentURL
      };
      const decryptedFileBuf = await webex.cypher.downloadAndDecryptFile(attachmentURL, options);
      // Do something with the decrypted file buffer
    } catch (error) {
      // Handle error
    }
  }).catch((err) => {
    // Handle error
  });
});

webex.cypher.deregister().then(() => {
// Do deregistration at your App's teardown
});