Merge pull request #15 from splunk-soar-connectors/next

Merging next to main for release 3.0.1

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright (c) 2017-2023 Splunk Inc.
+   Copyright (c) 2017-2024 Splunk Inc.
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

NOTICE

@@ -1,5 +1,5 @@
 Splunk SOAR Git
-Copyright (c) 2017-2023 Splunk Inc.
+Copyright (c) 2017-2024 Splunk Inc.
 
 Third-party Software Attributions:
 

README.md

@@ -2,16 +2,16 @@
 # Git
 
 Publisher: Splunk  
-Connector Version: 3.0.0  
+Connector Version: 3.0.1  
 Product Vendor: Generic  
 Product Name: Git  
 Product Version Supported (regex): ".\*"  
-Minimum Product Version: 6.0.2  
+Minimum Product Version: 6.1.1  
 
 This app integrates with git and supports common git actions
 
 [comment]: # " File: README.md"
-[comment]: # "  Copyright (c) 2017-2023 Splunk Inc."
+[comment]: # "  Copyright (c) 2017-2024 Splunk Inc."
 [comment]: # ""
 [comment]: # "Licensed under the Apache License, Version 2.0 (the 'License');"
 [comment]: # "you may not use this file except in compliance with the License."

__init__.py

@@ -1,6 +1,6 @@
 # File: __init__.py
 #
-# Copyright (c) 2017-2023 Splunk Inc.
+# Copyright (c) 2017-2024 Splunk Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

git.json

@@ -12,15 +12,15 @@
         }
     ],
     "package_name": "phantom_git",
-    "license": "Copyright (c) 2017-2023 Splunk Inc.",
+    "license": "Copyright (c) 2017-2024 Splunk Inc.",
     "main_module": "git_connector.py",
     "type": "devops",
-    "app_version": "3.0.0",
-    "utctime_updated": "2022-02-03T01:19:09.000000Z",
+    "app_version": "3.0.1",
+    "utctime_updated": "2024-03-25T18:36:59.000000Z",
     "product_vendor": "Generic",
     "product_name": "Git",
     "product_version_regex": ".*",
-    "min_phantom_version": "6.0.2",
+    "min_phantom_version": "6.1.1",
     "fips_compliant": true,
     "python_version": "3",
     "logo": "logo_git.svg",
@@ -1240,20 +1240,20 @@
         "wheel": [
             {
                 "module": "GitPython",
-                "input_file": "wheels/py3/GitPython-3.1.30-py3-none-any.whl"
+                "input_file": "wheels/py3/GitPython-3.1.42-py3-none-any.whl"
             },
             {
                 "module": "gitdb",
-                "input_file": "wheels/py3/gitdb-4.0.10-py3-none-any.whl"
+                "input_file": "wheels/py3/gitdb-4.0.11-py3-none-any.whl"
             },
             {
                 "module": "pycryptodomex",
-                "input_file": "wheels/py39/pycryptodomex-3.9.8-cp39-cp39-manylinux1_x86_64.manylinux_2_5_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl"
+                "input_file": "wheels/py3/pycryptodomex-3.20.0-cp35-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl"
             },
             {
                 "module": "smmap",
-                "input_file": "wheels/py3/smmap-5.0.0-py3-none-any.whl"
+                "input_file": "wheels/py3/smmap-5.0.1-py3-none-any.whl"
             }
         ]
     }
-}
+}

git_connector.py

@@ -1,6 +1,6 @@
 # File: git_connector.py
 #
-# Copyright (c) 2017-2023 Splunk Inc.
+# Copyright (c) 2017-2024 Splunk Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

git_consts.py

@@ -1,6 +1,6 @@
 # File: git_consts.py
 #
-# Copyright (c) 2017-2023 Splunk Inc.
+# Copyright (c) 2017-2024 Splunk Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

git_git_status.html

@@ -10,7 +10,7 @@
 {% block widget_content %} <!-- Main Start Block -->
 
 <!-- File: git_git_status.html
-  Copyright (c) 2017-2023 Splunk Inc.
+  Copyright (c) 2017-2024 Splunk Inc.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

git_list_repos.html

@@ -10,7 +10,7 @@
 {% block widget_content %} <!-- Main Start Block -->
 
 <!-- File: git_list_repos.html
-  Copyright (c) 2017-2023 Splunk Inc.
+  Copyright (c) 2017-2024 Splunk Inc.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

git_view.py

@@ -1,6 +1,6 @@
 # File: git_view.py
 #
-# Copyright (c) 2017-2023 Splunk Inc.
+# Copyright (c) 2017-2024 Splunk Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

manual_readme_content.md

@@ -0,0 +1,57 @@
+[comment]: # " File: README.md"
+[comment]: # "  Copyright (c) 2017-2024 Splunk Inc."
+[comment]: # ""
+[comment]: # "Licensed under the Apache License, Version 2.0 (the 'License');"
+[comment]: # "you may not use this file except in compliance with the License."
+[comment]: # "You may obtain a copy of the License at"
+[comment]: # ""
+[comment]: # "    http://www.apache.org/licenses/LICENSE-2.0"
+[comment]: # ""
+[comment]: # "Unless required by applicable law or agreed to in writing, software distributed under"
+[comment]: # "the License is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,"
+[comment]: # "either express or implied. See the License for the specific language governing permissions"
+[comment]: # "and limitations under the License."
+[comment]: # ""
+This app supports connecting with both HTTP(S) and SSH. When connecting with HTTP(S) both the
+username and password are required in case of private repository. For public repository, username
+and password are not required, however, these won't be verified unless they are explicitly needed to
+perform the action. If you were to connect to a public repo, for example, the username and password
+would only be needed on a **git push** action. When connecting with SSH, the username should be part
+of the URI ( **git** @gitrepo).  
+The **repo_name** parameter will be the name given to the cloned repository.
+
+
+
+As of this writing, the repository will be saved in the location
+`     ${PHANTOM_HOME_DIR}/local_data/app_states/ff116964-86f7-4e29-8763-4462ce0d39a7/<repo_name>    `
+
+## Connecting via SSH
+
+This app supports connecting to git through SSH instead of HTTP. In order to make this easy to do,
+there is a **configure ssh** action. Running this action will create an RSA key pair, and return the
+public key. After that, you will need to manually add the public key to the git repo.
+
+Though not recommended, it is also possible to add an existing private key for this app to read, as
+well. Add the private key file to
+
+    ${PHANTOM_HOME_DIR}/local_data/app_states/ff116964-86f7-4e29-8763-4462ce0d39a7/.ssh-<asset_id>/id_rsa
+
+Then set it so that
+
+    phantom-worker
+
+is the owner, and set the file permissions to
+
+    600
+
+If you do connect with SSH, both the username and password parameters will be ignored.
+
+## Playbook Backward Compatibility
+
+-   The behavior of the clone repo and delete repo actions have been modified due to the change in
+    the naming convention of repo.
+
+      
+
+    -   In previous version, repo was saved as **reponame** In the new version, repo will be saved
+        as **\_**

release_notes/3.0.1.md

@@ -0,0 +1,2 @@
+* Upgrade GitPython dependency to 3.1.41
+* Upgrade pycryptodomex dependency to 3.19.1

requirements.txt

@@ -1,2 +1,2 @@
-GitPython==3.1.30
-pycryptodomex==3.9.8
+GitPython==3.1.42
+pycryptodomex==3.20.0