Skip to content

Quick Start

Welcome to Aegis Platform! Follow these steps to get started quickly.

1. Choose Your Deployment Option

Aegis can be deployed in three modes:

  • SaaS (Recommended): Fully managed by Pegasys AI. After you express interest, our support team will contact you to understand your requirements and set up your instance(s). You will receive your unique endpoint URL(s), typically in the format https://<unique-install-name>.aegis.pegasys.cloud.
  • Self-Hosted: Contact support@pegasys.ai for tailored deployment instructions and assistance.
  • Hybrid: Contact support@pegasys.ai to discuss your requirements and receive deployment guidance.

2. Access Your Aegis Instance

Once your instance is provisioned, you will receive the endpoint URL(s) from the Pegasys AI support team.

3. Next Steps

If you have any questions or need help, contact our support team at support@pegasys.ai.

Prerequisites

Before you begin, ensure you have:

  • An Aegis account with appropriate permissions
  • Access to your organization's infrastructure (AWS, Azure, GCP, or Kubernetes)
  • Basic understanding of your security requirements

Step 1: Access the Aegis UI

  1. Navigate to https://<unique-install-name>.aegis.pegasys.cloud
  2. Log in with your Single Sign On credentials
  3. Work with you organization's Aegis administrator to ensure you have the necessary permissions to create rules and policies

Step 2: Create Your First Ruleset

Rules are the building blocks of your security policies created in groups called Rulesets. Let's create a simple ruleset to get started.

  1. Navigate to Rules
  2. Click on "Rulesets>Manage Rulesets" in the left sidebar
  3. Provide a name for your ruleset, such as "K8s-Security-Baseline"
  4. Provide the "Policy-as-Prompt" in the description field, such as "Ensure Kubernetes deployments have a min of 2 replcas and have resource limits set"
  5. Provide labels to categorize your ruleset, such as "platform" = "kubernetes" and "benchmark" = "custom"

  6. Click "Create Ruleset"

  7. Test the Rule

  8. Click "Rulesets>Evaluate Rulesets"
  9. Select the ruleset you just created
  10. Choose a test Kubenetes Deployment yaml file or paste the YAML directly into the editor
  11. Click "Evaluate Ruleset"

Step 3: Create a Policy

Policies group Rulesets together for easier management.

  1. Navigate to Policies

  2. Click "Policies>Manage Policies" in the left sidebar

  3. Configure the Policy

  4. Name: "K8s AWS Production"
  5. Instrcution: "platform=kubernetes, provider=aws, environment=production"
  6. Category: "This creaets a policy for Kubernetes deployments on AWS in production by selecting the rulesets that match the policy instruction. This selection criterion is dynamic and applies to all rulesets in the future that match the policy instruction as well."

Step 4: Deploy Your Policy

  1. Review Configuration

  2. As long as the rulesets in the policy matching the policy labels selector are "enabled", there are no further configuration steps needed to deploy the policy.

  3. Test First (Recommended)

  4. Use the "Evaluate Policy" feature
  5. Select the policy you just created
  6. Provide a sample Kubernetes Deployment YAML file
  7. Click "Evaluate Policy"

Step 6: Monitor Events

  1. Navigate to Policy History
  2. Click on "Search" in the date range filter

  3. Click the record for the policy evaluation records.

  4. Review Activity

  5. The Dashboard will show you the results of the policy evaluation as well along with the trends

This quick start guide should have you running your first security policy within 30 minutes. As you become more familiar with Aegis, you can explore the advanced features and customization options available.