Crayfish Commons Syn Laravel Package

Product Decisions This Supports

• Multi-tenancy in JWT authentication: Enables secure, scalable token-based authentication across multiple tenants (e.g., SaaS platforms, federated systems).
• Legacy system modernization: Bridges gaps in older Crayfish-Commons versions (pre-4.x) while leveraging modern Lexik JWT under the hood.
• Build vs. buy: Avoids reinventing JWT/Syn parsing logic, reducing dev time and technical debt.
• Roadmap alignment: Supports future-proofing for projects migrating to newer Crayfish versions or adopting Symfony Security components.
• Use cases:
  • Federated identity systems (e.g., shared auth across microservices).
  • Tenant-isolated APIs with centralized auth (e.g., B2B platforms).
  • Legacy system integration where Syn parsing was previously critical.

When to Consider This Package

• Adopt if:

  • Your PHP/Symfony app requires multi-tenancy with JWT and relies on Syn parsing (e.g., legacy Islandora systems).
  • You’re using Crayfish-Commons <4.x and need Syn functionality without a full migration.
  • Your team lacks bandwidth to build a custom Lexik JWT + multi-tenancy solution.
  • You prioritize MIT-licensed, open-source over proprietary alternatives.

• Look elsewhere if:

  • You’re not using Symfony Security or Crayfish-Commons (package is tightly coupled).
  • Your JWT needs exceed multi-tenancy (e.g., complex claims validation, non-standard token formats).
  • You require active maintenance (package has 0 stars, minimal documentation).
  • Your stack is PHP 8.x+ with strict compatibility needs (tested on PHP 7.2+ only).
  • You need enterprise support (community-driven, no SLAs).

How to Pitch It (Stakeholders)

For Executives: "This package lets us securely authenticate multi-tenant users via JWT with minimal dev effort—critical for scaling our [SaaS/federated system] without reinventing the wheel. It’s a lightweight, MIT-licensed solution that integrates with our existing Symfony stack, reducing risk while enabling faster time-to-market for tenant-isolated features. The trade-off? We’ll rely on community support for now, but it’s a fraction of the cost of a custom build."

For Engineering: *"This is a Symfony Security + Lexik JWT wrapper tailored for Crayfish-Commons multi-tenancy. It solves our Syn parsing gap post-4.x upgrade while keeping auth logic DRY. Key benefits:

• Plug-and-play: Configurable via security.yaml with minimal boilerplate.
• Future-proof: Built on Lexik JWT (industry standard) with room to extend.
• Low risk: MIT license, PHP 7.2+ compatible, and aligns with our Symfony roadmap. Downside: Limited docs and community activity—we’ll need to validate edge cases early. Recommend pairing with Islandora’s official docs and community forums for troubleshooting."*

For Architects: *"This package abstracts Syn JWT parsing for multi-tenancy, which is a common pain point in federated systems. It’s a vertical solution—not a general-purpose JWT library—so it’s only viable if:

1. You’re using Symfony Security + Crayfish-Commons.
2. Your auth flow requires tenant-aware token validation.
3. You can tolerate community-driven support (no vendor backing). Alternatives: If you’re not tied to Crayfish, consider Lexik JWT directly or Firebase JWT for broader flexibility."*