Come configurare il tuo Azure Blob Storage per gli invii dei moduli PDF
Come alternativa ad AWS S3, Scaleway Object Storage o SharePoint, puoi usare il tuo Azure Blob Storage per archiviare documenti e documenti compilati.
Potresti voler portare il tuo storage (BYOS) per vari motivi, come la conformità a regole specifiche del tuo paese o settore, oppure perché desideri mantenere la piena proprietà dei tuoi dati.
#Come funziona il caricamento
Se ti interessa il meccanismo generale di caricamento e il modello di sicurezza, vai qui, dove trattiamo questo meccanismo per lo storage S3-compatibile. Azure Blob Storage funziona in modo identico.
In sintesi, il caricamento avviene nel browser e il server scambia solo link di upload e download: i tuoi documenti non transitano mai attraverso i server di SimplePDF. Ogni link è firmato da SimplePDF per un singolo file e scade entro pochi minuti: le tue credenziali non fanno mai parte di un link.
#Come configurare il tuo Azure Blob Storage
La configurazione del proprio Azure Blob Storage è disponibile con il piano PRO
SimplePDF si connette al tuo container tramite una Entra app (consigliata) o una chiave dell'account. Con una Entra app decidi esattamente cosa può fare SimplePDF su un singolo container e puoi revocarne l'accesso in qualsiasi momento senza toccare nient'altro.
#Preparare il container
-
Nel portale di Azure, apri il tuo account di storage (cerca «Storage accounts» nella barra di ricerca in alto). Il suo nome è il nome dell'account richiesto da SimplePDF.
-
Nella barra laterale sinistra dell'account di storage, apri Data storage > Containers, poi fai clic su + Container per crearne uno (mantieni il livello di accesso Private), oppure scegline uno esistente. Il suo nome è il container richiesto da SimplePDF.

- Nella barra laterale sinistra, apri Settings > Resource sharing (CORS) e, nella scheda Blob service, consenti
PUT(eGET, a meno che tu non scelga l'accesso in sola scrittura) dalle origini*.
Puoi restringerla al portale della tua azienda se non vuoi consentire le origini *: https://tuo_identificativo.simplepdf.com

#Connettiti con una Entra app (consigliata)
-
Apri Microsoft Entra ID (cercalo nella barra di ricerca in alto) e, nella sua barra laterale sinistra, Manage > App registrations. Fai clic su New registration, assegna un nome (ad esempio
SimplePDF) e mantieni l'opzione predefinita a tenant singolo (single tenant). Non serve alcun URI di reindirizzamento. -
Nella Overview dell'app, copia il Directory (tenant) ID e l'Application (client) ID.
-
Nella barra laterale sinistra dell'app, apri Manage > Certificates & secrets e crea un New client secret: la durata scelta in Expires (Recommended: 180 days, al massimo 24 mesi) è quella da scegliere di nuovo in SimplePDF. Copia il Value del secret (non il Secret ID). La data di scadenza resta visibile nella colonna Expires di Certificates & secrets > Client secrets.
-
Nell'account di storage, assegna all'app il ruolo Storage Blob Delegator. Consente a SimplePDF di firmare link di breve durata e, da solo, non concede alcun accesso ai tuoi dati:
Nella barra laterale sinistra, apri Access control (IAM), poi + Add > Add role assignment.
Nella scheda Role, cerca il ruolo (qui
Storage Blob Delegator), selezionalo e fai clic su Next.
Nella scheda Members, mantieni User, group, or service principal, fai clic su + Select members, cerca il nome della tua app (ad esempio
SimplePDF), selezionala e fai clic su Select.
L'app non compare finché non ne digiti il nome esatto nella casella di ricerca: all'inizio l'elenco mostra gli utenti, e un nome parziale non trova l'app.
Fai clic su Review + assign.
- Assegna all'app il suo ruolo sui dati direttamente sul container (non sull'account di storage), così che raggiunga solo questo container:
Nella barra laterale sinistra dell'account di storage, apri Data storage > Containers e fai clic sul nome del tuo container.
Nella barra laterale sinistra del container stesso, apri Access control (IAM), poi + Add > Add role assignment, e assegna all'app uno dei ruoli qui sotto, come nel passaggio 4:
Lettura e scrittura: il ruolo predefinito Storage Blob Data Contributor.
Sola scrittura: il ruolo personalizzato
SimplePDF write-only, creato come descritto in Accesso in sola scrittura.
- Attendi qualche minuto che le assegnazioni di ruolo vengano applicate, poi continua in SimplePDF: In SimplePDF, con Entra app come Credentials type.
#Accesso in sola scrittura
L'accesso in sola scrittura usa un ruolo personalizzato che può creare e sovrascrivere file, ma non leggerli, elencarli o eliminarli. Crealo una volta:
-
Apri la tua sottoscrizione (cerca «Subscriptions» nella barra di ricerca in alto) e copiane il Subscription ID dalla Overview.
-
Nella barra laterale sinistra della sottoscrizione, apri Access control (IAM), poi + Add > Add custom role. Nella scheda JSON, fai clic su Edit, sostituisci il contenuto con il JSON qui sotto (con il tuo ID di sottoscrizione), fai clic su Save, poi su Review + create e Create.
{
"properties": {
"roleName": "SimplePDF write-only",
"description": "Lets SimplePDF upload documents without reading, listing or deleting them",
"assignableScopes": ["/subscriptions/<YOUR_SUBSCRIPTION_ID>"],
"permissions": [
{
"actions": [],
"notActions": [],
"dataActions": [
"Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write",
"Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action"
],
"notDataActions": []
}
]
}
}
- Assegnalo alla tua app sul container, come nel passaggio 5 di Connettiti con una Entra app, cercando
SimplePDF write-only.
#Oppure connettiti con una chiave dell'account
Recupera una chiave dell'account nella vista Security + Networking > Access keys dell'account di storage. SimplePDF la usa per firmare un link di breve durata per ogni file; la chiave stessa non fa mai parte di un link. Una chiave dell'account dà accesso all'intero account di storage e non può essere limitata alla sola scrittura: se per te è importante, preferisci una Entra app.

#In SimplePDF
- Accedi al tuo account
- Vai alla vista delle impostazioni dell'account:
-
Fai clic su
Aggiorna configurazione -
Seleziona
Azure Blob Storagecome tipo di archivio, seleziona il Credentials type e compila i dettagli:
Endpoint: https://<NOME_DEL_TUO_STORAGE_ACCOUNT>.blob.core.windows.net, l'endpoint Blob service nella barra laterale sinistra dell'account di storage, Settings > Endpoints
Container: nome del tuo container, nella barra laterale sinistra dell'account di storage, Data storage > Containers
Account Name: nome del tuo account di storage. Corrisponde al nome dell'account nell'endpoint sopra.
Credentials type: Entra app
Directory (tenant) ID, Application (client) ID e Client secret: copiati dalla tua Entra app nei passaggi 2 e 3.
Scadenza del client secret: la durata scelta in Expires quando hai creato il secret (se in Entra hai scelto una data personalizzata, scegli la durata immediatamente più breve). SimplePDF ti invia un'e-mail 30, 7 e 1 giorno prima della scadenza: crea un nuovo secret nella tua Entra app, poi aggiornalo qui.
Solo permessi di scrittura: seleziona questa casella se hai assegnato il ruolo di sola scrittura. SimplePDF verifica il ruolo al salvataggio: se l'app può ancora leggere il container, la configurazione viene rifiutata finché non rimuovi l'accesso in lettura o deselezioni la casella.
Credentials type: Account Key
Account Key: recuperata dalla vista Access keys dell'account di storage.

- Fai clic su
Aggiorna
#Token SAS
I token SAS non sono più accettati per le nuove connessioni: un token SAS non può firmare i link di breve durata, validi per un singolo file, che SimplePDF fornisce al browser, quindi il token stesso viene condiviso con le persone che inviano i tuoi moduli.
Se la tua organizzazione si è già connessa con un token SAS, puoi mantenerlo purché possa solo creare o sovrascrivere file: generalo sul container solo con i permessi Create e Write (senza Read, List o Delete). SimplePDF rifiuta al salvataggio un token con permessi più ampi. Ti consigliamo di riconnetterti con una Entra app (vedi sopra), poi di rigenerare la chiave dell'account di storage che ha firmato il tuo token SAS per invalidarlo.
Ecco fatto! I tuoi documenti e i tuoi invii sono ora archiviati automaticamente nel tuo container Azure Blob Storage.
Se hai domande, non esitare a contattarci all'indirizzo support@simplepdf.com