Come configurare il tuo bucket S3 per le compilazioni dei moduli PDF

Benjamin André-Micolon

Nota: Usi Azure Blob Storage? Consulta la nostra guida alla configurazione di Azure Blob Storage. Usi SharePoint? Consulta la nostra guida alla configurazione di SharePoint.

Quando i tuoi clienti modificano e compilano un documento usando SimplePDF nel tuo portale o l'editor integrato collegato al tuo portale, il documento e le compilazioni vengono salvati in modo sicuro sullo storage di SimplePDF (bucket S3).

Tuttavia, per vari motivi, come la conformità a regole specifiche del tuo paese o settore, potresti voler salvare questi documenti nel tuo storage.

Come funziona il caricamento

Puoi passare alla sezione successiva per vedere come configurare il tuo bucket S3

Rivediamo brevemente il flusso del caricamento. Questo vale per tutti i provider di archiviazione (S3, Azure Blob Storage e SharePoint):

  ( User Device )        ( SimplePDF )          ( Cloud Storage )        ( Customer Server )
┌─────────────┐        ┌─────────────┐        ┌─────────────────┐       ┌──────────────────┐
│             │        │             │        │                 │       │                  │
│   Browser   │        │  SimplePDF  │        │ Customer Storage│       │ Customer Backend │
│  (Editor)   │        │   Server    │        │ S3/Azure/SharePt│       │   (webhook)      │
│             │        │             │        │                 │       │                  │
└──────┬──────┘        └──────┬──────┘        └────────┬────────┘       └────────┬─────────┘
       │                      │                        │                         │
       │  1. Request URL      │                        │                         │
       │ ───────────────────> │                        │                         │
       │                      │                        │                         │
       │  2. URL / session    │                        │                         │
       │ <─────────────────── │                        │                         │
       │                      │                        │                         │
       │  3. Direct upload (no data touches SimplePDF) │                         │
       │ ────────────────────────────────────────────> │                         │
       │                      │                        │                         │
       │  4. Upload confirmed │                        │                         │
       │ ───────────────────> │                        │                         │
       │                      │                        │                         │
       │                      │  5. Webhook (optional) │                         │
       │                      │ ─────────────────────────────────────────────── >│
       │                      │                        │                         │

  ───────────>  API call (metadata only, no document data)
  ────────────────────────────────────>  Direct file transfer (bypasses SimplePDF)

Poiché la sicurezza e la privacy sono fondamentali per noi, vogliamo sottolineare un paio di aspetti sul flusso di caricamento:

• Il server di SimplePDF non vede mai il documento: il caricamento (passaggio 3) va direttamente dal browser al tuo spazio di archiviazione.
• Gli URL di caricamento e download sono a breve durata e pre-firmati con le tue credenziali di archiviazione.

Come configurare il tuo bucket S3

La configurazione del proprio bucket S3 è disponibile con il piano PRO

In SimplePDF

1. Accedi al tuo account
2. Vai alla vista delle impostazioni dell'account:

3. Fai clic su Update configuration

4. Inserisci i dettagli del tuo bucket S3:

Specifica https://s3.amazonaws.com per l'endpoint se usi le richieste in stile Virtual-hosted

5. Fai clic su Update

Configurazione CORS nel tuo bucket S3

1. Consenti i seguenti header:

• x-amz-acl
• Content-Type

2. Consenti i seguenti metodi:

• GET
• PUT

3. Consenti la seguente origine:

• *

Puoi restringerla al portale della tua azienda se non vuoi consentire l'accesso a tutte le origini (*): https://tuo_identificativo.simplepdf.com.

Permessi richiesti sul tuo bucket S3

• s3:GetObject: per visualizzare i documenti e le compilazioni nell'interfaccia e per l'invio dei webhook
• s3:PutObject: per caricare i documenti e le compilazioni
• s3:DeleteObject: per eliminare i documenti e le compilazioni caricati

Ecco fatto! I tuoi documenti e le compilazioni sono ora archiviati automaticamente nel tuo bucket S3!

Se hai domande, non esitare a contattarci all'indirizzo support@simplepdf.com