Criar um aplicativo gerenciado para armazenar resumos de Blob

Pré-requisitos

• Uma Conta de Armazenamento do Azure
• CLI do Azure (opcional)
• Versão do Python suportada pelo SDK do Azure para Python (opcional)

Descrição geral

O Blob Storage Digest Backed by Confidential Ledger Managed Application pode ser usado para garantir que os blobs dentro de um contêiner de blob sejam confiáveis e não adulterados. O aplicativo, uma vez conectado a uma conta de armazenamento, rastreia todos os blobs que estão sendo adicionados a cada contêiner na conta de armazenamento em tempo real, além de calcular e armazenar os resumos no Razão Confidencial do Azure. As auditorias podem ser realizadas a qualquer momento para verificar a validade dos blobs e garantir que o contêiner de blob não seja adulterado.

Implantando o aplicativo gerenciado

O Aplicativo Gerenciado pode ser encontrado no Azure Marketplace aqui: Blob Storage Digests Backed by Confidential Ledger (visualização).

Recursos a criar

Depois que os campos obrigatórios são preenchidos e o aplicativo é implantado, os seguintes recursos são criados em um Grupo de Recursos Gerenciados:

• Contabilidade confidencial
• Fila do Barramento de Serviço com Sessões ativadas
• Conta de armazenamento (conta de armazenamento de propriedade do editor usada para armazenar lógica de resumo e histórico de auditoria)
• Aplicação de Funções
• Application Insights

Conectando uma conta de armazenamento ao aplicativo gerenciado

Depois que um Aplicativo Gerenciado for criado, você poderá conectar o Aplicativo Gerenciado à sua Conta de Armazenamento para começar a processar e gravar resumos do Contêiner de Blob no Razão Confidencial do Azure.

Criar uma assinatura de tópico e evento para a conta de armazenamento

O Aplicativo Gerenciado usa uma Fila do Barramento de Serviço do Azure para controlar e registrar todos os eventos Criar Blob . Você usará a Fila criada no Grupo de Recursos Gerenciados pelo Aplicativo Gerenciado e a adicionará como Assinante de Eventos para qualquer conta de armazenamento para a qual esteja criando blobs.

Portal do Azure

No portal do Azure, você pode navegar até a conta de armazenamento para a qual gostaria de começar a criar resumos de blob e ir para a Events folha. Lá, você pode criar uma Assinatura de Evento e conectá-la ao Ponto de Extremidade da Fila do Barramento de Serviço do Azure.

A fila usa sessões para manter o pedido em várias contas de armazenamento, portanto, você também precisará navegar até a Delivery Properties guia e inserir um ID de sessão exclusivo para essa assinatura de evento.

CLI

Criando o tópico do evento:

az eventgrid system-topic create \
--resource-group {resource_group} \
--name {sample_topic_name} \
--location {location} \
--topic-type microsoft.storage.storageaccounts \
--source /subscriptions/{subscription}/resourceGroups/{resource_group}/providers/Microsoft.Storage/storageAccounts/{storage_account_name}

resource-group - Grupo de Recursos de onde o Tópico deve ser criado

name - Nome do Tópico a ser criado

location - Localização do Tópico a ser criado

source - ID de recurso da conta de armazenamento para criar tópico para

Criando a assinatura do evento:

az eventgrid system-topic event-subscription create \
--name {sample_subscription_name} \
--system-topic-name {sample_topic_name} \
--resource-group {resource_group} \
--event-delivery-schema EventGridSchema \
--included-event-types Microsoft.Storage.BlobCreated \
--delivery-attribute-mapping sessionId static {sample_session_id} false \
--endpoint-type servicebusqueue \
--endpoint /subscriptions/{subscription}/resourceGroups/{managed_resource_group}/providers/Microsoft.ServiceBus/namespaces/{service_bus_namespace}/queues/{service_bus_queue}

name - Nome da Subscrição a criar

system-topic-name - Nome do tópico para o qual a assinatura está sendo criada (deve ser o mesmo que o tópico recém-criado)

resource-group - Grupo de Recursos de onde a Subscrição deve ser criada

delivery-attribute-mapping - Mapeamento para o campo sessionId necessário. Insira um sessionId exclusivo

endpoint - ID do recurso da fila do barramento de serviço que está assinando a conta de armazenamento Tópico

Adicionar a função necessária à conta de armazenamento

O Aplicativo Gerenciado requer que a função leia e crie hashes para cada blob e essa função precisa ser adicionada para que Storage Blob Data Owner o resumo seja calculado corretamente.

Portal do Azure

CLI

az role assignment create \
--role "Storage Blob Data Owner" \
--assignee-object-id {function_oid} \
--assignee-principal-type ServicePrincipal\
--scope /subscriptions/{subscription}/resourceGroups/{resource_group}/providers/Microsoft.Storage/storageAccounts/{storage_account_name}

assignee-object-id - OID da Função Azure criada com a Aplicação Gerida. Pode ser encontrado sob a folha 'Identidade'

scope - ID de recurso da conta de armazenamento para criar a função para

Nota

Várias contas de armazenamento podem ser conectadas a uma única instância de aplicativo gerenciado. Atualmente, recomendamos um máximo de 10 contas de armazenamento que contenham contêineres de blob de alto uso.

Adicionando blobs e criação de resumos

Quando a conta de armazenamento estiver conectada corretamente ao Aplicativo Gerenciado, os blobs poderão começar a ser adicionados aos contêineres dentro da conta de armazenamento. Os blobs são rastreados em tempo real e os resumos são calculados e armazenados no Razão Confidencial do Azure.

Tabelas de transações e blocos

Todos os eventos de criação de blob são rastreados em tabelas internas armazenadas no Aplicativo Gerenciado.

A tabela de transações contém informações sobre cada blob e um hash exclusivo que é gerado usando uma combinação de metadados e conteúdo do blob.

A tabela de blocos contém informações relacionadas a cada resumo criado para o contêiner de blob e a ID de transação associada para o resumo é armazenada no Razão Confidencial do Azure.

Nota

Cada evento de criação de blob não resultará na criação de um resumo. Os resumos são criados depois que um determinado tamanho de bloco é atingido. Atualmente, um resumo será criado para cada 4 eventos de criação de blobs.

Exibindo resumo no Razão Confidencial do Azure

Você pode exibir os resumos que estão sendo armazenados diretamente no Razão Confidencial do Azure navegando até a Ledger Explorer folha.

Realização de uma auditoria

Se você quiser verificar a validade dos blobs adicionados a um contêiner para garantir que eles não sejam adulterados, uma auditoria pode ser executada a qualquer momento. A auditoria reproduz cada evento de criação de blob e recalcula os resumos com os blobs armazenados no contêiner durante a auditoria. Em seguida, ele compara os resumos recalculados com os resumos armazenados no Azure Confidential e fornece um relatório exibindo todas as comparações de resumo e se o contêiner de blob foi violado ou não.

Acionar uma auditoria

Uma auditoria pode ser acionada incluindo a seguinte mensagem para a fila do Service Bus associada ao seu aplicativo gerenciado:

{
    "eventType": "PerformAudit",
    "storageAccount": "<storage_account_name>",
    "blobContainer": "<blob_container_name>"
}

Portal do Azure

Certifique-se de incluir um, Session ID pois a fila tem sessões habilitadas.

Python SDK

import json
import uuid
from azure.servicebus import ServiceBusClient, ServiceBusMessage

SERVICE_BUS_CONNECTION_STR = "<service_bus_connection_string>"
QUEUE_NAME = "<service_bus_queue_name>"
STORAGE_ACCOUNT_NAME = "<storage_account_name>"
BLOB_CONTAINER_NAME = "<blob_container_name>"
SESSION_ID = str(uuid.uuid4())

servicebus_client = ServiceBusClient.from_connection_string(conn_str=SERVICE_BUS_CONNECTION_STR, logging_enable=True)
sender = servicebus_client.get_queue_sender(queue_name=QUEUE_NAME)

message = {
    "eventType": "PerformAudit",
    "storageAccount": STORAGE_ACCOUNT_NAME,
    "blobContainer": BLOB_CONTAINER_NAME
}

message = ServiceBusMessage(json.dumps(message), session_id=SESSION_ID)
sender.send_messages(message)

Visualizar os resultados da auditoria

Quando uma auditoria é executada com êxito, os resultados da auditoria podem ser encontrados em um contêiner chamado <managed-application-name>-audit-records encontrado na respetiva conta de armazenamento. Os resultados contêm o resumo recalculado, o resumo recuperado do Razão Confidencial do Azure e se os blobs foram ou não adulterados.

Registo e erros

Os logs de erros podem ser encontrados em um contêiner chamado <managed-application-name>-error-logs encontrado na respetiva conta de armazenamento. Se um evento de criação de blob ou processo de auditoria falhar, a causa da falha será registrada e armazenada nesse contêiner. Se houver dúvidas sobre os logs de erro ou a funcionalidade do aplicativo, entre em contato com a equipe de Suporte do Livro-razão Confidencial do Azure fornecida nos detalhes do Aplicativo Gerenciado.

Limpar aplicativo gerenciado

Você pode excluir o Aplicativo Gerenciado para limpar e remover todos os recursos associados. A exclusão do Aplicativo Gerenciado impede que todas as transações de blob sejam rastreadas e interrompe a criação de todos os resumos. Os relatórios de auditoria permanecem válidos para os blobs que foram adicionados antes da exclusão.

Mais recursos

Para obter mais informações sobre aplicativos gerenciados e os recursos implantados, consulte os seguintes links:

• Aplicações Geridas
• Sessões de fila de serviço do Azure
• Eventos de Armazenamento do Azure

Próximos passos

• Visão geral da contabilidade confidencial do Microsoft Azure