Como configurar o seu próprio Azure Blob Storage para submissões de formulários PDF
Como alternativa a AWS S3, Scaleway Object Storage ou SharePoint, pode usar o seu Azure Blob Storage para armazenar documentos e documentos preenchidos.
Pode estar interessado em trazer o seu próprio armazenamento (BYOS) por diversas razões, como a conformidade com regras específicas do seu país ou setor, ou porque deseja manter a propriedade total dos seus dados.
#Como funciona o envio
Se está interessado no mecanismo geral de envio e no modelo de segurança, consulte aqui, onde cobrimos este mecanismo para o armazenamento compatível com S3. O Azure Blob Storage funciona de forma idêntica.
Em resumo, o envio acontece no browser, com o servidor apenas a trocar ligações de envio e transferência: os seus documentos nunca transitam pelos servidores do SimplePDF. Cada ligação é assinada pelo SimplePDF para um único ficheiro e expira em poucos minutos: as suas credenciais nunca fazem parte de uma ligação.
#Como configurar o seu próprio Azure Blob Storage
Configurar o seu próprio Azure Blob Storage está disponível com o plano PRO
O SimplePDF liga-se ao seu contentor através de uma Entra app (recomendada) ou de uma chave de conta. Com uma Entra app, decide exatamente o que o SimplePDF pode fazer num único contentor e pode revogar o acesso a qualquer momento sem mexer em mais nada.
#Preparar o contentor
-
No portal do Azure, abra a sua conta de armazenamento (pesquise «Storage accounts» na barra de pesquisa superior). O nome dela é o nome da conta pedido pelo SimplePDF.
-
Na barra lateral esquerda da conta de armazenamento, abra Data storage > Containers e clique em + Container para criar um (mantenha o nível de acesso Private), ou escolha um existente. O nome dele é o contentor pedido pelo SimplePDF.

- Na barra lateral esquerda, abra Settings > Resource sharing (CORS) e, no separador Blob service, permita
PUT(eGET, a menos que escolha o acesso só de escrita) de origens*.
Pode restringir ao portal da sua própria empresa se não quiser conceder origens *: https://seu_identificador.simplepdf.com

#Ligar-se com uma Entra app (recomendada)
-
Abra Microsoft Entra ID (pesquise-o na barra de pesquisa superior) e, na respetiva barra lateral esquerda, Manage > App registrations. Clique em New registration, atribua-lhe um nome (por exemplo
SimplePDF) e mantenha a opção predefinida de inquilino único (single tenant). Não é necessário nenhum URI de redirecionamento. -
Na Overview da app, copie o Directory (tenant) ID e o Application (client) ID.
-
Na barra lateral esquerda da app, abra Manage > Certificates & secrets e crie um New client secret: a opção de Expires que escolher (Recommended: 180 days, no máximo 24 meses) é a que voltará a escolher no SimplePDF. Copie o Value do segredo (não o Secret ID). A data de expiração continua visível na coluna Expires de Certificates & secrets > Client secrets.
-
Na conta de armazenamento, atribua a função Storage Blob Delegator à app. Esta função permite ao SimplePDF assinar ligações de curta duração e, por si só, não concede acesso aos seus dados:
Na barra lateral esquerda, abra Access control (IAM) e, depois, + Add > Add role assignment.
No separador Role, pesquise a função (aqui
Storage Blob Delegator), selecione-a e clique em Next.
No separador Members, mantenha User, group, or service principal, clique em + Select members, pesquise o nome da sua app (por exemplo
SimplePDF), selecione-a e clique em Select.
A app só aparece na lista depois de escrever o respetivo nome exato na caixa de pesquisa: inicialmente, a lista mostra utilizadores, e um nome parcial não encontra a app.
Clique em Review + assign.
- Atribua à app a respetiva função de dados no próprio contentor (não na conta de armazenamento), para que só aceda a este contentor:
Na barra lateral esquerda da conta de armazenamento, abra Data storage > Containers e clique no nome do seu contentor.
Na barra lateral esquerda do próprio contentor, abra Access control (IAM), depois + Add > Add role assignment, e atribua à app uma das funções abaixo, da mesma forma que no passo 4:
Leitura e escrita: a função integrada Storage Blob Data Contributor.
Só escrita: a função personalizada
SimplePDF write-only, criada conforme descrito em Acesso só de escrita.
- Aguarde alguns minutos até que as atribuições de funções sejam aplicadas e, depois, continue no SimplePDF: No SimplePDF, com Entra app como Credentials type.
#Acesso só de escrita
O acesso só de escrita utiliza uma função personalizada que pode criar e substituir ficheiros, mas não os pode ler, listar nem eliminar. Crie-a uma vez:
-
Abra a sua subscrição (pesquise «Subscriptions» na barra de pesquisa superior) e copie o respetivo Subscription ID a partir da Overview.
-
Na barra lateral esquerda da subscrição, abra Access control (IAM) e, depois, + Add > Add custom role. No separador JSON, clique em Edit, substitua o conteúdo pelo JSON abaixo (com o ID da sua subscrição), clique em Save e, depois, em 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": []
}
]
}
}
- Atribua-a à sua app no contentor, como no passo 5 de Ligar-se com uma Entra app, pesquisando
SimplePDF write-only.
#Ou ligar-se com uma chave de conta
Obtenha uma chave de conta na vista Security + Networking > Access keys da conta de armazenamento. O SimplePDF utiliza-a para assinar uma ligação de curta duração para cada ficheiro; a chave em si nunca faz parte de uma ligação. Uma chave de conta dá acesso a toda a conta de armazenamento e não pode ser limitada a só escrita: se isso for importante para si, prefira uma Entra app.

#No SimplePDF
- Inicie sessão na sua conta
- Navegue para a vista de definições da conta:
-
Clique em
Atualizar configuração -
Selecione
Azure Blob Storagecomo tipo de armazenamento, selecione o Credentials type e preencha os detalhes:
Endpoint: https://<NOME_DA_SUA_CONTA_DE_ARMAZENAMENTO>.blob.core.windows.net, o endpoint Blob service na barra lateral esquerda da conta de armazenamento, Settings > Endpoints
Container: nome do seu contentor, na barra lateral esquerda da conta de armazenamento, Data storage > Containers
Account Name: nome da sua conta de armazenamento. Corresponde ao nome da conta no endpoint acima.
Credentials type: Entra app
Directory (tenant) ID, Application (client) ID e Client secret: copiados da sua Entra app nos passos 2 e 3.
Validade do client secret: a opção de Expires que escolheu ao criar o segredo (se escolheu uma data personalizada no Entra, escolha a duração imediatamente inferior). O SimplePDF envia-lhe um e-mail 30, 7 e 1 dia antes de expirar: crie um novo segredo na sua Entra app e, depois, atualize-o aqui.
Apenas permissões de escrita: assinale esta caixa se atribuiu a função só de escrita. O SimplePDF verifica a função ao guardar: se a app ainda conseguir ler o contentor, a configuração é recusada até remover o acesso de leitura ou desmarcar a caixa.
Credentials type: Account Key
Account Key: obtida na vista Access keys da conta de armazenamento.

- Clique em
Atualizar
#Tokens SAS
Os tokens SAS já não são aceites em novas ligações: um token SAS não consegue assinar as ligações de curta duração, para um único ficheiro, que o SimplePDF entrega ao browser, pelo que o próprio token é partilhado com as pessoas que submetem os seus formulários.
Se a sua organização já se ligou com um token SAS, pode mantê-lo desde que só possa criar ou substituir ficheiros: gere-o no contentor apenas com as permissões Create e Write (sem Read, List nem Delete). O SimplePDF recusa um token mais abrangente ao guardar. Recomendamos que volte a ligar-se com uma Entra app (ver acima) e, em seguida, regenere a chave da conta de armazenamento que assinou o seu token SAS para o invalidar.
E pronto! Os seus documentos e submissões são agora automaticamente armazenados no seu próprio contentor Azure Blob Storage.
Se tiver alguma questão, não hesite em contactar support@simplepdf.com