Usar contêineres e Azure Filas Armazenamento de Blobs do Azure com a API de Migração do SharePoint

Use os Contêineres do Armazenamento de Blobs do Azure para armazenar conteúdo, arquivos de manifesto e logs. Acesse atualizações de status de migração com o Azure Filas.

Este guia fornece provisionamento, permissão e outros requisitos com recursos do Azure fornecidos pelo SharePoint.

Armazenamento de Blobs do Azure Contêineres

A API de migração usa contêineres do Armazenamento de Blobs do Azure para armazenamento temporário de conteúdo e manifesto. O SharePoint fornece contêineres padrão para migração. Como alternativa, você pode fornecer seus próprios contêineres.

Usando contêineres fornecidos pelo SharePoint

Os contêineres fornecidos pelo SharePoint não têm custo adicional para o cliente. Provisione contêineres fornecidos pelo SharePoint com ProvisionMigrationContainers método, sem a necessidade de configurá-los manualmente no console de administração do Azure.

A API de migração provisiona os contêineres no mesmo datacenter da instância do SharePoint. A API de migração usa um contêiner exclusivamente uma vez para cada solicitação, para garantir a segurança.

A API de migração destrói os contêineres usados de 30 a 90 dias após a conclusão dos trabalhos de migração.

Evite limitação decorando o tráfego

Evite limitação decorando seu tráfego HTTP.

Criptografia

O conteúdo armazenado em contêineres fornecidos pelo SharePoint é criptografado em repouso com AES256CBC algoritmo. Esta prática é obrigatória. A API de migração rejeita trabalhos de migração gerados a partir de contêineres não criptografados fornecidos pelo SharePoint.

Esse requisito de criptografia não se aplica a contêineres fornecidos pelo usuário.

Ao usar o CreateMigrationJobEncrypted método, criptografe cada arquivo com o padrão AES CBC 256 como algoritmo de criptografia.

Use o AesCryptoServiceProvider.GenerateIV método para gerar um IV criptograficamente aleatório exclusivo para cada arquivo, incluindo os manifestos no pacote. Armazene o IV como uma propriedade em cada arquivo.

Nome

IV

Valor

Uma BASE64 matriz de bytes codificada do IV gerado

Método ProvisionMigrationContainers

Provisiona novos contêineres de migração fornecidos pelo SharePoint para conteúdo e manifesto.

Sintaxe

public SPProvisionedMigrationContainersInfo ProvisionMigrationContainers()

Valores de retorno

Um SPProvisionedMigrationContainersInfo objeto que contém o URI, os tokens de acesso e a chave de criptografia dos contêineres provisionados.

Valor de DataContainerUri

Um valor de URI que contém o URI do contêiner recém-criado para armazenar o conteúdo de migração, juntamente com o token de acesso SAS.

Passe esse valor para o CreateMigrationJob método como azureContainerSourceUri parâmetro.

O token de acesso SAS contém Read apenas permissões e Write . Ele não contém List.

O SharePoint impõe conexões HTTPS a contêineres definindo spr=https o campo em tokens SAS.

Valor de MetadataContainer

Um valor de URI que contém o URI do contêiner recém-criado para armazenar arquivos de manifesto , juntamente com o token de acesso SAS.

Passe esse valor para o CreateMigrationJob método como azureContainerManifestUri parâmetro.

O token de acesso SAS contém Read apenas permissões e Write . Ele não contém List.

O SharePoint impõe conexões HTTPS a contêineres definindo spr=https o campo em tokens SAS.

EncryptionKey

Um valor de matriz de bytes contendo a chave de criptografia AES256CBC para ambos os contêineres provisionados.

Use seus próprios contêineres

Você também pode fornecer seu próprio Armazenamento de Blobs do Azure Contêineres. Forneça ao URI tokens de acesso SAS conforme necessário na referência da API de Migração.

Azure Filas

Os Azure Filas fornecidos pelo SharePoint não têm custo adicional para o cliente. Provisione a fila com ProvisionMigrationQueue o método, sem a necessidade de configurar manualmente no console de administração do Azure.

As disposições da API de migração Azure Filas no mesmo datacenter da instância do SharePoint.

Como alternativa, use Azure Filas fornecidos pelo usuário, se desejar. Verifique o requisito no documento de referência da API de migração.

Criptografia de Fila do Azure

CreateMigrationJobEncryptedcriptografa as mensagens gravadas na Fila do Azure.

Para descriptografar as mensagens, preserve JobId e os IV valores retornados pelo CreateMigrationJobEncrypted método.

Exemplo de mensagem criptografada

{"Label": "Encrypted"},
{"JobId": "[JobId value]"},
{"IV": "[IV value, encoded in BASE64]"},
{"Content": "[encrypted message, encoded in BASE64]"}

Método ProvisionMigrationQueue

Provisiona uma nova instância da Fila do Azure para uso na migração.

Sintaxe do ProvisionMigrationQueue

public SPProvisionedMigrationQueueInfo ProvisionMigrationQueue()

Valor de retorno

Um SPProvisionedMigrationQueueInfo objeto que contém as informações da Fila do Azure recém-criada.

Valor JobQueueUri

Um Uri valor que contém o token de acesso URI e SAS da Fila do Azure recém-criada.

Passe esse valor para o CreateMigrationJob parâmetro do azureQueueReportUri método.

Usar pontos de extremidade no Azure Governamental

Use os pontos de extremidade do Azure Governamental para o Microsoft 365 Government.

Pontos de extremidade necessários no Azure Governamental

• https://*.blob.core.usgovcloudapi.net
• https://*.queue.core.usgovcloudapi.net