Introduction
Welcome to the Devici documentation.
The Getting Started section is a guided introduction to the Devici platform. It is designed to help you understand how Devici works and how to use it effectively—whether you are new to threat modeling or already familiar with secure design practices.
This section focuses on building the right mental model before diving into detailed workflows.
Who this guide is for
Getting Started is intended for:
- Security engineers and architects
- Software engineers and technical leads
- Product and platform teams responsible for system design
- Anyone participating in threat modeling or security reviews
You do not need prior experience with Devici or formal threat modeling training to follow this guide.
What Devici helps you do
Devici helps teams identify, understand, and manage security risks in software systems by making threat modeling:
- Structured — based on system behavior, attributes, and trust boundaries
- Collaborative — designed for teams, not individuals
- Actionable — focused on threats, mitigations, and decisions
- Scalable — suitable for individual features and large systems alike
Rather than relying on static checklists, Devici analyzes how your system behaves and applies relevant threats automatically.
How Getting Started is organized
Getting Started is designed to be read from start to finish. Each section builds on the previous one and introduces concepts before moving into hands-on use.
You’ll learn:
- How Devici represents systems and generates threats
- When threat modeling should be applied
- How to create your first threat model
- How threats and mitigations are evaluated
- How collaboration and iteration fit into the process
- How Devici integrates into modern development workflows
This section provides the foundation you need before moving into more detailed or task-specific documentation.
Using the rest of the documentation
This documentation site is organized into three main areas:
- Getting Started — a narrative, end-to-end introduction (this section)
- Guides — task-based documentation for specific workflows and decisions
- Release Notes — information about new features, improvements, and fixes
If you’re looking for instructions on a specific task or feature, the Guides section is the best place to go once you’ve completed Getting Started.
What’s next
Most teams start Devici in one of two ways:
-
Enterprise setup and onboarding
If you’re responsible for deploying Devici across a team or organization, start with
Set Up Authentication & Access to configure SSO, roles, and user permissions. -
Learning how Devici works
If you’re focused on building or reviewing threat models, continue to
How Devici Works to understand core concepts like systems, elements, attributes, and threats.
You can return to any section at any time—Devici is designed to support both centralized setup and individual modeling workflows.