Box

Descrizione

Connettore enterprise per Box.com — la piattaforma di Enterprise Content Management cloud nata nel 2005 (IPO 2015, $3B+ valuation, 100k+ customer enterprise tier-1 inclusi GE, Coca-Cola, Toyota, Bank of America) — alternativa enterprise-focused a Dropbox/Google Drive con feature dedicate per governance documentale, compliance HIPAA/SOC2/FedRAMP, granular permission con accessi role-based, workflow approvals nativi, content classification & retention policies — via API 2.0 ufficiale. Cinque operazioni atomiche coprono il file/folder lifecycle: listFolder (enumera items di una cartella identificata by folder_id, root cartella tenant ha sempre id="0" — pattern di discovery contenuto), createFolder (crea nuova cartella sotto un parent specifico), getItem (metadata di un file o cartella specifico — tipo, size, creation date, owner, version_count), createSharedLink (genera shared URL per file/folder con livello visibilità configurable: open=URL pubblico chiunque conosca il link può accedere, company=solo membri del Box enterprise account, collaborators=solo utenti esplicitamente shared del file), deleteFile (cancellazione con soft-delete in trash 30gg default per recovery). Auth via Access Token Bearer (formato OAuth2 stored nel vault — il token short-lived 60min richiede refresh-token flow gestito dal portal-centric OAuth2 service per multi-tenant SaaS pattern enterprise). Multi-account supportato (un tenant FlowForge che gestisce N Box account distinti per agenzie che servono multiple customer enterprise). Validation enterprise pre-API: file/folder ID validati numerici (anti-typo che produrrebbe 404), shared link access level enum-strict, name length cap 255 char (limite Box). Pipeline anti-vulnerability standard FlowForge: tutte le request via SSRF-safe gateway, circuit-breaker dedicato per Box, retry exponential backoff su 5xx/429. Rate limit Box: 5000 req/min sustained per app + token combination (83 RPS, comfortable per use case enterprise), header X-Box-Endpoint-Request tracked. Output: { entries? (per listFolder), count?, id? (per createFolder/createSharedLink), sharedUrl? + accessLevel? + expiresAt?, item? (per getItem), deleted? (boolean per deleteFile), totalSize? per folder summary }. Use case enterprise content management: archivio documentale aziendale governato (workflow di ingest documents → classification → store nella corretta cartella subdivision per dipartimento + tag con metadata custom); condivisione controllata file con clienti/partner B2B (createSharedLink con access=company per limitare visibility); gestione contenuti compliance-ready per audit ISO 27001/SOC2 con retention policy automated; automazione cartelle progetto (al closing di un new deal Salesforce → createFolder "Projects/{{customer_name}}/{{project_id}}" + setup default sub-structure); distribuzione report mensile management con permessi company-only; retention automatica documenti fiscali (10 anni dal createdAt → workflow cron mensile + delete o move to archive cartella).

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-community_box-1",
  "defId": "community_box",
  "label": "Box",
  "config": {
    "operation": "listFolder",
    "itemType": "files",
    "access": "open",
    "limit": 100
  }
}

🔗 Nodi correlati nella stessa categoria