Elsa Workflows

⚠️ Note: The Elsa Module is currently in RC (Release Candidate) stage and will be officially released with ABP version 10.0 at the end of November 2025.

This module is used to integrate Elsa Workflows into ABP Framework applications and is designed to make it easy for developers to use Elsa's capabilities within their ABP-based projects.

• Defines all permissions that are used in the Elsa Workflows. With the ABP Permission Management Module, you can manage these permissions directly through your ABP application's permission management UI.
• Integrates with ABP's Identity Module to authenticate Elsa Studio Users. Users can log in to Elsa Studio using their existing ABP Identity credentials, providing a unified authentication experience across your application.
• Allows two authentication methods out of the box: Password Flow Authentication for direct username/password login, and Code Flow Authentication for OAuth 2.0 Authorization Code Flow with OpenIddict, enabling single sign-on (SSO) capabilities.

Features

Elsa Module Permissions

The Elsa module defines all permissions used in Elsa Workflows and integrates them with ABP's Permission Management system. You can manage permissions through your ABP application's permission management UI, grant or revoke permissions for roles and users, and control access to workflow operations. All Elsa Workflow API endpoints are protected with permission checks, and the module supports wildcard (*) permission to allow all Elsa permissions at once.

ABP Identity Authentication Integration

The Elsa module integrates with ABP's Identity Module to authenticate Elsa Studio users using their existing ABP Identity credentials.

It supports two authentication methods: Password Flow Authentication for direct username/password login, and Code Flow Authentication (OAuth 2.0 Authorization Code Flow) with OpenIddict for single sign-on (SSO) scenarios. Users can log in to Elsa Studio with their ABP credentials and get redirected to the ABP application's login page when using the OAuth flow.

Workflow Definition & Execution (through Elsa Studio)

Elsa Studio is an independent web application built with Blazor that allows you to design, manage, and execute workflows. You can design workflows visually with a drag-and-drop interface, create and manage workflow definitions and their versions, and monitor workflow execution instances in real-time.

For creating, managing, and customizing workflows themselves, please refer to the official Elsa documentation.

Sample Application

ABP provides a complete demo application that shows how to use the Elsa module in your ABP application. Please see the Elsa Workflows - Sample Workflow Demo for guidance and downloading the sample application.