diff --git a/README.md b/README.md index 87d5e97..e235250 100644 --- a/README.md +++ b/README.md @@ -1 +1,83 @@ -# ASoC_Batch +# Managing ASoC (AppScan on Cloud) with Script for Batch operations +This script is written by Antony Chiu
+Modified by Kevin Chia.
+
+This Powershell script allows you to
+
+1.Check Current Token - Check your connection status with ASoC
+2.List Current Users - List all the users on your ASoC
+3.List Current Apps - List all Apps on your ASoC
+4.List Assist Group - List all Assist Group on your ASoC
+5.Invite Users - Invite the users from ASoC_UserInviteList.txt
+6.Clean Up Workshop - Batch Delete the scans on specefic assist group
+7.Get Counts - Get application and user counts
+ +# Script Setup + +In order to use the script, there are some things you need to do.
+1.Provide API Key
+You can get your API keys from ASoC Tools>API
+Edit
+``` +$ASoC_API_Key = 'EDIT ME' +$ASoC_API_Secret = 'EDIT ME' +``` + +
+2.Point to the right Datacenter
+The following example is EU Datacenter
+ +``` +$baseURL = 'https://cloud.appscan.com/eu/api/V2' +``` + +Base URL for US Datacenter
+ +``` +https://cloud.appscan.com/api/V2 +``` + + +# How to Invite users + +1.Put all the emails in ASoC_UserInviteList.txt
+Nextline for each emails
+Example:
+ +``` +JohnDoe@test.com +JamesBond@test.com +``` + + +2.Assign asset Groups (Line 415)
+Enter your asset Group ID (Can retrieve from List Assist Group)
+ +``` +Invite-Users -assetGroupId "6121ed15-202e-47ac-b3cc-14df0573c815" -roleId "fa39651a-b8b6-4094-ba29-b9ae94138d8f" -userFileName "ASoC_UserInviteList.txt" +``` + +3.Assign user Group (Line 415)
+Enter your RoleID (Can retrieve from ASoC)
+ +``` +Invite-Users -assetGroupId "6121ed15-202e-47ac-b3cc-14df0573c815" -roleId "fa39651a-b8b6-4094-ba29-b9ae94138d8f" -userFileName "ASoC_UserInviteList.txt" +``` +# How to delete scans and users - clean workshop + +This function will delete all the scans in the specefic asset group and users + + +1. Set Role Name (Line 433)
+ +``` +Delete-Users -roleName "Student" +``` + +2.Set Asset Name (Line 435)
+ +``` +Delete-Apps -assetGroupNameWhereAppsWillBeDeleted "AS_Innov_DAST_ASoC_NA_Oct13" +``` + +Reminder: Clean Workshop function will delete the scans under the specefic asset and users!!!