Mist Browser Extension

A web browser extension designed to simplify access to Juniper Mist APIs and API Tokens. This extension is supported on Firefox, Chrome, and Chromium-based browsers (e.g., Edge, Brave, Sidekick). It is a valuable tool for Juniper Mist developers and users to explore and utilize Mist APIs efficiently.

Important

This extension is in the process of being published on the Chrome Web Store, Microsoft Edge Add-ons Store, and Firefox Add-ons Store. Once available, the official store links will be provided below.

For users of these browsers, it is strongly recommended to install the extension directly from the respective store to ensure automatic updates and the latest features.

Store Links:

• Chrome, Ms Edge, Opera, Brave and all Chromium-Based web browsers: Chrome Web Store
• Firefox: Firefox Addon

Table of Contents

• Features
  • Supported Juniper Clouds
  • API Tab
  • Account Tab
  • About Tab
• Installation
  • Chrome / Chromium
  • Firefox
• Build Instructions
  • Prerequisites
  • Run/Debug
  • Build

---

MIT LICENSE

Copyright (c) 2021 Thomas Munzer

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

---

Features

Supported Juniper Clouds

Mist Clouds

• Global 01: manage.mist.com
• Global 02: manage.gc1.mist.com
• Global 03: manage.ac2.mist.com
• Global 04: manage.gc2.mist.com
• Global 05: manage.gc4.mist.com
• EMEA 01: manage.eu.mist.com
• EMEA 02: manage.gc3.mist.com
• EMEA 03: manage.ac6.mist.com
• APAC 01: manage.ac5.mist.com
• US GOV Cloud: manage.us.mist-federal.com

Juniper AI Clouds

• DC: dc.ai.juniper.net
• JSI: jsi.ai.juniper.net
• Routing: routing.ai.juniper.net

API Tab

When on the Mist Dashboard

• Quick access to Mist IDs (org_id, site_id, and object_id) from the current Mist dashboard page.
• Direct access to Mist API Pages (Django) from the current Mist dashboard page.

When on a Django Page

• Lists all available query parameters.
• Allows easy customization of query parameters.
• Direct access to the online API documentation for the current API call (GET/POST/PUT/DELETE).

Account Tab

• Lists all current valid Mist sessions in the web browser for various Mist clouds (e.g., manage.mist.com, manage.eu.mist.com, manage.gc1.mist.com).

- Manage User API Tokens (list, delete, create).

- Manage Organization API Tokens (list, delete, create).

Tools Tab

• Provides different tools to view API Token information and usage

About Tab

• Quick access to Mist API documentation (official Mist documentation, Postman documentation, OpenAPI documentation).
• Version check to determine if a new version of the extension is available, with the ability to download updates directly from the extension.

---

Installation

This extension is not yet available on the Chrome Web Store or the Firefox Add-ons Store. However, you can install it manually in Chrome/Chromium-based browsers and Firefox.

Chrome / Chromium

1. Download the file mist_extension-X.Y.Z.zip from the latest release.
2. Unzip the downloaded archive.
3. Open the browser's Extensions Page: chrome://extensions
4. Enable Developer Mode.

5. Click Load Unpacked and select the unzipped folder.

6. The extension is now ready to use!

Firefox

1. Download the file mist_extension-X.Y.Z.xpi from the latest release.
2. Open the about:addons page in Firefox.

3. Click the "Settings" button and select Install Add-on From File....

4. Select the mist_extension-X.Y.Z.xpi file.

---

Build Instructions

This extension was developed on macOS 12.6.1 using:

• Node.js >= 19.0.1
• npm >= 8.19.2
• Python >= 3.8.5

Prerequisites

From the angular folder, install dependencies:

npm install

Run/Debug

From the angular folder:

• Build the Angular app in debug mode:

npx web-ext run -s ./dist

• Start the extension in the browser:
• For Firefox:

npx web-ext run -t chromium -s ./dist --browser-console

• For Chromium-based browsers:

Build

From the angular folder:

• Build the Angular app in production mode:

npm run build:prod

• Package the extension:

npx web-ext build -s ./dist -o

The packaged extension will be located in web-ext-artifacts.