From 19aa82f7c1e8de356e29a1de1f613a01e75e8c29 Mon Sep 17 00:00:00 2001
From: SeaBlooms <colinblumer@gmail.com>
Date: Mon, 16 Dec 2024 14:12:18 -0700
Subject: [PATCH 1/5] 1.3.0 release

---
 README.md | 204 ++++++++++++++++++++++++++++++++++++++++++++++++++++--
 setup.py  |   2 +-
 2 files changed, 201 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 63a7ad0..9ecd5d1 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,7 @@ j1 = JupiterOneClient(
     url='https://graphql.us.jupiterone.io',
     sync_url='https://api.us.jupiterone.io'
 )
+
 ```
 
 ## Regional or Custom Tenant Support
@@ -58,6 +59,7 @@ query_result = j1.query_v1(QUERY)
 # Using cursor graphQL variable to return full set of paginated results
 QUERY = "FIND (Device | Person)"
 cursor_query_r = j1._cursor_query(QUERY)
+
 ```
 
 ##### Create an entity:
@@ -78,6 +80,7 @@ entity = j1.create_entity(
    timestamp=int(time.time()) * 1000 # Optional, defaults to current datetime
 )
 print(entity['entity'])
+
 ```
 
 
@@ -93,6 +96,7 @@ j1.update_entity(
     entity_id='<id-of-entity-to-update>',
     properties=properties
 )
+
 ```
 
 
@@ -112,30 +116,35 @@ j1.create_relationship(
     from_entity_id='<id-of-source-entity>',
     to_entity_id='<id-of-destination-entity>'
 )
+
 ```
 
 ##### Delete a relationship
 
 ```python
 j1.delete_relationship(relationship_id='<id-of-relationship-to-delete>')
+
 ```
 
 ##### Fetch Graph Entity Properties
 
 ```python
 j1.fetch_all_entity_properties()
+
 ```
 
 ##### Fetch Graph Entity Tags
 
 ```python
 j1.fetch_all_entity_tags()
+
 ```
 
 ##### Fetch Entity Raw Data
 
 ```python
 j1.fetch_entity_raw_data(entity_id='<id-of-entity>')
+
 ```
 
 ##### Create Integration Instance
@@ -144,12 +153,14 @@ j1.fetch_entity_raw_data(entity_id='<id-of-entity>')
 j1.create_integration_instance(
     instance_name="Integration Name", 
     instance_description="Description Text")
+
 ```
 
 ##### Start Synchronization Job
 
 ```python
 j1.start_sync_job(instance_id='<id-of-integration-instance>')
+
 ```
 
 ##### Upload Batch of Entities
@@ -181,6 +192,7 @@ entities_payload = [
 
 j1.upload_entities_batch_json(instance_job_id='<id-of-integration-sync-job>',
                               entities_list=entities_payload)
+
 ```
 
 ##### Upload Batch of Relationships
@@ -207,6 +219,7 @@ relationships_payload = [
 
 j1.upload_relationships_batch_json(instance_job_id='<id-of-integration-sync-job>',
                                    relationships_list=relationships_payload)
+
 ```
 
 ##### Upload Batch of Entities and Relationships
@@ -258,17 +271,20 @@ combined_payload = {
 
 j1.upload_combined_batch_json(instance_job_id='<id-of-integration-sync-job>',
                               combined_payload=combined_payload)
+
 ```
 
 ##### Finalize Synchronization Job
 
 ```python
 j1.finalize_sync_job(instance_job_id='<id-of-integration-sync-job>')
+
 ```
 
 ##### Fetch Integration Instance Jobs
 
 ```python
+
 j1.fetch_integration_jobs(instance_id='<id-of-integration-instance>')
 ```
 
@@ -277,6 +293,7 @@ j1.fetch_integration_jobs(instance_id='<id-of-integration-instance>')
 ```python
 j1.fetch_integration_job_events(instance_id='<id-of-integration-instance>',
                                 instance_job_id='<id-of-integration-instance-job>')
+
 ```
 
 ##### Create SmartClass
@@ -284,6 +301,7 @@ j1.fetch_integration_job_events(instance_id='<id-of-integration-instance>',
 ```python
 j1.create_smartclass(smartclass_name='SmartClassName',
                      smartclass_description='SmartClass Description Text')
+
 ```
 
 ##### Create SmartClass Query
@@ -292,36 +310,42 @@ j1.create_smartclass(smartclass_name='SmartClassName',
 j1.create_smartclass_query(smartclass_id='<id-of-smartclass>',
                            query='<J1QL-query-to-be-added>',
                            query_description='Query Description Text')
+
 ```
 
 ##### Run SmartClass Evaluation
 
 ```python
 j1.evaluate_smartclass(smartclass_id='<id-of-smartclass>')
+
 ```
 
 ##### Get SmartClass Details
 
 ```python
 j1.get_smartclass_details(smartclass_id='<id-of-smartclass>')
+
 ```
 
 ##### Generate J1QL from Natural Language Prompt
 
 ```python
 j1.generate_j1ql(natural_language_prompt='<natural-language-input-text>')
+
 ```
 
 ##### List Alert Rules
 
 ```python
 j1.list_alert_rules()
+
 ```
 
 ##### Get Alert Rule Details
 
 ```python
 j1.get_alert_rule_details(rule_id='<id-of-alert-rule>')
+
 ```
 
 ##### Create Alert Rule
@@ -336,6 +360,7 @@ j1.create_alert_rule(name="create_alert_rule-name",
                      polling_interval="DISABLED",
                      severity="INFO",
                      j1ql="find jupiterone_user")
+
 ```
 
 ##### Create Alert Rule with Action Config
@@ -354,6 +379,17 @@ webhook_action_config = {
             }
 }
 
+tag_entities_action_config = {
+            "type": "TAG_ENTITIES",
+            "entities": "{{queries.query0.data}}",
+            "tags": [
+              {
+                "name": "tagKey",
+                "value": "tagValue"
+              }
+            ]
+}
+
 j1.create_alert_rule(name="create_alert_rule-name",
                     description="create_alert_rule-description",
                     tags=['tag1', 'tag2'],
@@ -369,19 +405,85 @@ j1.create_alert_rule(name="create_alert_rule-name",
 ```python
 
 j1.delete_alert_rule(rule_id='<id-of-alert-rule')
+
 ```
 
 ##### Update Alert Rule
 
 ```python
 
-# polling_interval can be DISABLED, THIRTY_MINUTES, ONE_HOUR, FOUR_HOURS, EIGHT_HOURS, TWELVE_HOURS, ONE_DAY, and ONE_WEEK
+# polling_interval can be DISABLED, THIRTY_MINUTES, ONE_HOUR, FOUR_HOURS, EIGHT_HOURS, TWELVE_HOURS, ONE_DAY, or ONE_WEEK
 # tag_op can be OVERWRITE or APPEND
+# severity can be INFO, LOW, MEDIUM, HIGH, or CRITICAL
+# action_configs_op can be OVERWRITE or APPEND
 
-j1.update_alert_rule(rule_id='<id-of-alert-rule',
-                     j1ql="find jupiterone_user as i return i._key",
+alert_rule_config_alert = [
+    {
+        "type": "CREATE_ALERT"
+    }
+]
+
+alert_rule_config_tag = [
+    {
+        "type": "TAG_ENTITIES",
+        "entities": "{{queries.query0.data}}",
+        "tags": [
+            {
+                "name": "tagName",
+                "value": "tagValue"
+            }
+        ]
+    }
+]
+
+alert_rule_config_webhook = [
+    {
+        "type": "WEBHOOK",
+        "endpoint": "https://webhook.example",
+        "headers": {
+            "Authorization": "Bearer <TOKEN>"
+        },
+        "method": "POST",
+        "body": {
+            "queryData": "{{queries.query0.data}}"
+        }
+    }
+]
+
+alert_rule_config_multiple = [
+    {
+        "type": "WEBHOOK",
+        "endpoint": "https://webhook.example",
+        "headers": {
+            "Authorization": "Bearer <TOKEN>"
+        },
+        "method": "POST",
+        "body": {
+            "queryData": "{{queries.query0.data}}"
+        }
+    },
+    {
+        "type": "TAG_ENTITIES",
+        "entities": "{{queries.query0.data}}",
+        "tags": [
+            {
+                "name": "tagName",
+                "value": "tagValue"
+            }
+        ]
+    }
+]
+
+j1.update_alert_rule(rule_id="<id-of-alert-rule",
+                     name="Updated Alert Rule Name",
+                     description="Updated Alert Rule Description",
+                     j1ql="find jupiterone_user",
                      polling_interval="ONE_WEEK",
-                     tags=['new_tag1', 'new_tag2'])
+                     tags=['tag1', 'tag2', 'tag3'],
+                     tag_op="OVERWRITE",
+                     severity="INFO",
+                     action_configs=alert_rule_config_tag,
+                     action_configs_op="OVERWRITE")
 
 j1.update_alert_rule(rule_id='<id-of-alert-rule',
                      tags=['newTag1', 'newTag1'],
@@ -390,6 +492,7 @@ j1.update_alert_rule(rule_id='<id-of-alert-rule',
 j1.update_alert_rule(rule_id='<id-of-alert-rule',
                      tags=['additionalTag1', 'additionalTag2'],
                      tag_op="APPEND")
+
 ```
 
 ##### Evaluate Alert Rule
@@ -399,3 +502,96 @@ j1.update_alert_rule(rule_id='<id-of-alert-rule',
 j1.evaluate_alert_rule(rule_id='<id-of-alert-rule')
 
 ```
+
+##### Get Compliance Framework Item
+
+```python
+
+j1.get_compliance_framework_item_details(item_id="<id-of-item>")
+
+```
+
+##### List Alert Rule Evaluation Results
+
+```python
+
+j1.list_alert_rule_evaluation_results(rule_id="<id-of-rule>")
+
+```
+
+##### Fetch Evaluation Result Download URL
+
+```python
+
+j1.fetch_evaluation_result_download_url(raw_data_key="RULE_EVALUATION/<id-of-evaluation>/query0.json")
+
+```
+
+##### Fetch Evaluation Result Download URL
+
+```python
+
+j1.fetch_evaluation_result_download_url(raw_data_key="RULE_EVALUATION/<id-of-evaluation>/query0.json")
+
+```
+
+##### Fetch Downloaded Evluation Results
+
+```python
+
+j1.fetch_downloaded_evaluation_results(download_url="https://download.us.jupiterone.io/<GUID>%2FRULE_EVALUATION%2F<GUID>%2F<epoch>%2Fquery0.json?token=<TOKEN>&Expires=<epoch>")
+
+```
+
+##### Get Integration Defintion Details
+
+```python
+
+j1.get_integration_definition_details(integration_type="aws")
+
+```
+
+##### Fetch Integration Instances
+
+```python
+
+j1.fetch_integration_instances(definition_id="<id-of-definition>")
+
+
+```
+
+##### Fetch Integration Instance Details
+
+```python
+
+j1.get_integration_instance_details(instance_id="<id-of-integration-instance>")
+
+
+```
+
+##### Get Account Parameter Details
+
+```python
+
+j1.get_parameter_details(name="ParameterName")
+
+
+```
+
+##### List Account Parameters
+
+```python
+
+j1.list_account_parameters()
+
+
+```
+
+##### Create or Update Acount Parameter
+
+```python
+
+j1.create_update_parameter(name="ParameterName", value="stored_value", secret=False)
+
+
+```
\ No newline at end of file
diff --git a/setup.py b/setup.py
index 483c348..a73002b 100644
--- a/setup.py
+++ b/setup.py
@@ -5,7 +5,7 @@
 
 setup(
     name="jupiterone",
-    version="1.2.1",
+    version="1.3.0",
     description="A Python client for the JupiterOne API",
     license="MIT License",
     author="JupiterOne",

From 7e593e6b7237cad3b941fe6a4779843a222a6d5c Mon Sep 17 00:00:00 2001
From: SeaBlooms <colinblumer@gmail.com>
Date: Mon, 16 Dec 2024 14:28:26 -0700
Subject: [PATCH 2/5] Update README.md

---
 README.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 9ecd5d1..f94de1a 100644
--- a/README.md
+++ b/README.md
@@ -474,7 +474,7 @@ alert_rule_config_multiple = [
     }
 ]
 
-j1.update_alert_rule(rule_id="<id-of-alert-rule",
+j1.update_alert_rule(rule_id="<id-of-alert-rule>",
                      name="Updated Alert Rule Name",
                      description="Updated Alert Rule Description",
                      j1ql="find jupiterone_user",
@@ -539,7 +539,7 @@ j1.fetch_evaluation_result_download_url(raw_data_key="RULE_EVALUATION/<id-of-eva
 
 ```python
 
-j1.fetch_downloaded_evaluation_results(download_url="https://download.us.jupiterone.io/<GUID>%2FRULE_EVALUATION%2F<GUID>%2F<epoch>%2Fquery0.json?token=<TOKEN>&Expires=<epoch>")
+j1.fetch_downloaded_evaluation_results(download_url="https://download.us.jupiterone.io/<id-of-rule>/RULE_EVALUATION/<id-of-evaluation>/<epoch>/query0.json?token=<TOKEN>&Expires=<epoch>")
 
 ```
 
@@ -547,7 +547,9 @@ j1.fetch_downloaded_evaluation_results(download_url="https://download.us.jupiter
 
 ```python
 
-j1.get_integration_definition_details(integration_type="aws")
+# examples: 'aws', 'azure', 'google_cloud'
+
+j1.get_integration_definition_details(integration_type="<integration-type>")
 
 ```
 

From 3b659c038cfc41a8614f4996e91957c6a3f6abf6 Mon Sep 17 00:00:00 2001
From: SeaBlooms <colinblumer@gmail.com>
Date: Mon, 16 Dec 2024 14:30:01 -0700
Subject: [PATCH 3/5] typos

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index f94de1a..f3e25ad 100644
--- a/README.md
+++ b/README.md
@@ -535,7 +535,7 @@ j1.fetch_evaluation_result_download_url(raw_data_key="RULE_EVALUATION/<id-of-eva
 
 ```
 
-##### Fetch Downloaded Evluation Results
+##### Fetch Downloaded Evaluation Results
 
 ```python
 
@@ -543,7 +543,7 @@ j1.fetch_downloaded_evaluation_results(download_url="https://download.us.jupiter
 
 ```
 
-##### Get Integration Defintion Details
+##### Get Integration Definition Details
 
 ```python
 

From 556152cf3f93f7a79d66a597c3867c0c03319287 Mon Sep 17 00:00:00 2001
From: SeaBlooms <colinblumer@gmail.com>
Date: Mon, 16 Dec 2024 14:31:13 -0700
Subject: [PATCH 4/5] Update README.md

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index f3e25ad..bf9be7b 100644
--- a/README.md
+++ b/README.md
@@ -485,11 +485,11 @@ j1.update_alert_rule(rule_id="<id-of-alert-rule>",
                      action_configs=alert_rule_config_tag,
                      action_configs_op="OVERWRITE")
 
-j1.update_alert_rule(rule_id='<id-of-alert-rule',
+j1.update_alert_rule(rule_id='<id-of-alert-rule>',
                      tags=['newTag1', 'newTag1'],
                      tag_op="OVERWRITE")
 
-j1.update_alert_rule(rule_id='<id-of-alert-rule',
+j1.update_alert_rule(rule_id='<id-of-alert-rule>',
                      tags=['additionalTag1', 'additionalTag2'],
                      tag_op="APPEND")
 

From 330232eae94cd1e394c69343d1c7a03adf6a2808 Mon Sep 17 00:00:00 2001
From: SeaBlooms <colinblumer@gmail.com>
Date: Mon, 16 Dec 2024 14:32:50 -0700
Subject: [PATCH 5/5] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index bf9be7b..bff8ebe 100644
--- a/README.md
+++ b/README.md
@@ -499,7 +499,7 @@ j1.update_alert_rule(rule_id='<id-of-alert-rule>',
 
 ```python
 
-j1.evaluate_alert_rule(rule_id='<id-of-alert-rule')
+j1.evaluate_alert_rule(rule_id='<id-of-alert-rule>')
 
 ```