Como configurar o seu próprio Azure Blob Storage para submissões de formulários PDF

Os documentos seguem do editor SimplePDF diretamente para o seu próprio contentor Azure Blob Storage, sem passar pela infraestrutura do SimplePDF

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

  1. 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.

  2. 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.

Vista de contentores do Azure Blob Storage

  1. Na barra lateral esquerda, abra Settings > Resource sharing (CORS) e, no separador Blob service, permita PUT (e GET, 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

Vista CORS do Azure Blob Storage

#Ligar-se com uma Entra app (recomendada)

  1. 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.

  2. Na Overview da app, copie o Directory (tenant) ID e o Application (client) ID.

  3. 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.

  4. 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.

  1. 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.

  1. 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:

  1. Abra a sua subscrição (pesquise «Subscriptions» na barra de pesquisa superior) e copie o respetivo Subscription ID a partir da Overview.

  2. 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": []
      }
    ]
  }
}
  1. 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.

Vista de credenciais de acesso do Azure Blob Storage

#No SimplePDF

  1. Inicie sessão na sua conta
  2. Navegue para a vista de definições da conta:

Configuração do Azure Blob Storage na vista da conta

  1. Clique em Atualizar configuração

  2. Selecione Azure Blob Storage como 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.

Configuração do Azure Blob Storage: detalhes de configuração

  1. 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

O que é o SimplePDF?

É possível personalizar o editor do SimplePDF?

O SimplePDF está em conformidade com HIPAA?

Quais setores beneficiam mais do SimplePDF?

O SimplePDF é para mim?

Pronto para começar?

Continue a usar os PDF que já tem. Todos os planos pagos começam com uma avaliação gratuita de 7 dias.

Iniciar período de teste gratuito