Introducing... Direct Authentication

[jshcodes]

Direct Authentication

Starting in FalconPy v0.6.0, a new pattern for authenticating to classes has been introduced that abstracts the credential dictionary. Support for passing credential dictionaries has not changed, and will continue to be supported in all future versions.

At this point in time, if you are wanting to pass the member_cid parameter, you will still need to make use of credential authentication and pass a complete credential dictionary. This will be updated in future versions.

Examples

As an example, if you are tired of building a credential dictionary to authenticate:

from falconpy.hosts import Hosts

credentials = {
    "client_id": "CLIENT_ID_HERE",
    "client_secret": "CLIENT_SECRET_HERE"
    }
falcon = Hosts(creds=credentials)

result = falcon.QueryDevicesByFilter(sort="devices.hostname|asc")
print(result)

After upgrading to FalconPy v0.6.0, you can now authenticate to any Service Class using regular keywords:

from falconpy.hosts import Hosts
falcon = Hosts(client_id="CLIENT_ID_HERE", client_secret="CLIENT_SECRET_HERE")

result = falcon.QueryDevicesByFilter(sort="devices.hostname|asc")
print(result)

Including when you are wanting to use Object Authentication to access other API collections:

from falconpy.oauth2 import OAuth2
from falconpy.hosts import Hosts
from falconpy.detects import Detects
auth = OAuth2(client_id="CLIENT_ID_HERE", client_secret="CLIENT_SECRET_HERE")
hosts = Hosts(auth_object=auth)
detects = Detects(auth_object=auth)

host_result = falcon.QueryDevicesByFilter(sort="devices.hostname|asc")
print(host_result)

detect_result = falcon.QueryDetects(limit=10)
print(detect_result)

This also works for the Uber Class:

from falconpy.api_complete import APIHarness
falcon = APIHarness(client_id="CLIENT_ID_HERE", client_secret="CLIENT_SECRET_HERE")

result = falcon.command("QueryDevicesByFilter", parameters={"sort": "devices.hostname|asc"})
print(result)

If you have any questions or feedback about this new functionality, please reply here, or post a new topic. If you encounter a problem, where this functionality is not working as expected, please let us know by posting an issue.