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

Merging next to main for release 1.1.0
splunk-soar-connectors · Aug 26, 2022 · 69f8002 · 69f8002
2 parents b9af3a0 + 7372f9b
commit 69f8002
Show file tree

Hide file tree

Showing 19 changed files with 1,265 additions and 29 deletions.
diff --git a/.github/workflows/review-release.yml b/.github/workflows/review-release.yml
@@ -0,0 +1,22 @@
+name: Review Release
+concurrency:
+  group: app-release
+  cancel-in-progress: true
+permissions:
+  contents: read
+  id-token: write
+  statuses: write
+on:
+  workflow_dispatch:
+    inputs:
+      task_token:
+        description: 'StepFunction task token'
+        required: true
+
+jobs:
+  review:
+    uses: 'phantomcyber/dev-cicd-tools/.github/workflows/review-release.yml@main'
+    with:
+      task_token: ${{ inputs.task_token }}
+    secrets:
+      resume_release_role_arn: ${{ secrets.RESUME_RELEASE_ROLE_ARN }}
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -1,11 +1,11 @@
 repos:
 -   repo: https://github.com/phantomcyber/dev-cicd-tools
-    rev: v1.11
+    rev: v1.13
     hooks:
     -   id: org-hook
     -   id: package-app-dependencies
 -   repo: https://github.com/Yelp/detect-secrets
-    rev: v1.2.0
+    rev: v1.3.0
     hooks:
     -   id: detect-secrets
         args: ['--no-verify', '--exclude-files', '^msgraphforsharepoint.json$']
diff --git a/README.md b/README.md
@@ -2,11 +2,11 @@
 # MS Graph for SharePoint
 
 Publisher: Splunk  
-Connector Version: 1\.0\.1  
+Connector Version: 1\.1\.0  
 Product Vendor: Microsoft  
 Product Name: SharePoint  
 Product Version Supported (regex): "\.\*"  
-Minimum Product Version: 5\.1\.0  
+Minimum Product Version: 5\.3\.0  
 
 This app connects to SharePoint using the MS Graph API to support investigate and generic actions
 
@@ -55,13 +55,14 @@ below to do this:
 
     -   Under the **Microsoft API** section, select **Microsoft Graph** .
 
-    -   Provide the following Application permissions to the app.
+    -   Provide the following Application and Delegated permissions to the app.
 
           
 
         -   Sites.Read.All
         -   Files.Read.All
         -   Files.ReadWrite.All
+        -   Sites.ReadWrite.All
 
     -   After making these changes, click **Add permissions** at the bottom of the screen.
 
@@ -147,6 +148,8 @@ VARIABLE | REQUIRED | TYPE | DESCRIPTION
 [list sites](#action-list-sites) - Fetch the details of the SharePoint sites  
 [list lists](#action-list-lists) - Fetch the available lists under a SharePoint site  
 [get list](#action-get-list) - Retrieves a list from a SharePoint Site  
+[add item](#action-add-item) - Add an item to a list on a SharePoint Site  
+[update item](#action-update-item) - Update an item in a list on a SharePoint Site  
 [get file](#action-get-file) - Retrieves a file from a SharePoint site  
 [remove file](#action-remove-file) - Removes a file from a SharePoint site  
 
@@ -256,6 +259,11 @@ action\_result\.parameter\.limit | numeric |
 action\_result\.parameter\.list | string |  `sharepoint list id`  `sharepoint list name` 
 action\_result\.data\.\*\.\@odata\.context | string |  `url` 
 action\_result\.data\.\*\.\@odata\.etag | string | 
+action\_result\.data\.\*\.columns\.\*\.calculated\.format | string | 
+action\_result\.data\.\*\.columns\.\*\.calculated\.formula | string | 
+action\_result\.data\.\*\.columns\.\*\.calculated\.outputType | string | 
+action\_result\.data\.\*\.columns\.\*\.choice\.allowTextEntry | boolean | 
+action\_result\.data\.\*\.columns\.\*\.choice\.displayAs | string | 
 action\_result\.data\.\*\.columns\.\*\.columnGroup | string | 
 action\_result\.data\.\*\.columns\.\*\.dateTime\.displayAs | string | 
 action\_result\.data\.\*\.columns\.\*\.dateTime\.format | string | 
@@ -280,6 +288,7 @@ action\_result\.data\.\*\.columns\.\*\.text\.allowMultipleLines | boolean |
 action\_result\.data\.\*\.columns\.\*\.text\.appendChangesToExistingText | boolean | 
 action\_result\.data\.\*\.columns\.\*\.text\.linesForEditing | numeric | 
 action\_result\.data\.\*\.columns\.\*\.text\.maxLength | numeric | 
+action\_result\.data\.\*\.columns\.\*\.text\.textType | string | 
 action\_result\.data\.\*\.columns\@odata\.context | string |  `url` 
 action\_result\.data\.\*\.createdBy\.user\.displayName | string | 
 action\_result\.data\.\*\.createdBy\.user\.email | string |  `email` 
@@ -298,17 +307,39 @@ action\_result\.data\.\*\.items\.\*\.createdBy\.user\.id | string |
 action\_result\.data\.\*\.items\.\*\.createdDateTime | string | 
 action\_result\.data\.\*\.items\.\*\.eTag | string | 
 action\_result\.data\.\*\.items\.\*\.fields\.\@odata\.etag | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.AppAuthorLookupId | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.AppEditorLookupId | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.ApplicationDate | string | 
 action\_result\.data\.\*\.items\.\*\.fields\.Attachments | boolean | 
 action\_result\.data\.\*\.items\.\*\.fields\.AuthorLookupId | string | 
 action\_result\.data\.\*\.items\.\*\.fields\.ContentType | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.Conversation | string | 
 action\_result\.data\.\*\.items\.\*\.fields\.Created | string | 
 action\_result\.data\.\*\.items\.\*\.fields\.Edit | string | 
 action\_result\.data\.\*\.items\.\*\.fields\.EditorLookupId | string | 
 action\_result\.data\.\*\.items\.\*\.fields\.FolderChildCount | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.InterviewDate | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.Interviewers\.\*\.Email | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.Interviewers\.\*\.LookupId | numeric | 
+action\_result\.data\.\*\.items\.\*\.fields\.Interviewers\.\*\.LookupValue | string | 
 action\_result\.data\.\*\.items\.\*\.fields\.ItemChildCount | string | 
 action\_result\.data\.\*\.items\.\*\.fields\.LinkTitle | string | 
 action\_result\.data\.\*\.items\.\*\.fields\.LinkTitleNoMenu | string | 
 action\_result\.data\.\*\.items\.\*\.fields\.Modified | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.Notes | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.PermissionLevelRequested | numeric | 
+action\_result\.data\.\*\.items\.\*\.fields\.PhoneScreenDate | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.PhoneScreenerLookupId | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.Position | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.Progress | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.PropagateAcl | boolean | 
+action\_result\.data\.\*\.items\.\*\.fields\.RecruiterLookupId | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.ReqByUserLookupId | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.ReqForUserLookupId | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.RequestDate | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.RequestedByDisplayNameDisp | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.RequestedForDisplayNameDisp | string | 
+action\_result\.data\.\*\.items\.\*\.fields\.StatusDisp | string | 
 action\_result\.data\.\*\.items\.\*\.fields\.Title | string | 
 action\_result\.data\.\*\.items\.\*\.fields\.\_ComplianceFlags | string | 
 action\_result\.data\.\*\.items\.\*\.fields\.\_ComplianceTag | string | 
@@ -318,10 +349,13 @@ action\_result\.data\.\*\.items\.\*\.fields\.\_UIVersionString | string |
 action\_result\.data\.\*\.items\.\*\.fields\.id | string | 
 action\_result\.data\.\*\.items\.\*\.fields\@odata\.context | string |  `url` 
 action\_result\.data\.\*\.items\.\*\.id | string | 
+action\_result\.data\.\*\.items\.\*\.lastModifiedBy\.application\.displayName | string | 
+action\_result\.data\.\*\.items\.\*\.lastModifiedBy\.application\.id | string | 
 action\_result\.data\.\*\.items\.\*\.lastModifiedBy\.user\.displayName | string | 
 action\_result\.data\.\*\.items\.\*\.lastModifiedBy\.user\.email | string |  `email` 
 action\_result\.data\.\*\.items\.\*\.lastModifiedBy\.user\.id | string | 
 action\_result\.data\.\*\.items\.\*\.lastModifiedDateTime | string | 
+action\_result\.data\.\*\.items\.\*\.parentReference\.id | string | 
 action\_result\.data\.\*\.items\.\*\.parentReference\.siteId | string | 
 action\_result\.data\.\*\.items\.\*\.webUrl | string |  `url` 
 action\_result\.data\.\*\.items\@odata\.context | string |  `url` 
@@ -340,6 +374,156 @@ action\_result\.message | string |
 summary\.total\_objects | numeric | 
 summary\.total\_objects\_successful | numeric |   
 
+## action: 'add item'
+Add an item to a list on a SharePoint Site
+
+Type: **generic**  
+Read only: **False**
+
+#### Action Parameters
+PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS
+--------- | -------- | ----------- | ---- | --------
+**list** |  required  | Title or ID of the list to add an item | string |  `sharepoint list id`  `sharepoint list name` 
+**item** |  required  | JSON string of item | string | 
+
+#### Action Output
+DATA PATH | TYPE | CONTAINS
+--------- | ---- | --------
+action\_result\.status | string | 
+action\_result\.parameter\.item | string | 
+action\_result\.parameter\.list | string |  `sharepoint list id`  `sharepoint list name` 
+action\_result\.data\.\*\.\@odata\.context | string |  `url` 
+action\_result\.data\.\*\.\@odata\.etag | string | 
+action\_result\.data\.\*\.contentType\.id | string | 
+action\_result\.data\.\*\.contentType\.name | string | 
+action\_result\.data\.\*\.createdBy\.user\.displayName | string | 
+action\_result\.data\.\*\.createdDateTime | string | 
+action\_result\.data\.\*\.eTag | string | 
+action\_result\.data\.\*\.fields\.\@odata\.etag | string | 
+action\_result\.data\.\*\.fields\.AppAuthorLookupId | string | 
+action\_result\.data\.\*\.fields\.AppEditorLookupId | string | 
+action\_result\.data\.\*\.fields\.AssetType | string | 
+action\_result\.data\.\*\.fields\.Attachments | numeric | 
+action\_result\.data\.\*\.fields\.AuthorLookupId | string | 
+action\_result\.data\.\*\.fields\.Color | string | 
+action\_result\.data\.\*\.fields\.Complete | boolean | 
+action\_result\.data\.\*\.fields\.ConditionNotes | string | 
+action\_result\.data\.\*\.fields\.ContentType | string | 
+action\_result\.data\.\*\.fields\.Created | string | 
+action\_result\.data\.\*\.fields\.CurrentOwnerLookupId | string | 
+action\_result\.data\.\*\.fields\.DueDate | string | 
+action\_result\.data\.\*\.fields\.Duration | string | 
+action\_result\.data\.\*\.fields\.Edit | string | 
+action\_result\.data\.\*\.fields\.EditorLookupId | string | 
+action\_result\.data\.\*\.fields\.FolderChildCount | string | 
+action\_result\.data\.\*\.fields\.ItemChildCount | string | 
+action\_result\.data\.\*\.fields\.LinkTitle | string | 
+action\_result\.data\.\*\.fields\.LinkTitleNoMenu | string | 
+action\_result\.data\.\*\.fields\.Manufacturer | string | 
+action\_result\.data\.\*\.fields\.Model | string | 
+action\_result\.data\.\*\.fields\.Modified | string | 
+action\_result\.data\.\*\.fields\.OrderNumber | string | 
+action\_result\.data\.\*\.fields\.PreviousOwnerLookupId | string | 
+action\_result\.data\.\*\.fields\.PurchaseDate | string | 
+action\_result\.data\.\*\.fields\.PurchasePrice | numeric | 
+action\_result\.data\.\*\.fields\.SerialNumber | string | 
+action\_result\.data\.\*\.fields\.Status | string | 
+action\_result\.data\.\*\.fields\.Title | string | 
+action\_result\.data\.\*\.fields\.\_ComplianceFlags | string | 
+action\_result\.data\.\*\.fields\.\_ComplianceTag | string | 
+action\_result\.data\.\*\.fields\.\_ComplianceTagUserId | string | 
+action\_result\.data\.\*\.fields\.\_ComplianceTagWrittenTime | string | 
+action\_result\.data\.\*\.fields\.\_UIVersionString | string | 
+action\_result\.data\.\*\.fields\.id | string | 
+action\_result\.data\.\*\.fields\@odata\.context | string |  `url` 
+action\_result\.data\.\*\.id | string |  `sharepoint item id` 
+action\_result\.data\.\*\.lastModifiedBy\.application\.displayName | string | 
+action\_result\.data\.\*\.lastModifiedBy\.application\.id | string | 
+action\_result\.data\.\*\.lastModifiedBy\.user\.displayName | string | 
+action\_result\.data\.\*\.lastModifiedDateTime | string | 
+action\_result\.data\.\*\.parentReference\.id | string | 
+action\_result\.data\.\*\.parentReference\.siteId | string | 
+action\_result\.data\.\*\.webUrl | string |  `url` 
+action\_result\.summary\.sites\_count | numeric | 
+action\_result\.message | string | 
+summary\.total\_objects | numeric | 
+summary\.total\_objects\_successful | numeric |   
+
+## action: 'update item'
+Update an item in a list on a SharePoint Site
+
+Type: **generic**  
+Read only: **False**
+
+#### Action Parameters
+PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS
+--------- | -------- | ----------- | ---- | --------
+**list** |  required  | Title or ID of the list to which the item belongs | string |  `sharepoint list id`  `sharepoint list name` 
+**item\_id** |  required  | ID of the item to update | numeric |  `sharepoint item id` 
+**item** |  required  | JSON string of item | string | 
+
+#### Action Output
+DATA PATH | TYPE | CONTAINS
+--------- | ---- | --------
+action\_result\.status | string | 
+action\_result\.parameter\.item | string | 
+action\_result\.parameter\.item\_id | numeric |  `sharepoint item id` 
+action\_result\.parameter\.list | string |  `sharepoint list id`  `sharepoint list name` 
+action\_result\.data\.\*\.\@odata\.context | string |  `url` 
+action\_result\.data\.\*\.\@odata\.etag | string | 
+action\_result\.data\.\*\.contentType\.id | string | 
+action\_result\.data\.\*\.contentType\.name | string | 
+action\_result\.data\.\*\.createdBy\.user\.displayName | string | 
+action\_result\.data\.\*\.createdDateTime | string | 
+action\_result\.data\.\*\.eTag | string | 
+action\_result\.data\.\*\.fields\.\@odata\.etag | string | 
+action\_result\.data\.\*\.fields\.AppAuthorLookupId | string | 
+action\_result\.data\.\*\.fields\.AppEditorLookupId | string | 
+action\_result\.data\.\*\.fields\.AssetType | string | 
+action\_result\.data\.\*\.fields\.Attachments | numeric | 
+action\_result\.data\.\*\.fields\.AuthorLookupId | string | 
+action\_result\.data\.\*\.fields\.Color | string | 
+action\_result\.data\.\*\.fields\.ConditionNotes | string | 
+action\_result\.data\.\*\.fields\.ContentType | string | 
+action\_result\.data\.\*\.fields\.Created | string | 
+action\_result\.data\.\*\.fields\.CurrentOwnerLookupId | string | 
+action\_result\.data\.\*\.fields\.DueDate | string | 
+action\_result\.data\.\*\.fields\.Edit | string | 
+action\_result\.data\.\*\.fields\.EditorLookupId | string | 
+action\_result\.data\.\*\.fields\.FolderChildCount | string | 
+action\_result\.data\.\*\.fields\.ItemChildCount | string | 
+action\_result\.data\.\*\.fields\.LinkTitle | string | 
+action\_result\.data\.\*\.fields\.LinkTitleNoMenu | string | 
+action\_result\.data\.\*\.fields\.Manufacturer | string | 
+action\_result\.data\.\*\.fields\.Model | string | 
+action\_result\.data\.\*\.fields\.Modified | string | 
+action\_result\.data\.\*\.fields\.OrderNumber | string | 
+action\_result\.data\.\*\.fields\.PreviousOwnerLookupId | string | 
+action\_result\.data\.\*\.fields\.PurchaseDate | string | 
+action\_result\.data\.\*\.fields\.PurchasePrice | numeric | 
+action\_result\.data\.\*\.fields\.SerialNumber | string | 
+action\_result\.data\.\*\.fields\.Status | string | 
+action\_result\.data\.\*\.fields\.Title | string | 
+action\_result\.data\.\*\.fields\.\_ComplianceFlags | string | 
+action\_result\.data\.\*\.fields\.\_ComplianceTag | string | 
+action\_result\.data\.\*\.fields\.\_ComplianceTagUserId | string | 
+action\_result\.data\.\*\.fields\.\_ComplianceTagWrittenTime | string | 
+action\_result\.data\.\*\.fields\.\_UIVersionString | string | 
+action\_result\.data\.\*\.fields\.id | string | 
+action\_result\.data\.\*\.fields\@odata\.context | string |  `url` 
+action\_result\.data\.\*\.id | string |  `sharepoint item id` 
+action\_result\.data\.\*\.lastModifiedBy\.application\.displayName | string | 
+action\_result\.data\.\*\.lastModifiedBy\.application\.id | string | 
+action\_result\.data\.\*\.lastModifiedBy\.user\.displayName | string | 
+action\_result\.data\.\*\.lastModifiedDateTime | string | 
+action\_result\.data\.\*\.parentReference\.id | string | 
+action\_result\.data\.\*\.parentReference\.siteId | string | 
+action\_result\.data\.\*\.webUrl | string |  `url` 
+action\_result\.summary\.sites\_count | numeric | 
+action\_result\.message | string | 
+summary\.total\_objects | numeric | 
+summary\.total\_objects\_successful | numeric |   
+
 ## action: 'get file'
 Retrieves a file from a SharePoint site