Managing Properties

What Are Properties?

A property is a logical grouping within your organization that helps you organize and isolate resources. Think of properties as containers for related decoys, domains, and detections.

Common Use Cases for Properties

Use Case	Property Examples
Multiple websites	”Main Website”, “Blog”, “E-commerce Store”
Environments	”Production”, “Staging”, “Development”
Applications	”Web App”, “Mobile API”, “Admin Portal”
Clients (agencies)	“Client A Website”, “Client B API”
Business units	”Marketing Site”, “Customer Portal”, “Partner API”

Why Use Properties?

Properties provide several benefits:

1. Organization - Group related resources together
2. Filtering - View detections for a specific property only
3. Access Control - Assign different owners to different properties
4. Separation - Keep production and development detections separate

Property Hierarchy

Organization: "Acme Corp"
├── Property: "Production Website"
│   ├── Domain: www.acme.com
│   ├── Decoy: /admin-backup
│   ├── Bot Scanner: Main Scanner
│   └── Detections: 1,247
│
├── Property: "Staging Environment"
│   ├── Domain: staging.acme.com
│   ├── Decoy: /test-endpoint
│   └── Detections: 23
│
└── Property: "Mobile API"
    ├── Domain: api.acme.com
    ├── Decoy: /v1/admin
    └── Detections: 892

---

Creating Properties

From the Properties Page

1. Navigate to Settings → Properties in the sidebar
2. Click the New Property button
3. Enter a property name
   • Choose something descriptive
   • Example: “Production Website” or “Customer Portal”
4. Click Create

Property Limits

The number of properties you can create depends on your subscription:

Plan	Property Limit
Trial	1
Starter	3
Pro	10
Enterprise	Unlimited

If you’ve reached your limit, you’ll see a message indicating you need to upgrade your plan.

Property Naming Best Practices

Good Names	Why
”Production Website”	Clear and specific
”api.example.com”	Domain-based naming
”E-commerce Store”	Purpose-based naming
”Client: Acme Corp”	Client identification

Avoid	Why
”Property 1”	Not descriptive
”Test”	Too vague
”asdf”	Meaningless

---

Switching Between Properties

When you select a property, all data in the dashboard is filtered to show only that property’s resources and detections.

Using the Property Selector

1. Look at the top of the sidebar for the property dropdown
2. Click the dropdown to see all available properties
3. Select the property you want to view
4. The dashboard and all pages will update to show that property’s data

What Changes When You Switch Properties

Page	What’s Filtered
Dashboard	Detection charts show selected property only
Detections	Only detections from selected property
Decoys	Only decoys belonging to selected property
Bot Scanners	Only scanners for selected property
Domains	Only domains associated with selected property

Property Context Persistence

• Your selected property is remembered during your session
• When you log back in, you’ll return to your last selected property
• Each browser tab maintains its own property context

---

Property Settings

Viewing Property Details

1. Go to Settings → Properties
2. Find the property in the list
3. View:
   • Property name
   • Number of owners
   • Creation date

Editing a Property

1. Go to Settings → Properties
2. Click the Edit button (pencil icon) next to the property
3. Update the property name
4. Click Save

Property Owners

Each property can have multiple owners who have full control over that property:

• View and manage all resources in the property
• Create and delete decoys
• Configure bot scanners
• View all detections

Adding a Property Owner

1. Go to Settings → Properties
2. Click the property to view details
3. Click Add Owner
4. Select the user from your organization members
5. Click Add

Removing a Property Owner

1. Go to Settings → Properties
2. Click the property to view details
3. Find the owner in the list
4. Click Remove

Note: A property must have at least one owner. You cannot remove the last owner.

Deleting a Property

Warning: Deleting a property permanently removes all associated decoys, bot scanners, and detections. This action cannot be undone.

1. Go to Settings → Properties
2. Click the Delete button (trash icon) next to the property
3. Confirm the deletion in the dialog
4. The property and all its resources are permanently removed

What Happens When You Delete a Property

Resource	Result
Decoys	Permanently deleted
Bot Scanners	Permanently deleted
Detections	Permanently deleted
Domains	Moved to “unassigned” (can be reassigned)

---

Property Workflow Example

Here’s a typical workflow for an agency managing multiple clients:

Scenario: Web Agency with 3 Clients

1. Create the organization: “Web Agency Inc”

2. Create properties for each client:

   • “Client: Acme Corp”
   • “Client: Globex Inc”
   • “Client: Initech”

3. Set up domains per property:

   • Acme Corp → decoy.acme.com
   • Globex Inc → security.globex.io
   • Initech → monitor.initech.com

4. Create decoys per property:

   • Each client gets their own set of honeypot links
   • Detections are automatically isolated by property

5. View detections by client:

   • Switch to “Client: Acme Corp” property
   • See only Acme’s detections
   • Generate reports for that specific client

---

Best Practices

When to Create New Properties

Scenario	Recommendation
New production website	Create a new property
Temporary staging environment	Use existing dev/staging property
New client (agencies)	Create a new property
Feature branch testing	Use existing dev property
Completely separate application	Create a new property

Property Organization Tips

1. Be consistent with naming conventions across properties
2. Don’t over-segment - too many properties makes management complex
3. Use environment-based naming for the same application (Prod/Staging/Dev)
4. Document which property maps to which resources
5. Review regularly and clean up unused properties

---

Next Steps

Now that you understand properties, learn about your subscription options:

• Subscriptions and Billing - Plans, limits, and billing management