Resources
In InsightCloudSec, all services, utilities, or functions that make up your cloud are managed as Resources. Resources are fundamental to every feature within InsightCloudSec. After deploying our platform and connecting your cloud accounts, the Resources page is a single location from which to view resources across all of your cloud accounts. This visibility is the key building block for creating meaningful reporting, management, and automation.
Resource terminology
Resources are the normalized InsightCloudSec representation of components of cloud computing. Since our platform is multi-cloud, we developed a standardized (or "normalized") terminology for every resource that is displayed, so that it can be understood in a global context regardless of which provider it comes from.
For example, a "Storage Container" in InsightCloudSec is the normalized term used to refer to: AWS’ S3 Bucket, GCP’s Cloud Storage, Azure’s Blob Storage Container, or Alibaba’s Object Storage Bucket.
Many of these terms will be obvious, but for those terms that aren't clear, or for users that may not be as familiar with certain providers, we want to make that easy to understand.
- In the product, you can hover over a resource will display both the specific resource name and the associated Cloud Service Provider (CSP).
- Review our in-depth Resource Type Definitions for the normalized name of each Resource Type we support, the category, and a general definition.
- Review our Resource Matrix to see every Resource Type in a table format alongside its CSP-specific name.
Connect cloud account resources
Before getting started with Resources, you will need to have a functioning InsightCloudSec installation that includes at least one connected cloud account. If you haven't connected any cloud accounts, there won't be any resources to view. Take a look at our Cloud Account Setup page to review the steps for connecting your cloud account(s).
Explore resources
Starting with your Resources, InsightCloudSec capabilities allow you to refine your view by applying Query Filters to create Insights or Insight Packs, and then take action using Bots.
To view your resources:
- Log in to InsightCloudSec
- Go to Inventory > Resources.
The resource categories and filtering options display. Click a resource type to open a results table. Use the Resource Type Search to find a particular type without having to navigate the resource categories tabs or know the InsightCloudSec normalized terminology. For example, searching for and selecting S3 Bucket
can take you to the Storage Container resource.
Filter resources
You can modify the list of resources to display using Scopes, Query Filters, and the Global Search. At any point, you can filter the entire Resources view to only display resources owned by you, the current user, by clicking the person icon.
Apply scopes
There are four scope types available to help you filter your resource inventory.
To apply a scope:
- From the Resources page, click Scopes.
- Select a scope type:
- Clouds
- Optionally, use the Select Badges drop-down to filter the cloud accounts list using badges.
- Optionally, select Must Have all Badges to only show cloud accounts that have all selected badges. Otherwise, the list contains cloud accounts that have at least one of the selected badges.
- Select the checkbox next to each cloud account you want to show resources for. Scoping by a cloud account that contains a Kubernetes cluster will include the cluster and any of its related resources in the results.
- Kubernetes Clusters
- Select the checkbox next to each Kubernetes cluster you want to show resources for.
- Resource Groups
- Select the checkbox next to each Resource Group you want to show resources for.
- Applications
- Select the checkbox next to each Application you want to show resources for.
- Clouds
- Close the panel.
Apply Query Filters
Query Filters assist in answering specific questions about your resources. For example, finding resources older than a number of days, resources trusting a specific account, or resources with an Insight finding. Explore Query Filters for more details.
To apply a Query Filter:
- From the Resources page, click Query Filters.
- Use the search bar, Cloud Type Support, Resource Type Support, or categories to narrow the list of Query Filters.
- Optionally, click + to view details for a Query Filter.
- Click Apply. Often, Query Filters require additional configuration. You must provide the required configuration and click Apply again to finish applying the Query Filter.
Search for a resource
If you know a resource's name, account ID, or provider ID, you can also perform a direct search for it.
To search for a resource:
- From the Resources page, click Global Search (magnifiying glass icon).
- Type a resource name, account ID, or provider ID.
- Click the resource to open the resource properties panel.
Interact with resources
All resources matching your selected scopes and Query Filters are displayed as a table beneath the resource categories. The table displays different columns, or properties, depending on the resource type selected. For example, properties for a Database Snapshot may include Snapshot type, Size, and State. Properties describing a Storage Container may include Total Objects, Size, and Logging Bucket.
View resource properties
InsightCloudSec harvests a wealth of information for each resource. These properties are used to build Query Filters and Insights, which build the foundation for the rich set of features available to you.
To view resource properties:
- From the Resources page, optionally filter your inventory.
- Click a resource category tab.
- Click a resource type. A table displays.
- Click Resource Properties next to the resource you want to explore. A side panel opens.
The resource properties panel opens to the Properties tab by default. This tab contains all of the properties harvested by InsightCloudSec for a particular resource type.The rest of the tabs may differ between resource types.
Want to share a resource?
Most resources have a Direct Link property available on the resource properties panel that is a direct URL to viewing a particular resource within a given cloud service provider's console. You can also use direct links with Jinja2 to create notifications that link to the resource. Explore the Jinja 2 reference page for details on how.
The following are some important tabs you might see:
- Risk - Provides a summary of the risk associated with a resource. Explore the Layered Context documentation for details.
- Insight Findings - Lists all Insight Findings associated with a resource. Explore the Insights documentation for details.
- Source Documents - Provides a JSON document that surfaces raw data about the resource. Explore the Source Documents section for details.
- Related Resources - Lists all resources that are related to a given resource. Explore the Related Resources documentation for details.
Download resource data
All resource data is available for download. There are three different viewing experiences:
To download data for multiple resource types:
- From the Resources page, optionally filter your inventory.
- Click Download Resources.
- Select the resource types to download data for.
- Optionally, select badges to filter the resources downloaded.
- Optionally, select tags to filter the resources downloaded.
- Click Download Resources.
To download data for a single resource type:
- From the Resources page, optionally filter your inventory.
- Click a resource category tab.
- Click a resource type. A table displays.
- Click Download. A file downloads asynchronously.
To download data for a single resource:
- From the Resources page, optionally filter your inventory.
- Click a resource category tab.
- Click a resource type. A table displays.
- Click Resource Properties next to the resource you want to download. A side panel opens.
- Click Download JSON.
View Source Documents
For select resource types, there is an additional tab, Source Documents, that surfaces raw data about the resource harvested directly from the Cloud Service Provider (CSP). This additional context about your resources can help to further investigate configuration issues or provide deeper analysis.
Click into the document viewing area, then use ⌘F
(MacOS) or CTRL+F
(Windows) to search through the data. This data is also included with the resource download or can be viewed and copied directly from the Source Documents pane.
Supported Resources
Support for this feature is currently available for the following lists of resource types, but more types will be supported over time The Source Documents tab will inform you if the selected resource is not supported.
Source Documents - Supported AWS Resources
text
1Amazon DocumentDB2Amazon Macie3Amazon MemoryDB for Redis4Amazon MQ5Amazon OpenSearch Serverless6Amazon Redshift (Snapshot)7Amazon Sagemaker (Notebook)8Amazon Timestream9Amazon Transcription10API Gateway (Domain, Key, Stage)11Athena (Workgroup)12AWS App Runner13AWS AppSync14AWS Auto Scaling (Group, Launch Configurations)15AWS Backup (Vault)16AWS Glue (Data Catalog, Security Configuration)17AWS Outposts18AWS Transfer Family (SFTP Server)19Batch (Compute Environment)20CloudFront21CloudHSM22CloudTrail23CloudWatch (Alarm, EventBridge event bus, Log Group, Rule)24Codebuild Project25CodeCommit26Cognito (User Pool)27Container Image (ECR)28DataSync (Task)29Direct Connect30Directory Service31Dynamo DB (Accelerator (DAX))32DMS Replication Instance33EC2 Instance (Amazon EBS Snapshot, Amazon EBS Volume, Launch Template, SSH Key Pair)34EFS35Elastic Container Service/Fargate (Cluster, Container Task, Task Definition)36Elastic Container Registry (Container Image)37Elastic IP38Elastic Kubernetes Service (Cluster, Container Instance, Node Group)39Elastic MapReduce40Elastic Network Interface (ENI)41Elastic Transcoder (Pipeline)42FSx43IAM (IAM/ACM SSL Certificate)44IAM Policy (Customer-Managed)45Key Management Service46Kinesis (Data Firehose)47Kinesis Video Stream48Lambda49Managed Apache Airflow (Environment)50MSK (Instance)51NACL/Security Group52NACL/Security Group Rules53Neptune54RDS (Aurora, Aurora global database, Event Subscription, Snapshot)55Route 53 (DNS Zone, Resolver Configuration)56Recycle Bin57Region58S3 (Access Point)59S3 Glacier60Secrets Manager (Secret)61Serverless Application Repository62Shield63Simple Notification Service (Subscription)64Simple Queue Service65Step Function State Machine66Storage Gateway (NFS/SMB File Share)67Systems Manager (Parameter Store (Parameter), Document)68WorkSpaces (Instances)69VPC (Endpoint/PrivateLink, Elastic Network Interface (ENI), Flow Log, Internet Gateway, Peer, Managed Prefix List, NAT Gateway, Route, Route Table, Site-to-Site VPN, Subnet, Traffic Mirror Target, Transit Gateway, Virtual Private Gateway)70VPC Subnet
Source Documents - Supported Azure Resources
Text
1API Management Service2App Registration3Azure Cosmos DB4Azure Databricks (workspace)5Container instances6Data Factory7Event Grid Topic8ExpressRoute circuits9Federated Azure AD Group10Federated Azure AD User11Firewall12Image13IP Groups14Kubernetes Service15Logic App16Microsoft Entra ID (Group, Service Principal, User)17NAT Gateways18Network Security Group (Flow Logs)19Redis Cache20Role Definition21Security Rules22Service Endpoint/Service Endpoint Policy/Private Endpoint23Service Fabric Cluster24Snapshot25Storage Account26Subnet27Template Spec28Virtual Machine Scale Sets29Virtual Network (Gateway)30Web Application Firewall policies
Source Documents - Supported GCP Resources
text
1Airflow Environment2Artifact Registry3Autoscalers4BigQuery Dataset5Bigtable6Container Cluster7Cloud Armor8Cloud Credentials9Cloud Function10Cloud KMS Cryptokey11Cloud KMS Keyring12Cloud Run13Cloud Spanner14Cloud SQL15Cloud SQL Backup16Data Factory17Dataflow Jobs18Dataproc19Direct Connect20DNS Zone21Domain Groups22Domain Users23Identity Platform Provider24Image25Instance26Logs Storage27NAT Gateway28Network29Network Flow Log30Network Peer31Pub/Sub Subscription32Pub/Sub Topic33Secret34Service Account Key35Service Certificate36Service Certificate Authority37Service Domain38Service Policy39Shared File System40Snapshot41Stackdriver Sink42Subnet43URL Map44Virtual Private Gateway45VPC46VPN Tunnel
Manage resources
Depending on the permissions you have applied to the harvesting roles associated with your cloud accounts, you can perform some basic actions within InsightCloudSec, including:
- Adding a resource to a Resource Group
- Assigning an owner to a resource
- Deleting a resource in InsightCloudSec and in the cloud service provider
- Start, stop, or reboot a resource
Actions vary by resource type and can change dynamically based on the resource selected.
To manage a resource:
- From the Resources page, optionally filter your inventory.
- Click a resource category tab.
- Click a resource type. A table displays.
- Select the checkbox next to the resource you want to manage. Supported actions appear in the results table.