Study guide

11.2 Web Mashup, Digital Channels & Constellation Embed

Pegasystems Certified Pega System Architect CSA

Track your progress as you read

Finished sections get a check mark.

1 Chapter 1: Exam Overview & Architecture Foundations

1.1 Certified Pega System Architect Exam Format, Blueprint & Strategy 1.2 Pega Architecture & Enterprise Class Structure (ECS) 1.3 Studio Environments: App Studio, Dev Studio, Admin Studio & Prediction Studio

2 Chapter 2: Case Lifecycle Design & Core Workflows

2.1 Case Types, Stages, Processes, and Steps 2.2 Routing Strategies: Worklists, Work Queues, and Teams 2.3 Service Level Agreements (SLAs) & Urgency Calculations

3 Chapter 3: Advanced Case Management Patterns

3.1 Multi-Step Processes, Parallel Processing & Sub-processes 3.2 Child Cases, Data Propagation & Wait Steps 3.3 Optional Actions, Approvals & Case Resolution 3.4 Duplicate Case Detection, Automation Shapes & Automated Correspondence

4 Chapter 4: Data Modeling & Data Page Architecture

4.1 Data Objects, Property Modes & Page Types 4.2 Data Pages: Scope, Types & Refresh Policies 4.3 Data Transforms & Object Mapping

5 Chapter 5: Business Logic, Calculations & Decisioning

5.1 Declare Expressions & Declarative Network Chaining 5.2 Decision Tables & Decision Trees 5.3 Integration Connectors, Systems of Record & Error Handling

6 Chapter 6: User Interface & User Experience Design

6.1 Traditional UI vs Constellation Architecture 6.2 Views, Dynamic Layouts, Design Templates & Action Sets 6.3 Form Validation, Edit Validate & WCAG Accessibility 6.4 Form Views: Default vs Hierarchical Forms, Field Groups & Primary Fields

7 Chapter 7: Rule Architecture & Rule Resolution

7.1 Rulesets, Versioning & Ruleset Stack Hierarchy 7.2 The Rule Resolution Algorithm 7.3 Circumstancing & Rule Specialization

8 Chapter 8: Security & Access Control

8.1 Authentication, Operator Records & Access Groups 8.2 Role-Based Access Control: Access Roles, ARO & Privileges 8.3 Attribute-Based Access Control (ABAC), Encryption & Audit Trails 8.4 The Security Checklist & Secure Deployment

9 Chapter 9: DevOps, Testing & Application Quality

9.1 Guardrail Compliance, Best Practices & Performance Profiling 9.2 Automated Testing: Pega Unit Test Cases & Scenario Testing 9.3 Packaging, Branching & Deployment Manager CI/CD

10 Chapter 10: Reporting & Operational Analytics

10.1 Report Definitions: Querying, Columns, Summaries & Joins 10.2 Filtering, Parameters & Column Exposure Optimization 10.3 Insights, Visual Dashboards & Business Metrics

11 Chapter 11: Mobility, Digital Channels & Portals

11.1 Mobile Channel Configuration & Offline Processing 11.2 Web Mashup, Digital Channels & Constellation Embed 11.3 Channels, Personas, Portals & Landing Pages

12 Chapter 12: Center-out Architecture, Enterprise Reuse & Agile Delivery

12.1 Center-out Business Architecture & the Case for Pega 12.2 The Situational Layer Cake, Modules & Enterprise Reuse 12.3 Agile Workbench, Workspaces, Branches, Delivery Roles & the Estimator

13 Chapter 13: Pega GenAI for System Architects

13.1 Pega Blueprint: Creating, Importing & Modifying an Application Design 13.2 Pega GenAI Autopilot & Pega GenAI Coach 13.3 Pega GenAI Connect Rules, Knowledge Buddy, Agents & Tool Rules

11.2 Web Mashup, Digital Channels & Constellation Embed

Key Takeaways Explain This Topic AI

Pega's multichannel architecture allows enterprises to build case lifecycles, business logic, and validation once in the core platform and deploy them across mobile, web portals, email bots, and conversational assistants.

Traditional Pega Web Mashup embeds Pega cases into existing enterprise web pages using HTML <div> containers and iaction directives (createNewWork, openAssignment, openWorkItem) communicating via the Pega Composite Gateway.

Mashup security requires strict domain whitelisting in the application settings, Content Security Policy (CSP) frame-ancestors headers, and action authentication to prevent unauthorized cross-origin embedding and clickjacking attacks.

Modern Constellation Embed replaces legacy iframes with standard W3C Web Components (<pega-embed>), communicating headlessly via the Digital Experience API (DX API v2) and securing sessions through OAuth 2.0 PKCE token exchange.

Conversational channels—such as the Pega Email Bot and Virtual Assistant Chatbots—use integrated Natural Language Processing (NLP) text analytics to detect user intent, extract business entities, and automatically triage or instantiate cases.

Last updated: September 2026

Web Mashup, Digital Channels & Constellation Embed

Enterprise organizations rarely force customers or business partners to interact with their systems exclusively through dedicated back-office portals. Instead, modern digital strategies demand that business processes be seamlessly embedded into existing public corporate websites, customer self-service extranets, mobile consumer apps, and conversational channels such as email and chatbots.

The Pega Platform realizes this vision through its Multichannel Architecture . By decoupling business logic, case stages, data validation, and Service Level Agreements (SLAs) from presentation, Pega allows organizations to "Build for Change" once and deploy everywhere. This section contrasts traditional Pega Web Mashup with modern Constellation Embed , details cross-origin security frameworks, and explores conversational digital channels.

1. Pega Multichannel Architecture: Build Once, Deploy Everywhere

In traditional software development, supporting multiple engagement channels often meant writing duplicate business logic: one codebase for the web portal, another for mobile apps, and bespoke middleware for email parsing. Pega eliminates this duplication: +-------------------------------------------------------------------------+

  • | PEGA MULTICHANNEL CORE ARCHITECTURE |
  • +-------------------------------------------------------------------------+
  • | [ CENTRALIZED PEGA CASE LIFECYCLE ENGINE ] |
  • | - Case Stages, Steps, and Flow Rules |
  • | - Enterprise Data Model & Data Pages |
  • | - Declarative Business Rules, Validations, & SLAs |
  • | - Security Roles, Access Groups, & Attribute-Based Access Control |
  • +-------------------------------------------------------------------------+
  • │
  • ┌───────────────┬─────────────┴───────────────┬────────────────┐
  • ▼ ▼ ▼ ▼
  • +-------------+ +-------------+ +-------------+ +-------------+
  • | PEGA MOBILE | | WEB MASHUP | |CONSTELLATION| |CONVERSATION |
  • | CLIENT | | (TRADITIONAL| | EMBED | | CHANNELS |
  • | Hybrid App | | DIV/IFRAME) | | (WEB COMPONENT| | Email Bot, |
  • | iOS/Android | | Portal Div | | DX API v2) | | Chatbots |
  • +-------------+ +-------------+ +-------------+ +-------------+

Regardless of whether a customer initiates an auto insurance claim via an embedded web component on an external portal, an automated email bot, or a smartphone app, the exact same validation rules, calculation engines, and stage transitions govern the case.

2. Traditional Pega Web Mashup (Pega Composite Gateway)

Pega Web Mashup (historically known as the Pega Composite Application Gateway) enables organizations to embed Pega application functionality directly into an existing external web page (such as an enterprise intranet or public commercial website).

The Mashup Integration Mechanism

A web mashup operates by injecting a Pega-controlled <div> container into the host page's Document Object Model (DOM). The host page includes Pega mashup JavaScript libraries ( pega.web.mashup or pzIncludeMashupScripts ) that communicate with the Pega application server, rendering the case interface inside an auto-generated responsive iframe.

Core iaction Directives

The behavior of the embedded mashup gadget is governed by the data-pega-action attribute (or iaction in legacy syntax):

createNewWork : Instantiates a new case of the specified class (defined by data-pega-classname ) and opens the initial assignment view. Common for public customer self-service forms (e.g., submitting a credit card application or warranty claim).

openAssignment : Opens a specific pending assignment directly, identified by its unique assignment key ( data-pega-actionparam-assignmentkey ). Frequently used when an external system deep-links a manager into an approval task.

openWorkItem : Opens an existing case record in read-only or review mode using its business identifier ( pyID , specified via data-pega-actionparam-workid ).

openWorkByHandle : Opens an existing case using its internal unique system identifier ( pzInsKey ).

getNextWork : Evaluates the user's skills, work groups, and assignment urgency to retrieve and present the next highest-priority assignment from the enterprise workbasket or worklist.

Essential Gadget Attributes

A standard Pega Web Mashup snippet embedded in an external HTML page includes several mandatory configuration attributes: <!-- Pega Web Mashup Gadget Container -->

  • <div id="PegaGadgetA"
  • data-pega-gadgetname="PegaGadgetA"
  • data-pega-action="createNewWork"
  • data-pega-classname="FSG-Banking-Work-CreditCardApplication"
  • data-pega-flowname="pyStartCase"
  • data-pega-url="https://pega.enterprise.com/prweb/PRServlet"
  • data-pega-application="CreditCardServices"
  • data-pega-threadname="STANDARD"
  • data-pega-systemid="pega"
  • data-pega-parameters="{CustomerTier:'Gold', LeadSource:'CorporatePortal'}">
  • </div>
  • <script src="https://pega.enterprise.com/prweb/PRServlet/pzIncludeMashupScripts.js"></script>

data-pega-gadgetname : Assigns a unique DOM identifier to the gadget instance, enabling JavaScript interactions between the host page and the gadget.

data-pega-url : The URL of the Pega gateway servlet (typically /prweb/PRServlet or a secure custom access servlet).

data-pega-threadname : Isolates the Clipboard memory state of the mashup session in a dedicated Pega Thread, preventing cross-session interference.

data-pega-parameters : Passes contextual data from the parent host page into the Pega Clipboard. These parameters populate properties on pyWorkPage or initialize parameters on the starting flow.

pzSetDataPage : A specialized mashup action that allows the host page to set or refresh parameters on a designated Clipboard Data Page without refreshing the entire visual layout.

Cross-Origin Security, Domain Whitelisting & CSP

Embedding an enterprise rules engine into third-party web domains introduces significant security risks, including Cross-Site Scripting (XSS), cross-origin data tampering, and clickjacking. Pega enforces three layers of defense:

Action Authentication:

Mashups can operate under authenticated single sign-on (SSO) using SAML 2.0 or OpenID Connect.

For public-facing, unauthenticated scenarios (e.g., public loan applications), the mashup connects through a restricted Anonymous Access Service (utilizing an unauthenticated guest requestor pool, such as pyAnonymous ) configured with strict, least-privilege security roles.

Domain Whitelisting (CORS Protection):

Pega strictly prohibits cross-origin communication from untrusted websites.

In the Pega Application rule (or Mashup Channel interface under Trusted domains ), architects must explicitly define all permissible parent origins (e.g., https://www.mycompany.com , https://intranet.mycompany.com ).

During runtime, the Pega mashup script checks the window.postMessage origin. If the host page domain is not explicitly whitelisted, the Pega engine blocks all script communication and refuses to render the gadget.

Content Security Policy (CSP) & Frame-Ancestors:

To protect against Clickjacking (where an attacker embeds the Pega mashup inside a transparent iframe on a malicious website to hijack user clicks), Pega administrators configure Content Security Policy rules ( Rule-Access-CSP ).

The HTTP response header Content-Security-Policy: frame-ancestors https://www.mycompany.com instructs the client browser that only designated enterprise origins are permitted to frame the Pega application.

3. Modern Constellation Embed: Web Components & DX API v2

While traditional Pega Web Mashup remains widely deployed in legacy architectures, modern enterprise front-end development has converged on component-driven Single Page Application (SPA) frameworks (React, Angular, Vue). Embedding legacy iframes into modern SPAs introduces well-known challenges: rigid styling boundaries, double vertical scrollbars, mobile responsive layout glitches, and browser cookie restrictions (SameSite cookie blocking).

Pega resolves these limitations with Constellation Embed . +-------------------------------------------------------------------------+

  • | CONSTELLATION EMBED ARCHITECTURE |
  • +-------------------------------------------------------------------------+
  • | [ HOST SINGLE-PAGE APPLICATION (REACT / ANGULAR / VUE / HTML5) ] |
  • | |
  • | <pega-embed |
  • | caseTypeID="FSG-Banking-Work-Loan" |
  • | appAlias="loans" |
  • | pegaServerUrl="https://pega.enterprise.com" |
  • | authConfig="{authService: 'oauth2', clientId: '... '}"> |
  • | </pega-embed> |
  • +-------------------------------------------------------------------------+
  • │ │
  • │ Headless RESTful JSON │ Modern Token
  • │ via DX API v2 │ Exchange (PKCE)
  • ▼ ▼
  • +----------------------------------+ +--------------------------------+
  • | DIGITAL EXPERIENCE API (DX API) | | OAUTH 2.0 AUTHORIZATION SERVER |
  • | - UI Metadata & Raw Data Payload | | - Zero Third-Party Cookies |
  • | - Lightweight, Stateless REST | | - JWT Bearer Tokens |
  • +----------------------------------+ +--------------------------------+
  • The <pega-embed> Web Component

Constellation Embed is built on the standardized W3C Web Components specification:

It exposes a custom HTML element: <pega-embed> .

Frontend developers import the lightweight Constellation Embed JavaScript module into their modern web project. The component can be placed anywhere in a React JSX template, Angular component, or static HTML file.

Shadow DOM & Styling Consistency: Unlike legacy mashups that clash with external stylesheets, <pega-embed> encapsulates its internal markup within the Shadow DOM or inherits the parent portal's CSS design tokens, ensuring cohesive typography, colors, and responsive reflow.

Digital Experience API v2 (DX API v2)

Constellation Embed communicates with the Pega Platform strictly headlessly via the Digital Experience API (DX API v2) :

The browser does not receive server-rendered HTML markup fragments.

DX API v2 delivers lightweight JSON payloads that separate UI Metadata (which fields to render, layout slot definitions, display modes) from Transactional Data (raw case property values).

Network payloads are drastically smaller, eliminating the latency and DOM flickering characteristic of traditional iframe refreshes.

Modern Authentication: OAuth 2.0 & PKCE

Modern web browsers (such as Apple Safari with Intelligent Tracking Prevention and Google Chrome) aggressively restrict or block third-party cookies inside iframes, which frequently breaks traditional mashup sessions.

Constellation Embed eliminates reliance on third-party session cookies by utilizing OAuth 2.0 Authorization Code Grant with Proof Key for Code Exchange (PKCE) or JSON Web Token (JWT) bearer exchange.

The host application negotiates an access token directly with the enterprise identity provider and attaches the bearer token to outbound DX API requests, establishing a secure, stateless session.

4. Conversational Digital Channels: Email & Chatbots

Beyond visual browser embedding, Pega's multichannel framework natively supports automated conversational channels that transform unstructured customer communications into structured case workflows.

The Pega Email Channel (Email Bot)

Enterprise customer service centers receive millions of emails daily. The Pega Email Channel integrates natural language processing with automated case lifecycle execution:

Inbound Email Listener: Monitors dedicated enterprise mailboxes via IMAP, POP3, or Microsoft Graph API.

Text Analytics & Natural Language Processing (NLP): When an email arrives, Pega's integrated text analyzer evaluates the message body and attachments:

Intent Detection: Determines the customer's goal (e.g., Address Change , Dispute Transaction , Request Policy Cancellation ).

Entity Extraction: Identifies and parses critical business data entities (e.g., Account Number, Customer Name, Monetary Amount, Vehicle VIN).

Sentiment Analysis: Flags hostile or distressed customer emails for expedited priority routing.

Automated Case Instantiation & Routing: Based on detected intent, the Email Bot automatically creates the corresponding case type, maps extracted entities directly to case properties, attaches incoming email attachments to the case record, and routes the assignment to the appropriate work queue.

Contextual Auto-Reply: The system drafts or dispatches an automated, templated email response acknowledging receipt and quoting the newly created Case ID.

Pega Virtual Assistant (Chatbot & Messaging)

Pega Virtual Assistant extends the multichannel engine to conversational chat interfaces—including web-based chat widgets and third-party messaging networks (SMS, WhatsApp, Facebook Messenger, Microsoft Teams):

Conversational Flows: Guides customers through structured dialog flows to resolve inquiries or initiate service cases.

Omnichannel State Preservation: If a customer starts a loan inquiry on a web chatbot, pauses, and later resumes via SMS, Pega preserves the case state.

Human Escalation: If the chatbot detects high customer frustration or an intent falling below confidence thresholds, it seamlessly transfers the session to a live customer service representative, delivering the complete conversational transcript and pre-populated case context.

5. Architectural Comparison Matrix: Integration Paradigms

Architecture Dimension Traditional Web Mashup Modern Constellation Embed DX API Direct Integration

Underlying Mechanism HTML <div> wrapper rendering an internal <iframe> Standard W3C Web Component ( <pega-embed> ) Pure Headless RESTful API calls ( DX API v2 )

Communication Protocol HTML Stream responses & postMessage JavaScript bridge RESTful JSON over HTTPS via DX API v2 Pure JSON requests/responses over HTTPS

UI Rendering Engine Server-side PRPC engine renders complete HTML/CSS Client-side Constellation React engine via Web Component Host framework (Custom React, Angular, iOS native UI)

Styling & Theming Governed by Pega Skin rule; difficult to blend with host Controlled by Cosmos design tokens or host CSS variables 100% custom styling authored in host framework

Authentication Protocol Cookie-based HTTP sessions; SAML 2.0 SSO; guest requestors OAuth 2.0 Authorization Code with PKCE / JWT OAuth 2.0 Bearer Token (Stateless REST)

Third-Party Cookie Risk High; vulnerable to modern browser SameSite cookie blocking Zero; utilizes standard HTTP authorization headers Zero; purely token-based API authentication

Upgrade Impact Moderate; custom HTML/CSS overrides may break Near Zero; decoupled presentation protected by APIs Near Zero; strict semantic versioning on DX API endpoints

Recommended Use Case Legacy portal integrations with existing Section UI Modern web apps (React/Angular) embedding Pega cases Bespoke custom digital frontends requiring total UI control

Loading diagram... Traditional Web Mashup vs Constellation Embed vs Headless DX API