@noeva/etl-core 1.1.1 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (87) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/dist/chunk-IDQXX435.js +1 -0
  3. package/dist/{chunk-KEFIGSRS.js → chunk-SRO66WUJ.js} +1 -1
  4. package/dist/chunk-XRRC27NI.js +1 -0
  5. package/dist/cli.js +120 -120
  6. package/dist/connectors/process.js +1 -1
  7. package/dist/etl.config.js +6 -6
  8. package/dist/guida/404.html +2 -2
  9. package/dist/guida/GUIDA_SVILUPPO.html +4 -4
  10. package/dist/guida/TECHNICAL_OVERVIEW.html +4 -4
  11. package/dist/guida/assets/{app.uK-5scpr.js → app.Dsl1ZLFh.js} +1 -1
  12. package/dist/guida/assets/chunks/@localSearchIndexroot.DZbSWLHu.js +1 -0
  13. package/dist/guida/assets/chunks/{VPLocalSearchBox.CB5vaMvW.js → VPLocalSearchBox.CMLsenZG.js} +1 -1
  14. package/dist/guida/assets/chunks/{theme.z6u0J2Ii.js → theme.DspmxPAW.js} +7 -7
  15. package/dist/guida/assets/pipelines_analytics-snapshot.md.B8KfsjUs.js +1 -0
  16. package/dist/guida/assets/pipelines_analytics-snapshot.md.B8KfsjUs.lean.js +1 -0
  17. package/dist/guida/connectors/README.html +4 -4
  18. package/dist/guida/connectors/excel.html +4 -4
  19. package/dist/guida/connectors/file.html +4 -4
  20. package/dist/guida/connectors/http.html +4 -4
  21. package/dist/guida/connectors/imap.html +4 -4
  22. package/dist/guida/connectors/jira.html +4 -4
  23. package/dist/guida/connectors/mysql.html +4 -4
  24. package/dist/guida/connectors/noeva.html +4 -4
  25. package/dist/guida/connectors/oauth.html +4 -4
  26. package/dist/guida/connectors/odoo.html +4 -4
  27. package/dist/guida/connectors/postgres.html +4 -4
  28. package/dist/guida/connectors/process.html +4 -4
  29. package/dist/guida/connectors/sendgrid.html +4 -4
  30. package/dist/guida/connectors/smtp.html +4 -4
  31. package/dist/guida/connectors/sqlserver.html +4 -4
  32. package/dist/guida/connectors/zoho.html +4 -4
  33. package/dist/guida/conventions/node-columns.html +4 -4
  34. package/dist/guida/conventions/node-descriptor.html +4 -4
  35. package/dist/guida/conventions/run-report.html +4 -4
  36. package/dist/guida/conventions/run-trace.html +4 -4
  37. package/dist/guida/conventions/variabili-del-core.html +4 -4
  38. package/dist/guida/conventions/versioni-di-pipeline.html +4 -4
  39. package/dist/guida/guide/claude-code/index.html +4 -4
  40. package/dist/guida/guide/claude-code/prompt.html +4 -4
  41. package/dist/guida/guide/claude-code/strumenti.html +4 -4
  42. package/dist/guida/guide/grafo.html +4 -4
  43. package/dist/guida/guide/usare/app-desktop.html +4 -4
  44. package/dist/guida/guide/usare/esito-di-una-run.html +4 -4
  45. package/dist/guida/guide/usare/index.html +4 -4
  46. package/dist/guida/hashmap.json +1 -1
  47. package/dist/guida/index.html +3 -3
  48. package/dist/guida/nodes/README.html +4 -4
  49. package/dist/guida/nodes/action.html +4 -4
  50. package/dist/guida/nodes/ai.html +4 -4
  51. package/dist/guida/nodes/join.html +4 -4
  52. package/dist/guida/nodes/lookup.html +4 -4
  53. package/dist/guida/nodes/pipeline.html +4 -4
  54. package/dist/guida/nodes/route.html +4 -4
  55. package/dist/guida/nodes/sink.html +4 -4
  56. package/dist/guida/nodes/source.html +4 -4
  57. package/dist/guida/nodes/task.html +4 -4
  58. package/dist/guida/nodes/transform.html +4 -4
  59. package/dist/guida/nodes/try-catch.html +4 -4
  60. package/dist/guida/nodes/union.html +4 -4
  61. package/dist/guida/pagine.json +2 -0
  62. package/dist/guida/pipelines/README.html +5 -5
  63. package/dist/guida/pipelines/analytics-snapshot.html +40 -0
  64. package/dist/guida/pipelines/crm-leads-sync.html +4 -4
  65. package/dist/guida/pipelines/cross-workspace-csv-merge.html +4 -4
  66. package/dist/guida/pipelines/movimenti-per-conto.html +4 -4
  67. package/dist/guida/pipelines/orders-enriched-daily.html +4 -4
  68. package/dist/guida/pipelines/test-posta.html +5 -5
  69. package/dist/guida/runbooks/aggiornamento-pm2.html +4 -4
  70. package/dist/guida/runbooks/deploy-ecr.html +4 -4
  71. package/dist/guida/runbooks/deployment.html +4 -4
  72. package/dist/guida/runbooks/etl-worker.html +4 -4
  73. package/dist/guida/runbooks/excel-operazioni-distruttive.html +4 -4
  74. package/dist/guida/runbooks/graph-server.html +4 -4
  75. package/dist/guida/runbooks/mask-key.html +4 -4
  76. package/dist/guida/runbooks/oauth-google-posta.html +4 -4
  77. package/dist/guida/runbooks/rollback-di-pipeline.html +4 -4
  78. package/dist/guida/runbooks/scd2-rehash.html +4 -4
  79. package/dist/guida/runbooks/sql-task-truncate-swap.html +4 -4
  80. package/dist/guida/runbooks/stato-incrementale.html +4 -4
  81. package/dist/guida/sub-pipelines/README.html +4 -4
  82. package/dist/guida/sub-pipelines/riepilogo-ordini.html +4 -4
  83. package/dist/pipelines.d.ts +24 -1
  84. package/dist/pipelines.js +1 -1
  85. package/package.json +1 -1
  86. package/dist/chunk-5XVANFXO.js +0 -1
  87. package/dist/guida/assets/chunks/@localSearchIndexroot.AxYI9rrX.js +0 -1
@@ -9,9 +9,9 @@
9
9
  <link rel="preload stylesheet" href="/guida/core/assets/style.DFlUbYCk.css" as="style">
10
10
  <link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
11
11
 
12
- <script type="module" src="/guida/core/assets/app.uK-5scpr.js"></script>
12
+ <script type="module" src="/guida/core/assets/app.Dsl1ZLFh.js"></script>
13
13
  <link rel="preload" href="/guida/core/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
14
- <link rel="modulepreload" href="/guida/core/assets/chunks/theme.z6u0J2Ii.js">
14
+ <link rel="modulepreload" href="/guida/core/assets/chunks/theme.DspmxPAW.js">
15
15
  <link rel="modulepreload" href="/guida/core/assets/chunks/framework.qdetmeNX.js">
16
16
  <link rel="modulepreload" href="/guida/core/assets/runbooks_oauth-google-posta.md.Bs7QTkmU.lean.js">
17
17
  <link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
@@ -20,7 +20,7 @@
20
20
  <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
21
21
  </head>
22
22
  <body>
23
- <div id="app"><div class="Layout" data-v-22f0e4eb><!--[--><!--]--><!--[--><span tabindex="-1" data-v-3426c47a></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-3426c47a>Skip to content</a><!--]--><!----><header class="VPNav" data-v-22f0e4eb data-v-c0562b42><div class="VPNavBar" data-v-c0562b42 data-v-09e46d68><div class="wrapper" data-v-09e46d68><div class="container" data-v-09e46d68><div class="title" data-v-09e46d68><div class="VPNavBarTitle has-sidebar" data-v-09e46d68 data-v-373bba86><a class="title" href="/guida/core/" data-v-373bba86><!--[--><!--]--><!--[--><!--[--><!--[--><img class="VPImage dark logo" src="/guida/core/logo-light.png" alt="Noeva" data-v-b8fe04e5><!--]--><!--[--><img class="VPImage light logo" src="/guida/core/logo-dark.png" alt="Noeva" data-v-b8fe04e5><!--]--><!--]--><!--]--><!----><!--[--><!--[--><!--[--><!--[--><span class="etl-wordmark" aria-hidden="true">ETL</span><span class="etl-embedded-title">Documentazione</span><!--]--><!--]--><!--]--><!--]--></a></div></div><div class="content" data-v-09e46d68><div class="content-body" data-v-09e46d68><!--[--><!--]--><div class="VPNavBarSearch search" data-v-09e46d68><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Cerca nella documentazione"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Cerca</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-09e46d68 data-v-39d75b74><span id="main-nav-aria-label" class="visually-hidden" data-v-39d75b74> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/usare/" tabindex="0" data-v-39d75b74 data-v-d4ae6030><!--[--><span data-v-d4ae6030>Usare</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/claude-code/" tabindex="0" data-v-39d75b74 data-v-d4ae6030><!--[--><span data-v-d4ae6030>Creare con Claude Code</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-39d75b74 data-v-5d303cc7><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-5d303cc7><span class="text" data-v-5d303cc7><!----><span data-v-5d303cc7>Riferimento</span><span class="vpi-chevron-down text-icon" data-v-5d303cc7></span></span></button><div class="menu" data-v-5d303cc7><div class="VPMenu" data-v-5d303cc7 data-v-e79ccfeb><div class="items" data-v-e79ccfeb><!--[--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/guide/grafo" data-v-b2643254><!--[--><span data-v-b2643254>Il grafo, nodo per nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/nodes/README" data-v-b2643254><!--[--><span data-v-b2643254>Tipi di nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/connectors/README" data-v-b2643254><!--[--><span data-v-b2643254>Connettori</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/pipelines/README" data-v-b2643254><!--[--><span data-v-b2643254>Pipeline pronte</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/run-report" data-v-b2643254><!--[--><span data-v-b2643254>Il report di run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/run-trace" data-v-b2643254><!--[--><span data-v-b2643254>La traccia di una run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/variabili-del-core" data-v-b2643254><!--[--><span data-v-b2643254>Variabili d'ambiente del core</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/runbooks/graph-server" data-v-b2643254><!--[--><span data-v-b2643254>Operatività</span><!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-09e46d68 data-v-41033a42><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-41033a42 data-v-16571e93 data-v-3d2b146f><span class="check" data-v-3d2b146f><span class="icon" data-v-3d2b146f><!--[--><span class="vpi-sun sun" data-v-16571e93></span><span class="vpi-moon moon" data-v-16571e93></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-09e46d68 data-v-6ab99828 data-v-5d303cc7><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-5d303cc7><span class="vpi-more-horizontal icon" data-v-5d303cc7></span></button><div class="menu" data-v-5d303cc7><div class="VPMenu" data-v-5d303cc7 data-v-e79ccfeb><!----><!--[--><!--[--><!----><div class="group" data-v-6ab99828><div class="item appearance" data-v-6ab99828><p class="label" data-v-6ab99828>Tema</p><div class="appearance-action" data-v-6ab99828><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-6ab99828 data-v-16571e93 data-v-3d2b146f><span class="check" data-v-3d2b146f><span class="icon" data-v-3d2b146f><!--[--><span class="vpi-sun sun" data-v-16571e93></span><span class="vpi-moon moon" data-v-16571e93></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-09e46d68 data-v-91920283><span class="container" data-v-91920283><span class="top" data-v-91920283></span><span class="middle" data-v-91920283></span><span class="bottom" data-v-91920283></span></span></button></div></div></div></div><div class="divider" data-v-09e46d68><div class="divider-line" data-v-09e46d68></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-22f0e4eb data-v-caa5a72f><div class="container" data-v-caa5a72f><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-caa5a72f><span class="vpi-align-left menu-icon" data-v-caa5a72f></span><span class="menu-text" data-v-caa5a72f>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-caa5a72f data-v-731b3d50><button data-v-731b3d50>Torna su</button><!----></div></div></div><aside class="VPSidebar" data-v-22f0e4eb data-v-ac566ed2><div class="curtain" data-v-ac566ed2></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-ac566ed2><span class="visually-hidden" id="sidebar-aria-label" data-v-ac566ed2> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Usare Noeva ETL</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Come si usa</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/app-desktop" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>L'app desktop</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/esito-di-una-run" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Leggere l'esito di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/TECHNICAL_OVERVIEW" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Panoramica di prodotto</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Creare con Claude Code</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Dal bisogno al processo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/prompt" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Comporre il prompt</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/strumenti" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Skill e subagent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/GUIDA_SVILUPPO" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Guida allo sviluppo</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Concetti</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/grafo" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Il grafo, nodo per nodo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/run-report" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Il report di run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/run-trace" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>La traccia di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/versioni-di-pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Versioni di pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/node-descriptor" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Descriptor dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/node-columns" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Colonne dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/variabili-del-core" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Variabili d'ambiente del core</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Tipi di nodo</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Cheatsheet</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/action" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>action</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/ai" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>ai</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/join" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>join</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/lookup" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>lookup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/route" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>route</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/sink" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>sink</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/source" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>source</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/task" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>task</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/transform" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>transform</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/try-catch" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>try-catch</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/union" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>union</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Connettori</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Panoramica</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/excel" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Excel</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/file" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>File (storage × codec)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/http" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>HTTP (API REST per i nodi lookup e action)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/imap" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>IMAP (caselle di posta)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/jira" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/mysql" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>MySQL e MariaDB</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/noeva" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Noeva (file dei workspace)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/oauth" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>OAuth2 per i connettori</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/odoo" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Odoo (record di un modello, con i campi dichiarati)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/postgres" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>PostgreSQL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/process" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>processo esterno</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/sendgrid" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SendGrid (mail via API REST)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/smtp" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SMTP (notifiche email)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/sqlserver" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SQL Server</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/zoho" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Zoho CRM (record di un modulo, con i campi dichiarati)</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Pipeline pronte</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Le schede di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/test-posta" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>test-posta</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Esempi</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/sub-pipelines/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Le schede di una sub-pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/crm-leads-sync" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>crm-leads-sync</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/cross-workspace-csv-merge" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>cross-workspace-csv-merge</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/movimenti-per-conto" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>movimenti-per-conto</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/orders-enriched-daily" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>orders-enriched-daily</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/sub-pipelines/riepilogo-ordini" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>riepilogo-ordini</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed has-active" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Operatività</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/aggiornamento-pm2" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>aggiornare un deploy PM2 di un repo cliente</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/deploy-ecr" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>un cliente su ECR + ECS</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/deployment" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>distribuzione del runner ETL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/etl-worker" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>worker etl worker (polling su processes)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/excel-operazioni-distruttive" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>operazioni distruttive di excelSink</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/graph-server" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>server grafi etl serve (HTTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/mask-key" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>chiavi di mask (creazione, rotazione, compromissione)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/oauth-google-posta" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>OAuth2 per una casella Google (IMAP + SMTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/rollback-di-pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>rollback di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/scd2-rehash" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>rehash di una dimensione storicizzata</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/sql-task-truncate-swap" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>task SQL, truncate e scambio di tabelle</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/stato-incrementale" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>stato di pipeline e watermark</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-22f0e4eb data-v-0c4b08a9><div class="VPDoc has-sidebar has-aside" data-v-0c4b08a9 data-v-4f20312f><!--[--><!--]--><div class="container" data-v-4f20312f><div class="aside" data-v-4f20312f><div class="aside-curtain" data-v-4f20312f></div><div class="aside-container" data-v-4f20312f><div class="aside-content" data-v-4f20312f><div class="VPDocAside" data-v-4f20312f data-v-2db35001><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-2db35001 data-v-2f8395af><div class="content" data-v-2f8395af><div class="outline-marker" data-v-2f8395af></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-2f8395af>In questa pagina</div><ul class="VPDocOutlineItem root" data-v-2f8395af data-v-9c3b479d><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-2db35001></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-4f20312f><div class="content-container" data-v-4f20312f><!--[--><!--]--><main class="main" data-v-4f20312f><div style="position:relative;" class="vp-doc _guida_core_runbooks_oauth-google-posta" data-v-4f20312f><div><h1 id="runbook-oauth2-per-una-casella-google-imap-smtp" tabindex="-1">Runbook: OAuth2 per una casella Google (IMAP + SMTP) <a class="header-anchor" href="#runbook-oauth2-per-una-casella-google-imap-smtp" aria-label="Permalink to &quot;Runbook: OAuth2 per una casella Google (IMAP + SMTP)&quot;">​</a></h1><p>Come si ottiene il refresh token di una casella Gmail o Workspace, e come si configura l&#39;ETL per usarlo.</p><p>Serve quando IMAP risponde:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>IMAP connessione su imap.gmail.com: autenticazione rifiutata — NO [ALERT] ...</span></span></code></pre></div><p>Google ha tolto l&#39;accesso IMAP con la password dell&#39;account: una password normale viene rifiutata <strong>anche se è giusta</strong>. Restano due vie — una password per le app, oppure OAuth2. Questo runbook copre la seconda, l&#39;unica adatta a un servizio che deve girare da solo.</p><blockquote><p><strong>Chi lo esegue.</strong> Una persona sola, che abbia sia l&#39;accesso alla Google Cloud Console del dominio, sia la possibilità di accedere alla casella. Servono entrambe le cose nello stesso momento, e la seconda quasi sempre è del cliente. Conta 15–20 minuti.</p></blockquote><h2 id="_1-il-progetto-e-l-app" tabindex="-1">1. Il progetto e l&#39;app <a class="header-anchor" href="#_1-il-progetto-e-l-app" aria-label="Permalink to &quot;1. Il progetto e l&#39;app&quot;">​</a></h2><p>Una volta per casella, sulla <a href="https://console.cloud.google.com/" target="_blank" rel="noreferrer">Google Cloud Console</a>.</p><ol><li><p>Accedi con un account del dominio e, dal selettore in alto, usa un progetto esistente o creane uno nuovo (per esempio <code>noeva-etl-posta</code>).</p></li><li><p>Vai su <strong>Google Auth Platform</strong> (<code>console.cloud.google.com/auth/overview</code>). Se l&#39;app non è ancora registrata la console lo chiede adesso: è obbligatorio <strong>prima</strong> di poter creare un client. Compila nome dell&#39;app, email di supporto e contatto.</p></li><li><p><strong>Tipo di utente: <code>Internal</code>.</strong> È la scelta che conta, e va fatta ora perché cambiarla dopo invalida il lavoro. Vincola l&#39;app al vostro dominio, non richiede alcuna verifica da parte di Google per lo scope della posta — che è classificato <em>restricted</em> — ed evita la scadenza a sette giorni del refresh token, che colpisce solo le app <code>External</code> in stato <code>Testing</code>.</p><p>Lo verifichi nella pagina <strong>Audience</strong> (<code>console.cloud.google.com/auth/audience</code>): il campo <code>User type</code> deve dire <code>Internal</code>. <code>External</code> serve solo per una casella Gmail personale, e in quel caso devi anche portare <code>Publishing status</code> a <code>In production</code>, o il token ti muore dopo una settimana.</p></li><li><p><strong>Data access → aggiungi lo scope <code>https://mail.google.com/</code>.</strong> Uno solo: copre IMAP e SMTP insieme.</p></li></ol><h2 id="_2-il-client-→-client-id-e-client-secret" tabindex="-1">2. Il client → <code>CLIENT_ID</code> e <code>CLIENT_SECRET</code> <a class="header-anchor" href="#_2-il-client-→-client-id-e-client-secret" aria-label="Permalink to &quot;2. Il client → `CLIENT_ID` e `CLIENT_SECRET`&quot;">​</a></h2><ol start="5"><li><p><strong>Google Auth Platform → Clients</strong> (<code>console.cloud.google.com/auth/clients</code>) → <strong>CREATE CLIENT</strong>.</p></li><li><p><strong>Application type: <code>Web application</code>.</strong></p><p>⚠️ <strong>Non «Desktop app»</strong>, anche se il worker ETL è a tutti gli effetti un servizio. Serve un tipo di client su cui si possa dichiarare un redirect URI, e per i client Desktop la console — testualmente — «non richiede alcuna informazione aggiuntiva»: quel campo non esiste, e il passo 8 diventa impossibile.</p></li><li><p>Dai un nome al client (per esempio <code>noeva-etl</code>).</p></li><li><p>In <strong>Authorized redirect URIs</strong> → <strong>ADD URI</strong>, incolla esattamente, senza barra finale:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>https://developers.google.com/oauthplayground</span></span></code></pre></div></li><li><p><strong>CREATE</strong>.</p></li><li><p>⚠️ <strong>Copia subito il Client secret.</strong> Da aprile 2025 Google lo mostra <strong>una volta sola</strong>, alla creazione: dopo ne vedrai solo le ultime quattro cifre. Se lo perdi non si recupera — si ruota, e ruotarlo invalida la configurazione già in uso. Copia anche il <strong>Client ID</strong>, che invece resta sempre visibile.</p></li></ol><p>→ Hai <code>OAUTH_CLIENT_ID</code> e <code>OAUTH_CLIENT_SECRET</code>.</p><h2 id="_3-il-consenso-→-refresh-token" tabindex="-1">3. Il consenso → <code>REFRESH_TOKEN</code> <a class="header-anchor" href="#_3-il-consenso-→-refresh-token" aria-label="Permalink to &quot;3. Il consenso → `REFRESH_TOKEN`&quot;">​</a></h2><p>Il refresh token si ottiene con un consenso interattivo, una volta sola. Serve un browser <strong>e</strong> la casella.</p><ol start="11"><li><p>Apri <a href="https://developers.google.com/oauthplayground/" target="_blank" rel="noreferrer">OAuth 2.0 Playground</a>.</p></li><li><p>Clicca l&#39;<strong>ingranaggio</strong> in alto a destra e verifica questi tre campi. Sono già i valori di default, ma controllali: <strong>se <code>Access type</code> non è <code>Offline</code> non riceverai alcun refresh token</strong>, che è l&#39;unica cosa che ci serve.</p><table tabindex="0"><thead><tr><th>Campo</th><th>Valore</th></tr></thead><tbody><tr><td>OAuth flow</td><td><code>Server-side</code></td></tr><tr><td>Access type</td><td><code>Offline</code></td></tr><tr><td>Force prompt</td><td><code>Consent Screen</code></td></tr></tbody></table></li><li><p>Sempre nell&#39;ingranaggio, spunta <strong>Use your own OAuth credentials</strong> e incolla Client ID e Client secret.</p></li><li><p>Chiudi il pannello. In fondo all&#39;elenco delle API, nella colonna di sinistra, c&#39;è il campo <strong>«Input your own scopes»</strong>: scrivici <code>https://mail.google.com/</code>, con la barra finale.</p></li><li><p><strong>Authorize APIs</strong>. Si apre l&#39;accesso Google: <strong>entra con la casella</strong> che l&#39;ETL dovrà leggere, non con il tuo account né con un amministratore. Il consenso vale per l&#39;account che lo dà.</p></li><li><p>Accetta il consenso.</p></li><li><p>Nello <strong>Step 2</strong>, clicca <strong>Exchange authorization code for tokens</strong>.</p></li><li><p>Copia il valore del campo <strong>Refresh token</strong> (comincia con <code>1//</code>).</p></li></ol><p>→ Hai <code>OAUTH_REFRESH_TOKEN</code>.</p><blockquote><p>Il refresh token è una credenziale con la stessa forza della password della casella: non passa da chat, ticket o mail. Va direttamente nel <code>.env</code> della macchina che esegue il worker.</p></blockquote><h2 id="_4-pulizia" tabindex="-1">4. Pulizia <a class="header-anchor" href="#_4-pulizia" aria-label="Permalink to &quot;4. Pulizia&quot;">​</a></h2><ol start="19"><li>Nel Playground riapri l&#39;ingranaggio e <strong>svuota i campi Client ID e secret</strong>: li conserva nelle impostazioni del browser.</li><li>Facoltativo ma consigliato: torna sul client nella console e <strong>rimuovi il redirect URI del Playground</strong>. Il refresh token già ottenuto continua a funzionare — lo scambio con l&#39;access token non usa alcun redirect — quindi toglierlo non rompe niente. Se un giorno dovrai rifare il consenso, lo riaggiungi.</li></ol><h2 id="_5-la-configurazione" tabindex="-1">5. La configurazione <a class="header-anchor" href="#_5-la-configurazione" aria-label="Permalink to &quot;5. La configurazione&quot;">​</a></h2><p>Nel <code>.env</code> del worker, tre variabili per l&#39;identità e due righe per dire ai connettori di usarla:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># L&#39;identità OAuth2 (una per casella: legge e scrive con lo stesso consenso)</span></span>
23
+ <div id="app"><div class="Layout" data-v-22f0e4eb><!--[--><!--]--><!--[--><span tabindex="-1" data-v-3426c47a></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-3426c47a>Skip to content</a><!--]--><!----><header class="VPNav" data-v-22f0e4eb data-v-c0562b42><div class="VPNavBar" data-v-c0562b42 data-v-09e46d68><div class="wrapper" data-v-09e46d68><div class="container" data-v-09e46d68><div class="title" data-v-09e46d68><div class="VPNavBarTitle has-sidebar" data-v-09e46d68 data-v-373bba86><a class="title" href="/guida/core/" data-v-373bba86><!--[--><!--]--><!--[--><!--[--><!--[--><img class="VPImage dark logo" src="/guida/core/logo-light.png" alt="Noeva" data-v-b8fe04e5><!--]--><!--[--><img class="VPImage light logo" src="/guida/core/logo-dark.png" alt="Noeva" data-v-b8fe04e5><!--]--><!--]--><!--]--><!----><!--[--><!--[--><!--[--><!--[--><span class="etl-wordmark" aria-hidden="true">ETL</span><span class="etl-embedded-title">Documentazione</span><!--]--><!--]--><!--]--><!--]--></a></div></div><div class="content" data-v-09e46d68><div class="content-body" data-v-09e46d68><!--[--><!--]--><div class="VPNavBarSearch search" data-v-09e46d68><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Cerca nella documentazione"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Cerca</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-09e46d68 data-v-39d75b74><span id="main-nav-aria-label" class="visually-hidden" data-v-39d75b74> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/usare/" tabindex="0" data-v-39d75b74 data-v-d4ae6030><!--[--><span data-v-d4ae6030>Usare</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/claude-code/" tabindex="0" data-v-39d75b74 data-v-d4ae6030><!--[--><span data-v-d4ae6030>Creare con Claude Code</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-39d75b74 data-v-5d303cc7><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-5d303cc7><span class="text" data-v-5d303cc7><!----><span data-v-5d303cc7>Riferimento</span><span class="vpi-chevron-down text-icon" data-v-5d303cc7></span></span></button><div class="menu" data-v-5d303cc7><div class="VPMenu" data-v-5d303cc7 data-v-e79ccfeb><div class="items" data-v-e79ccfeb><!--[--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/guide/grafo" data-v-b2643254><!--[--><span data-v-b2643254>Il grafo, nodo per nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/nodes/README" data-v-b2643254><!--[--><span data-v-b2643254>Tipi di nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/connectors/README" data-v-b2643254><!--[--><span data-v-b2643254>Connettori</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/pipelines/README" data-v-b2643254><!--[--><span data-v-b2643254>Pipeline pronte</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/run-report" data-v-b2643254><!--[--><span data-v-b2643254>Il report di run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/run-trace" data-v-b2643254><!--[--><span data-v-b2643254>La traccia di una run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/variabili-del-core" data-v-b2643254><!--[--><span data-v-b2643254>Variabili d'ambiente del core</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/runbooks/graph-server" data-v-b2643254><!--[--><span data-v-b2643254>Operatività</span><!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-09e46d68 data-v-41033a42><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-41033a42 data-v-16571e93 data-v-3d2b146f><span class="check" data-v-3d2b146f><span class="icon" data-v-3d2b146f><!--[--><span class="vpi-sun sun" data-v-16571e93></span><span class="vpi-moon moon" data-v-16571e93></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-09e46d68 data-v-6ab99828 data-v-5d303cc7><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-5d303cc7><span class="vpi-more-horizontal icon" data-v-5d303cc7></span></button><div class="menu" data-v-5d303cc7><div class="VPMenu" data-v-5d303cc7 data-v-e79ccfeb><!----><!--[--><!--[--><!----><div class="group" data-v-6ab99828><div class="item appearance" data-v-6ab99828><p class="label" data-v-6ab99828>Tema</p><div class="appearance-action" data-v-6ab99828><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-6ab99828 data-v-16571e93 data-v-3d2b146f><span class="check" data-v-3d2b146f><span class="icon" data-v-3d2b146f><!--[--><span class="vpi-sun sun" data-v-16571e93></span><span class="vpi-moon moon" data-v-16571e93></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-09e46d68 data-v-91920283><span class="container" data-v-91920283><span class="top" data-v-91920283></span><span class="middle" data-v-91920283></span><span class="bottom" data-v-91920283></span></span></button></div></div></div></div><div class="divider" data-v-09e46d68><div class="divider-line" data-v-09e46d68></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-22f0e4eb data-v-caa5a72f><div class="container" data-v-caa5a72f><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-caa5a72f><span class="vpi-align-left menu-icon" data-v-caa5a72f></span><span class="menu-text" data-v-caa5a72f>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-caa5a72f data-v-731b3d50><button data-v-731b3d50>Torna su</button><!----></div></div></div><aside class="VPSidebar" data-v-22f0e4eb data-v-ac566ed2><div class="curtain" data-v-ac566ed2></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-ac566ed2><span class="visually-hidden" id="sidebar-aria-label" data-v-ac566ed2> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Usare Noeva ETL</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Come si usa</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/app-desktop" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>L'app desktop</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/esito-di-una-run" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Leggere l'esito di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/TECHNICAL_OVERVIEW" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Panoramica di prodotto</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Creare con Claude Code</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Dal bisogno al processo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/prompt" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Comporre il prompt</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/strumenti" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Skill e subagent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/GUIDA_SVILUPPO" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Guida allo sviluppo</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Concetti</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/grafo" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Il grafo, nodo per nodo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/run-report" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Il report di run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/run-trace" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>La traccia di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/versioni-di-pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Versioni di pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/node-descriptor" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Descriptor dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/node-columns" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Colonne dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/variabili-del-core" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Variabili d'ambiente del core</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Tipi di nodo</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Cheatsheet</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/action" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>action</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/ai" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>ai</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/join" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>join</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/lookup" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>lookup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/route" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>route</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/sink" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>sink</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/source" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>source</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/task" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>task</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/transform" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>transform</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/try-catch" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>try-catch</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/union" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>union</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Connettori</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Panoramica</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/excel" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Excel</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/file" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>File (storage × codec)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/http" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>HTTP (API REST per i nodi lookup e action)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/imap" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>IMAP (caselle di posta)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/jira" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/mysql" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>MySQL e MariaDB</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/noeva" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Noeva (file dei workspace)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/oauth" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>OAuth2 per i connettori</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/odoo" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Odoo (record di un modello, con i campi dichiarati)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/postgres" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>PostgreSQL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/process" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>processo esterno</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/sendgrid" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SendGrid (mail via API REST)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/smtp" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SMTP (notifiche email)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/sqlserver" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SQL Server</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/zoho" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Zoho CRM (record di un modulo, con i campi dichiarati)</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Pipeline pronte</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Le schede di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/analytics-snapshot" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>analytics-snapshot</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/test-posta" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>test-posta</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Esempi</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/sub-pipelines/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Le schede di una sub-pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/crm-leads-sync" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>crm-leads-sync</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/cross-workspace-csv-merge" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>cross-workspace-csv-merge</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/movimenti-per-conto" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>movimenti-per-conto</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/orders-enriched-daily" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>orders-enriched-daily</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/sub-pipelines/riepilogo-ordini" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>riepilogo-ordini</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed has-active" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Operatività</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/aggiornamento-pm2" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>aggiornare un deploy PM2 di un repo cliente</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/deploy-ecr" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>un cliente su ECR + ECS</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/deployment" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>distribuzione del runner ETL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/etl-worker" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>worker etl worker (polling su processes)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/excel-operazioni-distruttive" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>operazioni distruttive di excelSink</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/graph-server" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>server grafi etl serve (HTTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/mask-key" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>chiavi di mask (creazione, rotazione, compromissione)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/oauth-google-posta" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>OAuth2 per una casella Google (IMAP + SMTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/rollback-di-pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>rollback di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/scd2-rehash" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>rehash di una dimensione storicizzata</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/sql-task-truncate-swap" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>task SQL, truncate e scambio di tabelle</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/stato-incrementale" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>stato di pipeline e watermark</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-22f0e4eb data-v-0c4b08a9><div class="VPDoc has-sidebar has-aside" data-v-0c4b08a9 data-v-4f20312f><!--[--><!--]--><div class="container" data-v-4f20312f><div class="aside" data-v-4f20312f><div class="aside-curtain" data-v-4f20312f></div><div class="aside-container" data-v-4f20312f><div class="aside-content" data-v-4f20312f><div class="VPDocAside" data-v-4f20312f data-v-2db35001><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-2db35001 data-v-2f8395af><div class="content" data-v-2f8395af><div class="outline-marker" data-v-2f8395af></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-2f8395af>In questa pagina</div><ul class="VPDocOutlineItem root" data-v-2f8395af data-v-9c3b479d><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-2db35001></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-4f20312f><div class="content-container" data-v-4f20312f><!--[--><!--]--><main class="main" data-v-4f20312f><div style="position:relative;" class="vp-doc _guida_core_runbooks_oauth-google-posta" data-v-4f20312f><div><h1 id="runbook-oauth2-per-una-casella-google-imap-smtp" tabindex="-1">Runbook: OAuth2 per una casella Google (IMAP + SMTP) <a class="header-anchor" href="#runbook-oauth2-per-una-casella-google-imap-smtp" aria-label="Permalink to &quot;Runbook: OAuth2 per una casella Google (IMAP + SMTP)&quot;">​</a></h1><p>Come si ottiene il refresh token di una casella Gmail o Workspace, e come si configura l&#39;ETL per usarlo.</p><p>Serve quando IMAP risponde:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>IMAP connessione su imap.gmail.com: autenticazione rifiutata — NO [ALERT] ...</span></span></code></pre></div><p>Google ha tolto l&#39;accesso IMAP con la password dell&#39;account: una password normale viene rifiutata <strong>anche se è giusta</strong>. Restano due vie — una password per le app, oppure OAuth2. Questo runbook copre la seconda, l&#39;unica adatta a un servizio che deve girare da solo.</p><blockquote><p><strong>Chi lo esegue.</strong> Una persona sola, che abbia sia l&#39;accesso alla Google Cloud Console del dominio, sia la possibilità di accedere alla casella. Servono entrambe le cose nello stesso momento, e la seconda quasi sempre è del cliente. Conta 15–20 minuti.</p></blockquote><h2 id="_1-il-progetto-e-l-app" tabindex="-1">1. Il progetto e l&#39;app <a class="header-anchor" href="#_1-il-progetto-e-l-app" aria-label="Permalink to &quot;1. Il progetto e l&#39;app&quot;">​</a></h2><p>Una volta per casella, sulla <a href="https://console.cloud.google.com/" target="_blank" rel="noreferrer">Google Cloud Console</a>.</p><ol><li><p>Accedi con un account del dominio e, dal selettore in alto, usa un progetto esistente o creane uno nuovo (per esempio <code>noeva-etl-posta</code>).</p></li><li><p>Vai su <strong>Google Auth Platform</strong> (<code>console.cloud.google.com/auth/overview</code>). Se l&#39;app non è ancora registrata la console lo chiede adesso: è obbligatorio <strong>prima</strong> di poter creare un client. Compila nome dell&#39;app, email di supporto e contatto.</p></li><li><p><strong>Tipo di utente: <code>Internal</code>.</strong> È la scelta che conta, e va fatta ora perché cambiarla dopo invalida il lavoro. Vincola l&#39;app al vostro dominio, non richiede alcuna verifica da parte di Google per lo scope della posta — che è classificato <em>restricted</em> — ed evita la scadenza a sette giorni del refresh token, che colpisce solo le app <code>External</code> in stato <code>Testing</code>.</p><p>Lo verifichi nella pagina <strong>Audience</strong> (<code>console.cloud.google.com/auth/audience</code>): il campo <code>User type</code> deve dire <code>Internal</code>. <code>External</code> serve solo per una casella Gmail personale, e in quel caso devi anche portare <code>Publishing status</code> a <code>In production</code>, o il token ti muore dopo una settimana.</p></li><li><p><strong>Data access → aggiungi lo scope <code>https://mail.google.com/</code>.</strong> Uno solo: copre IMAP e SMTP insieme.</p></li></ol><h2 id="_2-il-client-→-client-id-e-client-secret" tabindex="-1">2. Il client → <code>CLIENT_ID</code> e <code>CLIENT_SECRET</code> <a class="header-anchor" href="#_2-il-client-→-client-id-e-client-secret" aria-label="Permalink to &quot;2. Il client → `CLIENT_ID` e `CLIENT_SECRET`&quot;">​</a></h2><ol start="5"><li><p><strong>Google Auth Platform → Clients</strong> (<code>console.cloud.google.com/auth/clients</code>) → <strong>CREATE CLIENT</strong>.</p></li><li><p><strong>Application type: <code>Web application</code>.</strong></p><p>⚠️ <strong>Non «Desktop app»</strong>, anche se il worker ETL è a tutti gli effetti un servizio. Serve un tipo di client su cui si possa dichiarare un redirect URI, e per i client Desktop la console — testualmente — «non richiede alcuna informazione aggiuntiva»: quel campo non esiste, e il passo 8 diventa impossibile.</p></li><li><p>Dai un nome al client (per esempio <code>noeva-etl</code>).</p></li><li><p>In <strong>Authorized redirect URIs</strong> → <strong>ADD URI</strong>, incolla esattamente, senza barra finale:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>https://developers.google.com/oauthplayground</span></span></code></pre></div></li><li><p><strong>CREATE</strong>.</p></li><li><p>⚠️ <strong>Copia subito il Client secret.</strong> Da aprile 2025 Google lo mostra <strong>una volta sola</strong>, alla creazione: dopo ne vedrai solo le ultime quattro cifre. Se lo perdi non si recupera — si ruota, e ruotarlo invalida la configurazione già in uso. Copia anche il <strong>Client ID</strong>, che invece resta sempre visibile.</p></li></ol><p>→ Hai <code>OAUTH_CLIENT_ID</code> e <code>OAUTH_CLIENT_SECRET</code>.</p><h2 id="_3-il-consenso-→-refresh-token" tabindex="-1">3. Il consenso → <code>REFRESH_TOKEN</code> <a class="header-anchor" href="#_3-il-consenso-→-refresh-token" aria-label="Permalink to &quot;3. Il consenso → `REFRESH_TOKEN`&quot;">​</a></h2><p>Il refresh token si ottiene con un consenso interattivo, una volta sola. Serve un browser <strong>e</strong> la casella.</p><ol start="11"><li><p>Apri <a href="https://developers.google.com/oauthplayground/" target="_blank" rel="noreferrer">OAuth 2.0 Playground</a>.</p></li><li><p>Clicca l&#39;<strong>ingranaggio</strong> in alto a destra e verifica questi tre campi. Sono già i valori di default, ma controllali: <strong>se <code>Access type</code> non è <code>Offline</code> non riceverai alcun refresh token</strong>, che è l&#39;unica cosa che ci serve.</p><table tabindex="0"><thead><tr><th>Campo</th><th>Valore</th></tr></thead><tbody><tr><td>OAuth flow</td><td><code>Server-side</code></td></tr><tr><td>Access type</td><td><code>Offline</code></td></tr><tr><td>Force prompt</td><td><code>Consent Screen</code></td></tr></tbody></table></li><li><p>Sempre nell&#39;ingranaggio, spunta <strong>Use your own OAuth credentials</strong> e incolla Client ID e Client secret.</p></li><li><p>Chiudi il pannello. In fondo all&#39;elenco delle API, nella colonna di sinistra, c&#39;è il campo <strong>«Input your own scopes»</strong>: scrivici <code>https://mail.google.com/</code>, con la barra finale.</p></li><li><p><strong>Authorize APIs</strong>. Si apre l&#39;accesso Google: <strong>entra con la casella</strong> che l&#39;ETL dovrà leggere, non con il tuo account né con un amministratore. Il consenso vale per l&#39;account che lo dà.</p></li><li><p>Accetta il consenso.</p></li><li><p>Nello <strong>Step 2</strong>, clicca <strong>Exchange authorization code for tokens</strong>.</p></li><li><p>Copia il valore del campo <strong>Refresh token</strong> (comincia con <code>1//</code>).</p></li></ol><p>→ Hai <code>OAUTH_REFRESH_TOKEN</code>.</p><blockquote><p>Il refresh token è una credenziale con la stessa forza della password della casella: non passa da chat, ticket o mail. Va direttamente nel <code>.env</code> della macchina che esegue il worker.</p></blockquote><h2 id="_4-pulizia" tabindex="-1">4. Pulizia <a class="header-anchor" href="#_4-pulizia" aria-label="Permalink to &quot;4. Pulizia&quot;">​</a></h2><ol start="19"><li>Nel Playground riapri l&#39;ingranaggio e <strong>svuota i campi Client ID e secret</strong>: li conserva nelle impostazioni del browser.</li><li>Facoltativo ma consigliato: torna sul client nella console e <strong>rimuovi il redirect URI del Playground</strong>. Il refresh token già ottenuto continua a funzionare — lo scambio con l&#39;access token non usa alcun redirect — quindi toglierlo non rompe niente. Se un giorno dovrai rifare il consenso, lo riaggiungi.</li></ol><h2 id="_5-la-configurazione" tabindex="-1">5. La configurazione <a class="header-anchor" href="#_5-la-configurazione" aria-label="Permalink to &quot;5. La configurazione&quot;">​</a></h2><p>Nel <code>.env</code> del worker, tre variabili per l&#39;identità e due righe per dire ai connettori di usarla:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># L&#39;identità OAuth2 (una per casella: legge e scrive con lo stesso consenso)</span></span>
24
24
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">OAUTH_CLIENT_ID</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">client</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> id</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> della</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> consol</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
25
25
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">OAUTH_CLIENT_SECRET</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">client</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> secret</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> della</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> consol</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
26
26
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">OAUTH_REFRESH_TOKEN</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">il</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> refresh</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> token</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> del</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> passo</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 1</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">8&gt;</span></span>
@@ -39,7 +39,7 @@
39
39
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">SMTP_SECURE</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">false</span></span>
40
40
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">SMTP_USER</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">la</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> casella</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;</span></span>
41
41
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">SMTP_FROM</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">mittente,</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> per</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> esempio:</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Noeva</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ETL</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">la-casell</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">a</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;&gt;</span></span></code></pre></div><p><code>IMAP_PASSWORD</code> e <code>SMTP_PASSWORD</code> vanno <strong>rimosse</strong>: <code>AUTH=oauth2</code> con una password ancora impostata è un errore di configurazione, e lo è di proposito — il metodo di autenticazione dev&#39;essere una scelta esplicita, non il risultato di quale variabile è rimasta. Non serve cancellare le righe: una variabile valorizzata a stringa vuota conta come assente.</p><p>⚠️ <strong><code>SMTP_USER</code> è obbligatoria e nessuno te lo dirà.</strong> Con <code>SMTP_AUTH=oauth2</code> ma senza <code>SMTP_USER</code>, la configurazione <strong>non fallisce</strong>: il connettore conclude che il server è un relay interno senza autenticazione e prova a inviare in chiaro. Te ne accorgi da Gmail che rifiuta l&#39;invio con un messaggio che non parla di OAuth. Su IMAP il problema non c&#39;è, <code>IMAP_USER</code> è sempre obbligatoria.</p><p><code>IMAP_OAUTH_INSTANCE</code> e <code>SMTP_OAUTH_INSTANCE</code> non servono finché l&#39;identità è una sola: entrambi valgono <code>default</code>. Servono con più caselle, insieme a <code>OAUTH_INSTANCES</code>.</p><h2 id="_6-la-verifica" tabindex="-1">6. La verifica <a class="header-anchor" href="#_6-la-verifica" aria-label="Permalink to &quot;6. La verifica&quot;">​</a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">pnpm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> etl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> test-posta</span></span></code></pre></div><p>È la pipeline che esiste per questo: esercita IMAP e SMTP e nient&#39;altro. Vedi <a href="./../pipelines/test-posta">la sua scheda</a>. Se la mail di riepilogo arriva, l&#39;identità funziona per entrambi i protocolli e puoi accendere la pipeline vera.</p><p>Se <code>extracted</code> è <code>0</code> la casella era vuota: IMAP si è collegato, ma di SMTP non sai ancora nulla. Serve almeno un messaggio nella cartella perché la prova sia completa.</p><h2 id="che-cosa-fa-morire-un-refresh-token" tabindex="-1">Che cosa fa morire un refresh token <a class="header-anchor" href="#che-cosa-fa-morire-un-refresh-token" aria-label="Permalink to &quot;Che cosa fa morire un refresh token&quot;">​</a></h2><p>Su un progetto Internal il token <strong>non scade da solo</strong>. Smette di funzionare per una di queste ragioni, e vale la pena conoscerle prima di incontrarle:</p><table tabindex="0"><thead><tr><th>Causa</th><th>Quanto è probabile</th></tr></thead><tbody><tr><td><strong>La password della casella è cambiata</strong></td><td>Alta, ed è quella che sorprende sempre. Lo scope <code>https://mail.google.com/</code> è un ambito Gmail, e Google invalida i token con ambiti Gmail a ogni cambio password. Nessuno collega «ho cambiato la password della posta» a «l&#39;ETL si è fermato»</td></tr><tr><td>Il consenso è stato revocato</td><td>Media. Succede dalle impostazioni di sicurezza dell&#39;account, anche per sbaglio, durante una pulizia delle app autorizzate</td></tr><tr><td>Un amministratore ha limitato il servizio nel dominio</td><td>Bassa, ma l&#39;errore lo dice (<code>admin_policy_enforced</code>)</td></tr><tr><td>Il token non è stato usato per sei mesi</td><td>Nulla su una pipeline schedulata; reale su un&#39;identità di prova lasciata lì</td></tr><tr><td>Superato il limite di 100 refresh token per account e client</td><td>Bassa. Rifare il consenso molte volte sullo stesso client invalida i più vecchi, silenziosamente</td></tr></tbody></table><p>In tutti i casi il rimedio è lo stesso — rifare i passi 11–18 — ma sapere quale dei cinque è stato cambia chi devi chiamare.</p><p>⚠️ <strong>Pratica utile:</strong> quando il cliente ha in programma un cambio password della casella, mettete in conto di rifare il consenso subito dopo. È l&#39;unico modo di non scoprirlo dal monitoraggio.</p><p><strong>Anche il client OAuth si autodistrugge se inutilizzato.</strong> Google cancella i client fermi da sei mesi, con un preavviso email trenta giorni prima all&#39;indirizzo di contatto del progetto. Per una pipeline schedulata è irrilevante, ma è un motivo per mettere al passo 2 un indirizzo che qualcuno legge davvero: è lo stesso canale da cui arriveranno gli avvisi che contano.</p><h2 id="guasti-e-che-cosa-vogliono-dire" tabindex="-1">Guasti, e che cosa vogliono dire <a class="header-anchor" href="#guasti-e-che-cosa-vogliono-dire" aria-label="Permalink to &quot;Guasti, e che cosa vogliono dire&quot;">​</a></h2><table tabindex="0"><thead><tr><th>Messaggio</th><th>Che cosa è successo</th></tr></thead><tbody><tr><td><code>OAuth2: refresh token rifiutato (invalid_grant)</code></td><td>Il token non è più valido: vedi la tabella delle cause qui sopra. Su Internal, per prima cosa chiedi se è cambiata la password della casella</td></tr><tr><td><code>OAuth2: il provider ha rifiutato la richiesta (invalid_client…)</code></td><td>Client ID o secret sbagliati, o di un altro progetto</td></tr><tr><td><code>OAuth2: il token endpoint non risponde</code></td><td>Rete, DNS, timeout, o un redirect rifiutato. Non è la configurazione: non rileggere il <code>.env</code></td></tr><tr><td><code>OAuth2: risposta del provider senza access_token utilizzabile</code></td><td>Il provider ha risposto 200 con un corpo che non contiene un token</td></tr><tr><td><code>autenticazione rifiutata — NO [ALERT] Application-specific password required</code></td><td>Sei ancora su <code>AUTH=password</code>: la riga <code>IMAP_AUTH=oauth2</code> manca</td></tr><tr><td><code>IMAP_AUTH=oauth2 con IMAP_PASSWORD impostata: togli la password</code></td><td>Hai aggiunto <code>AUTH=oauth2</code> ma la password è rimasta. Il metodo dev&#39;essere una scelta, non il residuo di una variabile</td></tr><tr><td><code>OAuth2 senza token: imposta IMAP_ACCESS_TOKEN…</code></td><td><code>AUTH=oauth2</code> ma il registry è vuoto: manca <code>OAUTH_CLIENT_ID</code></td></tr><tr><td><code>Identità OAuth2 &quot;…&quot; non configurata (disponibili: …)</code></td><td><code>IMAP_OAUTH_INSTANCE</code> o <code>SMTP_OAUTH_INSTANCE</code> nomina un id che non esiste — un refuso, o <code>OAUTH_INSTANCES</code> senza l&#39;istanza <code>default</code></td></tr></tbody></table><h2 id="rotazione" tabindex="-1">Rotazione <a class="header-anchor" href="#rotazione" aria-label="Permalink to &quot;Rotazione&quot;">​</a></h2><p>Il client secret e il refresh token si cambiano insieme, rifacendo i passi 5–18. Non c&#39;è nulla da invalidare lato ETL: il fornitore tiene il token in memoria per la durata della run, e la run successiva riparte dal <code>.env</code>.</p><p>Revocare il consenso dalla pagina <strong>Sicurezza → App di terze parti</strong> dell&#39;account Google invalida il refresh token immediatamente: la pipeline successiva fallirà con <code>invalid_grant</code>.</p><p>Lo stesso vale, senza che nessuno lo abbia chiesto, per un <strong>cambio password della casella</strong>: con gli ambiti Gmail il token muore con la vecchia password. Non c&#39;è modo di evitarlo — si può solo sapere che succede, e rifare il consenso subito invece di scoprirlo dal primo processo fallito.</p></div></div></main><footer class="VPDocFooter" data-v-4f20312f data-v-0be8676d><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-0be8676d><span class="visually-hidden" id="doc-footer-aria-label" data-v-0be8676d>Pager</span><div class="pager" data-v-0be8676d><a class="VPLink link pager-link prev" href="/guida/core/runbooks/mask-key" data-v-0be8676d><!--[--><span class="desc" data-v-0be8676d>Pagina precedente</span><span class="title" data-v-0be8676d>chiavi di mask (creazione, rotazione, compromissione)</span><!--]--></a></div><div class="pager" data-v-0be8676d><a class="VPLink link pager-link next" href="/guida/core/runbooks/rollback-di-pipeline" data-v-0be8676d><!--[--><span class="desc" data-v-0be8676d>Pagina successiva</span><span class="title" data-v-0be8676d>rollback di una pipeline</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-22f0e4eb data-v-331f077b><div class="container" data-v-331f077b><p class="message" data-v-331f077b>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-331f077b>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
42
- <script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_excel.md\":\"CqGtwEB4\",\"connectors_file.md\":\"Dbofo9W5\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_mysql.md\":\"fVCxQWUW\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"BeotXAWb\",\"connectors_odoo.md\":\"DprabV5e\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"B5QWzWUK\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"connectors_zoho.md\":\"BfEzRNZk\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"C19dB-Tb\",\"conventions_run-report.md\":\"iVSN9fNV\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"DJPSthZ8\",\"guida_sviluppo.md\":\"Bvr7RKHN\",\"guide_claude-code_index.md\":\"DEnzf9b_\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"DrJFsfOJ\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"BNAiSoJJ\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"C1S-lAh2\",\"nodes_source.md\":\"BitUNtug\",\"nodes_task.md\":\"CejEQZcD\",\"nodes_transform.md\":\"Ciycywnb\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"DrFr4blI\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"BV8Izw4I\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_excel-operazioni-distruttive.md\":\"CEygSROg\",\"runbooks_graph-server.md\":\"opGHnuzK\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"DAz41942\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"C6HYc5_h\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"Excel\",\"link\":\"/connectors/excel\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"MySQL e MariaDB\",\"link\":\"/connectors/mysql\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori\",\"link\":\"/connectors/oauth\"},{\"text\":\"Odoo (record di un modello, con i campi dichiarati)\",\"link\":\"/connectors/odoo\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"},{\"text\":\"Zoho CRM (record di un modulo, con i campi dichiarati)\",\"link\":\"/connectors/zoho\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"un cliente su ECR + ECS\",\"link\":\"/runbooks/deploy-ecr\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"operazioni distruttive di excelSink\",\"link\":\"/runbooks/excel-operazioni-distruttive\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
42
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_excel.md\":\"CqGtwEB4\",\"connectors_file.md\":\"Dbofo9W5\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_mysql.md\":\"fVCxQWUW\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"BeotXAWb\",\"connectors_odoo.md\":\"DprabV5e\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"B5QWzWUK\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"connectors_zoho.md\":\"BfEzRNZk\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"C19dB-Tb\",\"conventions_run-report.md\":\"iVSN9fNV\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"DJPSthZ8\",\"guida_sviluppo.md\":\"Bvr7RKHN\",\"guide_claude-code_index.md\":\"DEnzf9b_\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"DrJFsfOJ\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"BNAiSoJJ\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"C1S-lAh2\",\"nodes_source.md\":\"BitUNtug\",\"nodes_task.md\":\"CejEQZcD\",\"nodes_transform.md\":\"Ciycywnb\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_analytics-snapshot.md\":\"B8KfsjUs\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"DrFr4blI\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"BV8Izw4I\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_excel-operazioni-distruttive.md\":\"CEygSROg\",\"runbooks_graph-server.md\":\"opGHnuzK\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"DAz41942\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"C6HYc5_h\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"Excel\",\"link\":\"/connectors/excel\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"MySQL e MariaDB\",\"link\":\"/connectors/mysql\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori\",\"link\":\"/connectors/oauth\"},{\"text\":\"Odoo (record di un modello, con i campi dichiarati)\",\"link\":\"/connectors/odoo\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"},{\"text\":\"Zoho CRM (record di un modulo, con i campi dichiarati)\",\"link\":\"/connectors/zoho\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"analytics-snapshot\",\"link\":\"/pipelines/analytics-snapshot\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"un cliente su ECR + ECS\",\"link\":\"/runbooks/deploy-ecr\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"operazioni distruttive di excelSink\",\"link\":\"/runbooks/excel-operazioni-distruttive\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
43
43
 
44
44
  </body>
45
45
  </html>