Teste de carga de pontos de extremidade protegidos com o Teste de Carga do Azure

Neste artigo, você aprenderá a usar o Teste de Carga do Azure com os pontos de extremidade do aplicativo que exigem autenticação. Dependendo da implementação do aplicativo, você pode usar um token de acesso, credenciais de usuário ou certificados do cliente para autenticar as solicitações.

O Teste de Carga do Azure dá suporte às seguintes opções para pontos de extremidade autenticados:

• Autenticar com um segredo compartilhado ou credenciais de usuário
• Autenticar com os certificados do cliente

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
• Um recurso de teste de carga do Azure. Para criar um recurso de teste de carga, consulte Criar e executar um teste de carga.

Autenticar com um segredo compartilhado ou credenciais

Nesse cenário, o ponto de extremidade do aplicativo exige que você use um segredo compartilhado, como um token de acesso, uma chave de API ou credenciais de usuário para autenticar.

O diagrama a seguir mostra como usar segredos ou credenciais compartilhadas para autenticar com um ponto de extremidade de aplicativo no teste de carga.

O fluxo para autenticação com um segredo compartilhado ou as credenciais do usuário é:

1. Armazene com segurança o segredo ou as credenciais, por exemplo, no Azure Key Vault ou no repositório de segredos de CI/CD.
2. Referencie o segredo na configuração do teste de carga.
3. No script JMeter, recupere o valor do segredo com a função GetSecret e passe o valor secreto para a solicitação do aplicativo.

Armazene o segredo com segurança

Para evitar armazenar e divulgar informações de segurança no script JMeter, você pode armazenar segredos com segurança no Azure Key Vault ou no repositório de segredos de CI/CD.

Você pode adicionar as informações de segurança em um repositório de segredos de duas maneiras:

• Adicione as informações secretas no Azure Key Vault. Siga as etapas em Parametrizar testes de carga com segredos para armazenar um segredo e autorizar seu recurso de teste de carga a ler seu valor.

• Adicione as informações secretas como um segredo no CI/CD (segredos do GitHub Actions ou variáveis secretas do Azure Pipelines).

Referenciar o segredo na configuração de teste de carga

Antes de recuperar o valor do segredo no script de teste do JMeter, você precisa referenciar o segredo na configuração do teste de carga.

Portal do Azure

No portal do Azure, você pode referenciar os segredos armazenados no Azure Key Vault. Para adicionar e configurar um segredo de teste de carga no portal do Azure:

1. Navegue até o recurso de teste de carga no portal do Azure e selecione Testes para exibir a lista de testes de carga.

2. Selecione seu teste na lista e selecione Editar para editar a configuração do teste de carga.

   

3. Na guia Parâmetros, insira os detalhes do segredo.

   Campo	Valor
   Nome	Nome do segredo. Você fornece esse nome à função GetSecret para recuperar o valor do segredo no script JMeter.
   Valor	Corresponde ao identificador secreto do Azure Key Vault.

   

4. Selecione Aplicar para salvar as alterações de configuração do teste de carga.

GitHub Actions

Para adicionar um segredo ao seu teste de carga no GitHub Actions, atualize o arquivo YAML do fluxo de trabalho do GitHub Actions. No fluxo de trabalho, adicione um parâmetro secrets à ação azure/load-testing.

Campo	Valor
name	Nome do segredo. Você fornece esse nome à função GetSecret para recuperar o valor do segredo no script JMeter.
value	Faz referência ao nome secreto do GitHub Actions.

O trecho de código a seguir fornece um exemplo de como configurar um segredo de teste de carga no GitHub Actions.

- name: 'Azure Load Testing'
    uses: azure/load-testing@v1
    with:
    loadtestConfigFile: 'SampleApp.yaml'
    loadtestResource: 'MyTest'
    resourceGroup: 'loadtests-rg'
    secrets: |
        [
            {
            "name": "appToken",
            "value": "${{ secrets.APP_TOKEN }}"
            }
        ]

Azure Pipelines

Para adicionar um segredo ao teste de carga no Azure Pipelines, atualize o arquivo de definição do Azure Pipelines. No pipeline, adicione um parâmetro secrets à tarefa AzureLoadTest.

Campo	Valor
name	Nome do segredo. Você fornece esse nome à função GetSecret para recuperar o valor do segredo no script JMeter.
value	Faz referência ao nome da variável secreta do Azure Pipelines.

O trecho de código a seguir fornece um exemplo de como configurar um segredo de teste de carga no Azure Pipelines.

- task: AzureLoadTest@1
    inputs:
    azureSubscription: 'MyAzureLoadTestingRG'
    loadTestConfigFile: 'SampleApp.yaml'
    loadTestResource: 'MyTest'
    resourceGroup: 'loadtests-rg'
    secrets: |
        [
            {
            "name": "appToken",
            "value": "$(appToken)"
            }
        ]

Recuperar e usar o valor do segredo no script JMeter

Agora você pode recuperar o valor do segredo no script JMeter usando a função personalizada GetSecret e passá-lo para a solicitação do aplicativo. Por exemplo, use um cabeçalho HTTP Authorization para passar um token OAuth para uma solicitação.

1. Crie uma variável definida pelo usuário que recupere o valor do segredo com a função personalizada GetSecret:

   A função GetSecret abstrai a recuperação do valor do Azure Key Vault ou do armazenamento de segredos de CI/CD.

   

2. Atualize o componente do amostrador JMeter para transmitir o segredo na solicitação.

   Por exemplo, para fornecer um token de acesso OAuth2, você configura o cabeçalho HTTP Authorization adicionando um HTTP Header Manager:

   

Autenticar com o certificado de cliente

Nesse cenário, o ponto de extremidade do aplicativo requer que você use um certificado de cliente para autenticar. O Teste de Carga do Azure dá suporte ao tipo de certificados do Padrão de Certificado de Chave Pública nº 12 (PKCS12). Você pode usar apenas um certificado de cliente em um teste de carga.

O diagrama a seguir mostra como usar um certificado de cliente para autenticar com um ponto de extremidade de aplicativo em seu teste de carga.

O fluxo para autenticação com os certificados do cliente é:

1. Armazene com segurança o certificado do cliente no Azure Key Vault.
2. Referenciar o certificado na configuração de teste de carga.
3. O Teste de Carga do Azure passa de forma transparente o certificado para todas as solicitações de aplicativo no JMeter.

Armazenar o certificado do cliente no Azure Key Vault

Para evitar armazenar e divulgar o certificado do cliente junto com o script JMeter, armazene o certificado no Azure Key Vault.

Siga as etapas em Importar um certificado para armazenar seu certificado no Azure Key Vault.

Importante

O Teste de Carga do Azure dá suporte apenas a certificados PKCS12. Carregue o certificado do cliente no formato de arquivo PFX.

Conceder acesso ao seu cofre de chaves do Azure

Quando você armazena segredos de teste de carga ou certificados no Azure Key Vault, seu recurso de teste de carga usa uma identidade gerenciada para acessar o cofre de chaves. Depois de configurar a identidade de gerenciamento, você precisará conceder a identidade gerenciada das suas permissões de recurso de teste de carga para ler esses valores do cofre de chaves.

Para conceder permissões de recurso de teste de carga do Azure para ler segredos ou certificados do cofre de chaves do Azure:

1. No portal do Azure, acesse o recurso do cofre de chaves do Azure.

   Se você não tiver um cofre de chaves, siga as instruções no Início Rápido do Azure Key Vault para criar um.

2. No menu à esquerda, selecione Políticas de Acesso e selecione Criar.

3. Na guia Permissões, em Permissões secretas, selecione Obter, e selecione Próximo.

   Observação

   O Teste de Carga do Azure recupera certificados como um segredo para garantir que a chave privada do certificado esteja disponível.

4. Na guia Principal, pesquise e selecione a identidade gerenciada no recurso de teste de carga e selecione Próximo.

   Se você estiver usando uma identidade gerenciada atribuída pelo sistema, o nome da identidade gerenciada corresponderá ao do recurso de teste de carga do Azure.

5. Selecione novamente Avançar.

   Quando o teste é executado, a identidade gerenciada associada ao recurso de teste de carga já pode ler os segredos ou certificados do teste de carga do cofre de chaves.

Referenciar o certificado na configuração de teste de carga

Para passar o certificado do cliente para as solicitações de aplicativo, você precisa referenciar o certificado na configuração de teste de carga.

Portal do Azure

Para adicionar um certificado de cliente ao seu teste de carga no portal do Azure:

1. Navegue até seu recurso de teste de carga no portal do Azure. Se você ainda não tiver um teste de carga, crie um novo teste de carga usando um script JMeter.

2. No painel esquerdo, selecione Testes para exibir a lista de testes de carga.

3. Selecione seu teste na lista e selecione Editar para editar a configuração do teste de carga.

   

4. Na guia Parâmetros, insira os detalhes do certificado.

   Campo	Valor
   Nome	Nome do certificado.
   Valor	Corresponde ao identificador secreto do Azure Key Vault do certificado.

5. Selecione Aplicar para salvar as alterações de configuração do teste de carga.

GitHub Actions

Para adicionar um certificado de cliente para seu teste de carga, atualize a propriedade certificates no arquivo de configuração YAML do teste de carga.

Campo	Valor
name	Nome do certificado do cliente.
value	Corresponde ao identificador secreto do Azure Key Vault do certificado.

certificates:
    - name: <my-certificate-name>
      value: <my-keyvault-secret-ID>

Azure Pipelines

Para adicionar um certificado de cliente para seu teste de carga, atualize a propriedade certificates no arquivo de configuração YAML do teste de carga.

Campo	Valor
name	Nome do certificado do cliente.
value	Corresponde ao identificador secreto do Azure Key Vault do certificado.

certificates:
    - name: <my-certificate-name>
      value: <my-keyvault-secret-ID>

Quando você executa o teste de carga, o Teste de Carga do Azure recupera o certificado do cliente do Azure Key Vault e o injeta automaticamente em cada solicitação da Web do JMeter.

Conteúdo relacionado

• Saiba mais sobre como parametrizar um teste de carga.