Giter Club home page Giter Club logo

steampipe-plugin-zoom's Introduction

image

Zoom Plugin for Steampipe

Use SQL to query infrastructure including servers, networks, facilities and more from Zoom.

Quick start

Install

Download and install the latest Zoom plugin:

steampipe plugin install zoom

Configure your credentials and config file.

Configure your account details in ~/.steampipe/config/zoom.spc:

You may specify the account ID, client ID, and client secret to authenticate:

connection "zoom" {
  plugin        = "zoom"
  account_id    = "Xt1aUD4WQ56w7hDhVbtDp"
  client_id     = "MZw2piRfTsOdpwx2Dh5U"
  client_secret = "04tKwHgFGvwB1M4HPHOBFP0aLHYqUE"
}

Or through environment variables:

export ZOOM_ACCOUNT_ID="Xt1aUD4WQ56w7hDhVbtDp"
export ZOOM_CLIENT_ID="MZw2piRfTsOdpwx2Dh5U"
export ZOOM_CLIENT_SECRET="04tKwHgFGvwB1M4HPHOBFP0aLHYqUE"

You may also use the deprecated JWT App mode of authentication.

Run steampipe:

steampipe query

List your Zoom users:

select
  email,
  personal_meeting_url
from
  zoom_user;
+--------------------------+--------------------------------------------------------------------------+
| email                    | personal_meeting_url                                                     |
+--------------------------+--------------------------------------------------------------------------+
| [email protected]    | https://turbot.zoom.us/j/9694476416                                      |
| [email protected] | https://turbot.zoom.us/j/1453171280?pwd=bWloMG5Ic0JrKFQ2SGJaUmNxZXhNQT09 |
+--------------------------+--------------------------------------------------------------------------+

Engines

This plugin is available for the following engines:

Engine Description
Steampipe The Steampipe CLI exposes APIs and services as a high-performance relational database, giving you the ability to write SQL-based queries to explore dynamic data. Mods extend Steampipe's capabilities with dashboards, reports, and controls built with simple HCL. The Steampipe CLI is a turnkey solution that includes its own Postgres database, plugin management, and mod support.
Postgres FDW Steampipe Postgres FDWs are native Postgres Foreign Data Wrappers that translate APIs to foreign tables. Unlike Steampipe CLI, which ships with its own Postgres server instance, the Steampipe Postgres FDWs can be installed in any supported Postgres database version.
SQLite Extension Steampipe SQLite Extensions provide SQLite virtual tables that translate your queries into API calls, transparently fetching information from your API or service as you request it.
Export Steampipe Plugin Exporters provide a flexible mechanism for exporting information from cloud services and APIs. Each exporter is a stand-alone binary that allows you to extract data using Steampipe plugins without a database.
Turbot Pipes Turbot Pipes is the only intelligence, automation & security platform built specifically for DevOps. Pipes provide hosted Steampipe database instances, shared dashboards, snapshots, and more.

Developing

Prerequisites:

Clone:

git clone https://github.com/turbot/steampipe-plugin-zoom.git
cd steampipe-plugin-zoom

Build, which automatically installs the new version to your ~/.steampipe/plugins directory:

make

Configure the plugin:

cp config/* ~/.steampipe/config
vi ~/.steampipe/config/zoom.spc

Try it!

steampipe query
> .inspect zoom

Further reading:

Open Source & Contributing

This repository is published under the Apache 2.0 (source code) and CC BY-NC-ND (docs) licenses. Please see our code of conduct. We look forward to collaborating with you!

Steampipe is a product produced from this open source software, exclusively by Turbot HQ, Inc. It is distributed under our commercial terms. Others are allowed to make their own distribution of the software, but cannot use any of the Turbot trademarks, cloud services, etc. You can learn more in our Open Source FAQ.

Get Involved

Join #steampipe on Slack โ†’

Want to help but don't know where to start? Pick up one of the help wanted issues:

steampipe-plugin-zoom's People

Contributors

bigdatasourav avatar dependabot[bot] avatar e-gineer avatar madhushreeray30 avatar misraved avatar subhajit97 avatar

Stargazers

 avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

steampipe-plugin-zoom's Issues

clarify how to get credentials

We say:

# Zoom API credentials are available to users with Developer role in
# the account

I've never had my own Zoom account, just signed up, wasn't 100% clear how to get the key.

  1. Go to https://marketplace.zoom.us/develop/create
  2. Click JWT and click Create
  3. Fill in basic info: name, email
  4. Go to App Credentials and you will find the API Key and Secret

Zoom API error 124: "Invalid access token."

Describe the bug
When i try to run zoom cis checks with this plugin, I get the following error:
"Zoom API error 124: "Invalid access token."

I have now tried setting up first an SDK app ('Meeting SDK') and then a JWT app.

Tried using the API keys from both but both end up giving the same error above.

I saw that Zoom API version 2 now uses JSON Web Tokens for authentication as mentioned below:
https://zoom.github.io/api/#authentication

Could this be the the reason and the plugin code needs to be updated to use JWT?

Steampipe version (steampipe -v)
steampipe version 0.18.0

Plugin version (steampipe plugin list)
hub.steampipe.io/plugins/turbot/zoom@latest | 0.5.0 | zoom

To reproduce
running: steampipe check benchmark.cis_v100

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.