NiFi Extensions

Overview

Custom extensions for Apache NiFi developed by CUI-OSS.

Status

Documentation

• Generated Documentation on github-pages

• Requirements

• Specification

• NiFi CUI-OSS Processors

• Integration Testing Environment

• End-to-End Testing Documentation

Components

MultiIssuerJWTTokenAuthenticator

A NiFi processor that authenticates JWT tokens from multiple issuers.

End-to-End Testing

Complete Playwright-based end-to-end testing framework with:

• Custom Playwright utilities for NiFi UI automation

• Self-verification unit tests (24 tests)

• Comprehensive E2E test suites for processor configuration and token validation

• Console error monitoring with allowlist management

• Complete CI/CD integration with GitHub Actions

• Docker-based test environment with NiFi and Keycloak

• Local integration testing with automated container management

See E2E Testing Documentation for details.

Maven Coordinates

<dependency>
    <groupId>de.cuioss.nifi</groupId>
    <artifactId>nifi-extensions</artifactId>
</dependency>

Building

./mvnw clean install

To skip tests:

./mvnw clean install -DskipTests

Local Integration Testing

Run the complete integration test suite locally with automated container management:

# Full integration test suite with Maven
./mvnw integration-test -Plocal-integration-tests -Dintegration.test.local=true

# Quick test run using existing containers
cd e-2-e-playwright && npm run playwright:test

# Interactive test development
cd e-2-e-playwright && npm run playwright:test:ui

See End-to-End Testing Documentation for detailed instructions.

Code Quality Standards

This project implements centralized coding standards defined in the organization’s standards repository:

• JavaScript/ESLint Standards: JavaScript Standards - Complete linting configuration and best practices

• Java Standards: Java Standards - Java coding standards and conventions

• Testing Standards: Testing Standards - Comprehensive testing guidelines

• Documentation Standards: Documentation Standards - Documentation structure and requirements

The project achieves zero-warning builds through strategic implementation of these centralized standards.

Frontend Configuration

The project uses unified frontend configuration across modules:

• Node.js v20.12.2

• NPM 10.5.0

• Frontend Maven Plugin 1.15.1

• ESLint 8.57.1 with zero-warning policy (following centralized standards)

• Prettier 3.4.2 for code formatting

• Playwright 1.42.1 for E2E testing

All frontend configuration is centralized in the root POM properties.

Important

All contributors and AI tools (including GitHub Copilot, Claude, and others) must follow the AI Development Guidelines in doc/ai-rules.md. These rules are mandatory for all code, documentation, and configuration changes. See the file for process, code style, testing, logging, and documentation standards.