Ir para o conteúdo

Atividade de consulta de objetos do Microsoft Azure Key Vault (beta)

Introdução

Uma atividade Consultar objetos do Vault do Microsoft Azure Key Vault (beta), usando sua conexão Microsoft Azure Key Vault (beta), recupera um certificado, chave ou segredo do Microsoft Azure Key Vault e se destina a ser usado como uma fonte para fornecer dados em uma operação.

Nota

Este conector está atualmente lançado como uma versão beta. Para fornecer feedback sobre bugs e melhorias, entre em contato com seu Gerente de Sucesso do Cliente (CSM).

Criar uma atividade de consulta de objetos do Microsoft Azure Key Vault (beta)

Uma instância de uma atividade Consultar objetos do Vault do Microsoft Azure Key Vault (beta) é criada a partir de uma conexão do Microsoft Azure Key Vault (beta) usando seu tipo de atividade Query Vault Objects.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criando uma instância de atividade em Reutilização de componentes.

Uma atividade existente do Microsoft Azure Key Vault (beta) Consultar objetos do Vault pode ser editada nestes locais:

Configurar uma atividade de consulta de objetos do Microsoft Azure Key Vault (beta)

Siga estas etapas para configurar uma atividade Consultar objetos do Vault do Microsoft Azure Key Vault (beta):

Etapa 1: insira um nome e selecione um cofre

Nesta etapa, forneça um nome para a atividade e selecione um vault. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 1 da configuração de objetos do Microsoft Azure Key Vault Query Vault

  • Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade do Microsoft Azure Key Vault (beta) Query Vault Objects e não deve conter barras / ou dois pontos :.

  • Selecione um cofre: Esta seção exibe os cofres disponíveis no endpoint do Microsoft Azure Key Vault (beta).

    • Cofre selecionado: Depois que um cofre é selecionado, ele é listado aqui.

    • Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de cofres. A pesquisa não diferencia maiúsculas de minúsculas. Se os cofres já estiverem exibidos na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla. Para recarregar os cofres do endpoint ao pesquisar, insira os critérios de pesquisa e atualize, conforme descrito abaixo.

    • Atualizar: Clique no ícone de atualização ou a palavra Refresh para recarregar os cofres do endpoint do Microsoft Azure Key Vault (beta). Isso pode ser útil se os cofres tiverem sido adicionados ao Microsoft Azure Key Vault. Esta ação atualiza todos os metadados usados para criar a tabela de cofres exibida na configuração.

    • Selecionando um cofre: Dentro da tabela, clique em qualquer lugar em uma linha para selecionar um cofre. Apenas um cofre pode ser selecionado. As informações disponíveis para cada cofre são obtidas do endpoint do Microsoft Azure Key Vault (beta):

    Dica

    Se a tabela não for preenchida com os cofres disponíveis, a conexão Microsoft Azure Key Vault (beta) pode não ser bem-sucedido. Certifique-se de que você está conectado reabrindo a conexão e testando novamente as credenciais.

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais:

    • Continuar em caso de erro: Selecione para continuar a execução da atividade se um erro for encontrado para um conjunto de dados em uma solicitação em lote. Se algum erro for encontrado, ele será gravado no log de operação.

  • Salvar e sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Selecione um tipo de objeto de cofre

Nesta etapa, selecione um tipo de objeto de vault. Cada elemento de interface de usuário desta etapa é descrito abaixo.

Etapa 2 da configuração de objetos do Microsoft Azure Key Vault Query Vault

  • Selecione um tipo de objeto: Esta seção exibe os tipos de objetos do vault disponíveis no endpoint do Microsoft Azure Key Vault (beta). Para obter mais informações sobre os tipos de objetos do vault Certificate, Key e Store suportados, consulte a documentação da API REST do Microsoft Azure Key Vault.

    • Cofre selecionado: O cofre selecionado na etapa anterior é listado aqui.

    • Tipo de objeto selecionado: Depois que um tipo de objeto do cofre é selecionado, ele é listado aqui.

    • Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de tipos de objetos do vault. A pesquisa não diferencia maiúsculas de minúsculas. Se os tipos de objetos do vault já estiverem exibidos na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla. Para recarregar os tipos de objetos do vault do endpoint ao pesquisar, insira os critérios de pesquisa e atualize, conforme descrito abaixo.

    • Atualizar: Clique no ícone de atualização ou a palavra Refresh para recarregar os tipos de objeto do vault do endpoint do Microsoft Azure Key Vault (beta). Isso pode ser útil se os tipos de objeto do vault foram adicionados ao Microsoft Azure Key Vault. Esta ação atualiza todos os metadados usados para criar a tabela de tipos de objeto do vault exibida na configuração.

    • Selecionando um tipo de objeto: Dentro da tabela, clique em qualquer lugar em uma linha para selecionar um tipo de objeto de cofre. Apenas um tipo de objeto de cofre pode ser selecionado. As informações disponíveis para cada tipo de objeto de cofre são obtidas do endpoint do Microsoft Azure Key Vault (beta):

      • Nome: O nome do tipo de objeto.

      • Descrição: A descrição do tipo de objeto.

    Dica

    Se a tabela não for preenchida com os tipos de objetos do vault disponíveis, a conexão do Microsoft Azure Key Vault (beta) pode não ser bem-sucedido. Certifique-se de que você esteja conectado reabrindo a conexão e testando novamente as credenciais.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 3: especifique ou selecione um objeto de cofre

Nesta etapa, especifique ou selecione um objeto vault. Cada elemento de interface de usuário desta etapa é descrito abaixo.

Etapa 3 da configuração de objetos do Microsoft Azure Key Vault Query Vault

  • Escolher atividade: Especifique a atividade a ser usada, uma das seguintes: Informar objeto manualmente ou Selecionar objeto existente.

    Se Informar objeto manualmente for selecionado para Escolher atividade, esta interface será apresentada:

    • Nome do objeto: Nome do objeto do cofre.

    Se Selecionar objeto existente for selecionado para Escolher atividade, esta interface será apresentada:

    Etapa 3b da configuração de objetos do Microsoft Azure Key Vault Query Vault

    • Selecione um objeto: Esta seção exibe os objetos do vault disponíveis no endpoint do Microsoft Azure Key Vault (beta).

      • Tipo de objeto selecionado: O tipo de objeto do cofre selecionado na etapa anterior é listado aqui.

      • Objeto selecionado: Depois que um objeto é selecionado, ele é listado aqui.

      • Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de objetos do vault. A pesquisa não diferencia maiúsculas de minúsculas. Se os objetos do vault já estiverem exibidos na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla. Para recarregar objetos do vault do endpoint ao pesquisar, insira os critérios de pesquisa e atualize, conforme descrito abaixo.

      • Atualizar: Clique no ícone de atualização ou a palavra Refresh para recarregar objetos do vault do endpoint do Microsoft Azure Key Vault (beta). Isso pode ser útil se objetos do vault foram adicionados ao Microsoft Azure Key Vault. Esta ação atualiza todos os metadados usados para criar a tabela de objetos do vault exibida na configuração.

      • Selecionando um objeto: Dentro da tabela, clique em qualquer lugar em uma linha para selecionar um objeto do vault. Apenas um tipo de objeto pode ser selecionado. As informações disponíveis para cada objeto são obtidas do endpoint do Microsoft Azure Key Vault (beta):

        • Nome: O nome do objeto.

        • Descrição: A descrição do objeto.

      Dica

      Se a tabela não for preenchida com objetos de vault disponíveis, a conexão Microsoft Azure Key Vault (beta) pode não ser bem-sucedido. Certifique-se de que você esteja conectado reabrindo a conexão e testando novamente as credenciais.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 4: Selecione uma operação de consultar

Nesta etapa, selecione uma operação de consultar. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 4 da configuração de objetos do Microsoft Azure Key Vault Query Vault

  • Selecione uma operação: Esta seção exibe as operações de consultar disponíveis no endpoint do Microsoft Azure Key Vault (beta). Para obter mais informações sobre as operações, consulte a documentação da API REST do Microsoft Azure Key Vault.

    • Cofre selecionado: O cofre selecionado na etapa anterior é listado aqui.

    • operação selecionada: Depois que uma operação de consultar é selecionada, ela é listada aqui.

    • Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de operações de consultar. A pesquisa não diferencia maiúsculas de minúsculas. Se as operações de consultar já estiverem exibidas na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla. Para recarregar as operações de consultar do endpoint ao pesquisar, insira os critérios de pesquisa e atualize, conforme descrito abaixo.

    • Atualizar: Clique no ícone de atualização ou a palavra Refresh para recarregar operações de consultar do endpoint do Microsoft Azure Key Vault (beta). Isso pode ser útil se operações de consultar tiverem sido adicionadas ao Microsoft Azure Key Vault. Esta ação atualiza todos os metadados usados para criar a tabela de operações de consultar exibida na configuração.

    • Selecionando uma operação: Dentro da tabela, clique em qualquer lugar em uma linha para selecionar uma operação de consultar. Apenas uma operação de consultar pode ser selecionada. As informações disponíveis para cada operação de consultar são obtidas do endpoint do Microsoft Azure Key Vault (beta):

      • Nome: O nome da operação de consultar.

      • Descrição: A descrição da operação de consultar.

    Dica

    Se a tabela não for preenchida com operações de consultar disponíveis, a conexão Microsoft Azure Key Vault (beta) pode não ser bem-sucedido. Certifique-se de que você esteja conectado reabrindo a conexão e testando novamente as credenciais.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 5: Revise os esquemas de dados

Quaisquer esquemas de solicitação ou resposta são exibidos. Cada elemento de interface de usuário desta etapa é descrito abaixo.

Etapa 5 da configuração de objetos do Microsoft Azure Key Vault Query Vault

  • esquema de dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.

    O conector do Microsoft Azure Key Vault (beta) usa a API REST do Microsoft Azure Key Vault. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

  • Atualizar: Clique no ícone de atualização ou a palavra Refresh para regenerar esquemas do endpoint do Microsoft Azure Key Vault (beta). Esta ação também regenera um esquema em outros locais em todo o projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Próximos passos

Após configurar uma atividade Query Vault Objects do Microsoft Azure Key Vault (beta), conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode configurar as definições da operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

As ações de menu para uma atividade são acessíveis a partir do painel do projeto e da quadro de design. Para obter detalhes, consulte menu de ações de atividade em Noções básicas do conector.

As atividades do Microsoft Azure Key Vault (beta) Query Vault Objects podem ser usadas como uma fonte com esses padrões de operação:

Para usar a atividade com funções de script, grave os dados em um local temporário e use esse local temporário na função de script.

Quando estiver pronto, implantar e executar a operação e validar o comportamento verificando os logs de operação.