Merge pull request #306 from carbonblack/develop

Release 1.7.6
Bug Fix: Removed the requirement for an admin token to connect
Bug Fix: Added sensor paginated query
Library update: Updated version of lxml library

Author: kebringer-cb

README.md

@@ -1,6 +1,6 @@
 # Python bindings for Carbon Black REST API
 
-**Latest Version: 1.7.5**
+**Latest Version: 1.7.6**
 
 _**Notice**:_ 
 * The Carbon Black Cloud portion of CBAPI has moved to https://github.com/carbonblack/carbon-black-cloud-sdk-python. Any future development and bug fixes for Carbon Black Cloud APIs will be made there. Carbon Black EDR and App Control will remain supported at CBAPI

docs/changelog.rst

@@ -2,6 +2,17 @@ CbAPI Changelog
 ===============
 .. top-of-changelog (DO NOT REMOVE THIS COMMENT)
 
+CbAPI 1.7.6 - Release Dec 20, 2021
+------------------------------------
+
+Bug Fixes
+ * Removed the requirement for an admin token to connect
+ * Added sensor paginated query
+
+General
+ * Updated version of lxml library
+
+
 CbAPI 1.7.5 - Released June 16, 2021
 ------------------------------------
 

docs/concepts.rst

@@ -62,9 +62,9 @@ Joining Model Objects
 ---------------------
 
 Many times, there are relationships between different Model Objects. To make navigating these relationships easy,
-cbapi provides special properties to "join" Model Objects together. For example, a :py:mod:`cbapi.response.models.Process`
-Model Object can reference the :py:mod:`cbapi.response.models.Sensor` or :py:mod:`cbapi.response.models.Binary`
-associated with this Process.
+cbapi provides special properties to "join" Model Objects together. For example, a
+:py:mod:`cbapi.response.models.Process` Model Object can reference the :py:mod:`cbapi.response.models.Sensor` or
+:py:mod:`cbapi.response.models.Binary` associated with this Process.
 
 In this case, special "join" properties are provided for you. When you use one of these properties, cbapi will
 automatically retrieve the associated Model Object, if necessary.
@@ -186,8 +186,8 @@ represent these data types can be "created" in cbapi by using the ``create()`` m
 
 If you attempt to create a Model Object that cannot be created, you will receive a :py:mod:`ApiError` exception.
 
-Once a Model Object is created, it's blank (it has no data). You will need to set the required properties and then call the
-``.save()`` method::
+Once a Model Object is created, it's blank (it has no data). You will need to set the required properties and then call
+the ``.save()`` method::
 
     >>> bh = cb.create(BannedHash)
     >>> bh.text = "Banned from API"

docs/conf.py

@@ -61,7 +61,7 @@
 # The short X.Y version.
 version = u'1.7'
 # The full version, including alpha/beta/rc tags.
-release = u'1.7.5'
+release = u'1.7.6'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/defense-api.rst

@@ -1,14 +1,14 @@
 .. _defense_api:
 
-CB Defense API
-==============
+Cloud Endpoint Standard API
+===========================
 
-This page documents the public interfaces exposed by cbapi when communicating with a CB Defense server.
+This page documents the public interfaces exposed by cbapi when communicating with a Cloud Endpoint Standard server.
 
 Main Interface
 --------------
 
-To use cbapi with Carbon Black Defense, you will be using the CBDefenseAPI.
+To use cbapi with VMware Carbon Black Cloud Endpoint Standard, you will be using the CBDefenseAPI.
 The CBDefenseAPI object then exposes two main methods to select data on the Carbon Black server:
 
 .. autoclass:: cbapi.psc.defense.rest_api.CbDefenseAPI

docs/getting-started.rst

@@ -4,7 +4,8 @@ Getting Started
 First, let's make sure that your API authentication tokens have been imported into cbapi. Once that's done, then read
 on for the key concepts that will explain how to interact with Carbon Black APIs via cbapi.
 
-Feel free to follow along with this document or watch the `Development Environment Setup video <https://developer.carbonblack.com/guide/enterprise-response/development-environment-video/>`_
+Feel free to follow along with this document or watch the
+`Development Environment Setup video <https://developer.carbonblack.com/guide/enterprise-response/development-environment-video/>`_
 on the Developer Network website.
 
 API Authentication
@@ -36,7 +37,8 @@ Alternatively, if you're using Windows (change ``c:\python27`` if Python is inst
 This configuration script will walk you through entering your API credentials and will save them to your current user's
 credential file location, which is located in the ``.carbonblack`` directory in your user's home directory.
 
-If using cbapi-psc, you will also be asked to provide an org key. An org key is required to access the Carbon Black Cloud, and can be found in the console under Settings -> API Keys.
+If using cbapi-psc, you will also be asked to provide an org key. An org key is required to access the Carbon Black
+Cloud, and can be found in the console under Settings -> API Keys.
 
 Your First Query
 ----------------

docs/index.rst

@@ -13,7 +13,7 @@ This library provides a Pythonic layer to access the raw power of the REST APIs
 
    >>> from cbapi.response import CbResponseAPI, Process, Binary, Sensor
    >>> #
-   >>> # Create our CbAPI object
+   >>> # Create our EDR API object
    >>> #
    >>> c = CbResponseAPI()
    >>> #
@@ -43,7 +43,7 @@ If you're a Carbon Black App Control customer (formerly CB Protection), you may
    >>> from cbapi.protection.models import FileInstance
    >>> from cbapi.protection import CbProtectionAPI
    >>> #
-   >>> # Create our CB Protection API object
+   >>> # Create our App Control API object
    >>> #
    >>> p = CbProtectionAPI()
    >>> #
@@ -65,7 +65,7 @@ As of version 1.2, CBAPI also supports Carbon Black Cloud Endpoint Standard (for
 
    >>> from cbapi.psc.defense import *
    >>> #
-   >>> # Create our CB Defense API object
+   >>> # Create our Cloud Endpoint Standard API object
    >>> #
    >>> p = CbDefenseAPI()
    >>> #
@@ -116,7 +116,7 @@ Major Features
 API Credentials
 ---------------
 
-CBAPI version 0.9.0 enforces the use of credential files. 
+CBAPI version 0.9.0 enforces the use of credential files.
 
 In order to perform any queries via the API, you will need to get the API token for your CB user. See the documentation
 on the Developer Network website on how to acquire the API token for
@@ -130,13 +130,15 @@ Once you acquire your API token, place it in one of the default credentials file
 * ``~/.carbonblack/``
 * ``/current_working_directory/.carbonblack/``
 
-For distinction between credentials of different Carbon Black products, use the following naming convention for your credentials files:
+For distinction between credentials of different Carbon Black products, use the following naming convention for your
+credentials files:
 
 * ``credentials.psc`` for Carbon Black Cloud Endpoint Standard, Audit & Remediation, and Enterprise EDR (CB Defense, CB LiveOps, and CB ThreatHunter)
 * ``credentials.response`` for Carbon Black EDR (CB Response)
 * ``credentials.protection`` for Carbon Black App Control (CB Protection)
 
-For example, if you use a Carbon Black Cloud product, you should have created a credentials file in one of these locations:
+For example, if you use a Carbon Black Cloud product, you should have created a credentials file in one of these
+locations:
 
 * ``/etc/carbonblack/credentials.psc``
 * ``~/.carbonblack/credentials.psc``
@@ -188,8 +190,8 @@ The latest CBAPI for Python supports specifying API credentials in the following
 The `CBAPI_URL` envar holds the FQDN of the target, an EDR (CbR), CBD, or CbD/Carbon Black Cloud server specified just as they are in the
 configuration file format specified above.
 
-The  optional `CBAPI_SSL_VERIFY` envar can be used to control SSL validation(True/False or 0/1), which will default to ON when
-not explicitly set by the user.
+The  optional `CBAPI_SSL_VERIFY` envar can be used to control SSL validation(True/False or 0/1), which will default to
+ON when not explicitly set by the user.
 
 For environments where complex outbound network filters and proxy configurations are used (eg. anything other than
 an unauthenticated or basic password authenticated proxy) a prepared `requests.Session` object may be supplied as a
@@ -239,7 +241,7 @@ API Documentation
 -----------------
 
 Once you have read the User Guide, you can view `examples on GitHub <https://github.com/carbonblack/cbapi-python/tree/master/examples>`_
-or try writing code of your own. You can use the full API documentation below to see all the methods available in CBAPI 
+or try writing code of your own. You can use the full API documentation below to see all the methods available in CBAPI
 and unlock the full functionality of the SDK.
 
 .. toctree::

docs/installation.rst

@@ -39,8 +39,7 @@ https://www.python.org/ftp/python/3.6.4/python-3.6.4-amd64.exe.
    :alt: Windows installation options showing "Add python.exe to path"
    :align: right
 
-Ensure that the "Add Python to PATH" option is
-checked.
+Ensure that the "Add Python to PATH" option is checked.
 
 If for some reason you do not have pip installed, follow the instructions at this
 `handy guide <http://docs.python-guide.org/en/latest/starting/installation/>`_.
@@ -75,4 +74,3 @@ Once you have a copy of the source, you can install it in "development" mode int
 This will link the version of cbapi-python you checked out into your Python site-packages directory. Any changes you
 make to the checked out version of cbapi will be reflected in your local Python installation. This is a good choice
 if you are thinking of changing or developing on cbapi itself.
-

docs/live-response.rst

@@ -1,7 +1,7 @@
 CbAPI and Live Response
 =======================
 
-Working with the CB Live Response REST API directly can be difficult. Thankfully, just like the rest of Carbon
+Working with the Live Response REST API directly can be difficult. Thankfully, just like the rest of Carbon
 Black's REST APIs, cbapi provides Pythonic APIs to make working with the Live Response API much easier.
 
 In addition to easy-to-use APIs to call into Live Response, cbapi also provides a "job-based" interface that allows
@@ -92,4 +92,3 @@ back from the endpoint, and submit the ``.run()`` method to the Live Response Jo
 
 Your script resumes execution immediately after the call to ``.submit_job()``. The job(s) that you've submitted will
 be executed in a set of background threads managed by cbapi.
-

docs/livequery-api.rst

@@ -1,10 +1,9 @@
 .. _livequery_api:
 
 CB LiveQuery API
-===================
+================
 
-This page documents the public interfaces exposed by cbapi when communicating with
-Carbon Black LiveQuery devices.
+This page documents the public interfaces exposed by cbapi when communicating with Carbon Black LiveQuery devices.
 
 Main Interface
 --------------
@@ -20,9 +19,8 @@ The LiveQuery API is used in two stages: run submission and result retrieval.
 Queries
 -------
 
-The LiveQuery API uses QueryBuilder instances to construct structured
-or unstructured (i.e., raw string) queries. You can either construct these
-instances manually, or allow ``CbLiveQueryAPI.select()`` to do it for you:
+The LiveQuery API uses QueryBuilder instances to construct structured or unstructured (i.e., raw string) queries.
+You can either construct these instances manually, or allow ``CbLiveQueryAPI.select()`` to do it for you:
 
 .. autoclass:: cbapi.psc.livequery.query.QueryBuilder
     :members: