implement-idp-integration

Implement provider-agnostic identity integration for Firefly Banking Platform with pluggable IdpAdapter and REST endpoints.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/firefly-oss/firefly-oss-claude-skills --skill implement-idp-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: implement-idp-integration
Source: https://github.com/firefly-oss/firefly-oss-claude-skills/tree/main/skills/implement-idp-integration
Command: npx skills add https://github.com/firefly-oss/firefly-oss-claude-skills --skill implement-idp-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Identity Provider integration layer for Firefly Banking Platform enables a single, provider-agnostic port/adapter framework that supports multiple vendors (Keycloak, Cognito, Azure AD) and internal DB authentication, wiring authentication, token management, and session orchestration through a unified IdpAdapter.

Core Features & Use Cases

  • Pluggable provider adapters activated by firefly.idp.provider with auto-configuration and minimal coupling.
  • Unified authentication, token exchange, MFA, user/admin management, and session controls across providers.
  • Use Case: migrate from one IdP to another by swapping configuration without code changes, ensuring consistent REST endpoints and admin workflows.

Quick Start

Configure your environment to point to a provider via firefly.idp.provider and start the application to enable provider-specific IdP flows through the IdpController.

Frequently Asked Questions about implement-idp-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a swappable identity provider integration that supports Keycloak, Cognito, and Azure AD?

A swappable identity provider integration uses an IdpAdapter interface with provider-specific auto-configurations activated by a configuration property. This enables swapping providers without code changes, exposing unified REST endpoints for login, token exchange, MFA, and session control across different vendors.

What is provider-agnostic authentication and how does the adapter pattern work for OAuth2?

Provider-agnostic authentication abstracts vendor-specific OAuth2 and OpenID Connect protocols behind a single port/adapter framework. The IdpAdapter interface isolates provider logic, allowing the application to interact uniformly with Keycloak, Cognito, Azure AD, or internal DB authentication through consistent APIs.

Can I migrate from Cognito to Azure AD without modifying backend authentication code?

Yes, migrating between identity providers like Cognito and Azure AD is achieved by changing the provider configuration property. The auto-configuration activates the corresponding adapter, ensuring consistent REST endpoints, token management, and admin workflows without requiring backend code modifications.

Does this identity provider adapter handle token introspection and MFA across different vendors?

Yes, the identity provider adapter handles token introspection and MFA across different vendors. It orchestrates unified authentication, token exchange, user management, and session controls through the reactive REST controller, ensuring consistent behavior regardless of the underlying provider.

How do I configure auto-configuration for a specific identity provider in a banking platform?

Configuring a specific identity provider requires setting the provider property in the application environment. Starting the application triggers provider-specific auto-configuration, enabling IdP flows like login, refresh, introspection, user info, and admin APIs through the unified controller.

When should I use a provider-agnostic identity provider adapter instead of direct OAuth2 integration?

Use a provider-agnostic identity provider adapter when a deployment requires supporting multiple vendors or internal DB authentication, needing consistent token management and session orchestration. Direct OAuth2 integration is less suitable when anticipating future provider migration or requiring unified admin workflows.