mosl / opensign-bridge-bundle

v0.8.1 2026-09-04 09:46 UTC

Requires

• php: >=8.4
• guzzlehttp/guzzle: ^7.8
• rollerworks/password-strength-validator: ^3.0
• symfony/console: ^8.0
• symfony/framework-bundle: ^8.0
• symfony/http-kernel: ^8.0
• symfony/messenger: ^8.0
• symfony/scheduler: ^8.0
• symfony/validator: ^8.0
• symfony/var-exporter: ^8.0
• symfony/yaml: ^8.0

Requires (Dev)

• phpstan/phpstan: ^2.2
• phpunit/phpunit: ^10.5
• symplify/easy-coding-standard: ^12.1

MIT

Published on Packagist.org on 2026-09-04 09:48 UTC

README

OpenSignBridgeBundle

mosl stands for Mosaic OpenSource Library.

This Symfony bundle provides the complete infrastructure and service layer needed to integrate OpenSign and MinIO into any Symfony project.

🚀 Quick Start (Development)

To test or develop the bundle independently:

1. Ensure Containers are Up:

   task up

2. Bootstrap OpenSign: This command creates the API user, generates tokens, and initializes the MongoDB schema.

   task opensign:setup

3. Restart Containers: Apply the new environment variables from .env.dist to the running PHP container.

   task restart

📦 Installation in a Host App

1. Require the bundle via Composer. This registers the bundle in config/bundles.php and writes config/packages/opensign_bridge.yaml (config root open_sign_bridge):

   composer require mosl/opensign-bridge-bundle

2. Configure your environment variables (.env):

   OPENSIGN_APP_ID=your_app_id
   OPENSIGN_MASTER_KEY=your_master_key
   OPENSIGN_API_URL=http://your-opensign-url/app
   OPENSIGN_USER_ID=your_system_user_id
   OPENSIGN_SESSION_TOKEN=your_session_token

   OPENSIGN_USER_ID/OPENSIGN_SESSION_TOKEN come from opensignb:opensign:setup (run once against your OpenSign server) — see the Full Integration Guide.

⚠️ No Outbound Webhook

The self-hosted, open-source OpenSign server does not call back into your app when a document is signed — "Live Webhooks" are a paid OpenSign Labs SaaS feature. Detecting completion means polling via OpenSignPollingService; see the Full Integration Guide.

📖 Documentation

For the full signing flow (required payload fields, polling setup, common pitfalls), see the Full Integration Guide.