Implementar um conector para arquivar dados do Twitter

Este artigo descreve o processo de implementação de um conector que utiliza o serviço Importar do Microsoft 365 para importar dados da conta do Twitter da sua organização para o Microsoft 365. Para obter uma descrição geral de alto nível deste processo e uma lista dos pré-requisitos necessários para implementar um conector do Twitter, consulte Configurar um conector para arquivar dados do Twitter.

Passo 1: criar uma aplicação no Microsoft Entra ID

  1. Aceda a https://portal.azure.com e inicie sessão com as credenciais de uma conta de administrador global.

    Importante

    A Microsoft recomenda que você use funções com o menor número de permissões. Minimizar o número de utilizadores com a função de Administrador Global ajuda a melhorar a segurança da sua organização. Saiba mais sobre as funções e permissões do Microsoft Purview.

    Captura de ecrã da página de início de sessão do portal do Azure para credenciais de administrador global.

  2. No painel de navegação esquerdo, selecione Microsoft Entra ID.

    Captura de ecrã do painel de navegação esquerdo com Microsoft Entra ID selecionadas no portal do Azure.

  3. No painel de navegação esquerdo, selecione Registros de aplicativo (Pré-visualização) e, em seguida, selecione Novo registo.

    Captura de ecrã da página Microsoft Entra ID Registros de aplicativo com a opção Novo registo.

  4. Registre o aplicativo. Em URI de Redirecionamento (opcional), selecione Web na lista pendente tipo de aplicação e, em seguida https://portal.azure.com , escreva na caixa do URI.

    Captura de ecrã das definições de registo de aplicações a mostrar o URI de redirecionamento configurado para o portal do Azure.

  5. Copie o ID da Aplicação (cliente) e o ID do Diretório (inquilino) e guarde-os num ficheiro de texto ou noutra localização segura. Utilize estes IDs em passos posteriores.

    Captura de ecrã da página de descrição geral da aplicação a mostrar o ID da Aplicação (cliente) e o ID do Diretório (inquilino).

  6. Aceda a Certificados & segredos da nova aplicação e, em Segredos do cliente, selecione Novo segredo do cliente.

    Captura de ecrã da página Certificados & segredos com a opção de criar um novo segredo do cliente.

  7. Crie um novo segredo. Na caixa de descrição, escreva o segredo e, em seguida, selecione um período de expiração.

    Captura de ecrã do formulário de segredo do cliente com o campo de descrição e as opções do período de expiração.

  8. Copie o valor do segredo e guarde-o num ficheiro de texto ou noutra localização de armazenamento. Este é o segredo da aplicação Microsoft Entra que utiliza nos passos posteriores.

    Captura de ecrã do valor do segredo do cliente apresentado para copiar e guardar.

Passo 2: implementar o serviço Web do conector a partir do GitHub na sua conta Azure

  1. Aceda a este site do GitHub e selecione Implementar no Azure.

    Captura de ecrã da página do repositório do GitHub com o botão Implementar no Azure realçado.

  2. Depois de selecionar Implementar no Azure, é redirecionado para uma portal do Azure com uma página de modelo personalizada. Preencha os detalhes Básicos e Definições e, em seguida, selecione Comprar.

    Captura de ecrã da página portal do Azure modelo personalizado com os campos Básicos e Definições para a implementação do conector.

    • Subscrição: Selecione a sua subscrição Azure na qual pretende implementar o serviço Web do conector do Twitter.
    • Grupo de recursos: Selecione ou crie um novo grupo de recursos. Um grupo de recursos é um contentor que contém recursos relacionados para uma solução Azure.
    • Localização: Selecione uma localização.
    • Nome da Aplicação Web: Forneça um nome exclusivo para a aplicação Web do conector. O nome tem de ter entre 3 e 18 carateres de comprimento. Este nome é utilizado para criar o URL do serviço de aplicações Azure; por exemplo, se fornecer o nome da aplicação Web do twitterconnector, o URL do serviço de aplicações Azure é twitterconnector.azurewebsites.net.
    • tenantId: O ID de inquilino da sua organização do Microsoft 365 que copiou depois de criar a aplicação do conector do Twitter no Microsoft Entra ID no Passo 1.
    • APISecretKey: Pode escrever qualquer valor como segredo. Este valor é utilizado para aceder à aplicação Web do conector no Passo 5.

  3. Quando a implementação for bem-sucedida, a página terá um aspeto semelhante à seguinte captura de ecrã:

    Captura de ecrã do portal do Azure a mostrar uma implementação do serviço Web do conector com êxito.

Passo 3: criar a aplicação twitter

  1. Aceda a https://developer.twitter.com, inicie sessão com as credenciais da conta de programador da sua organização e selecione Aplicações.

    Captura de ecrã da home page do portal do programador do Twitter com a opção Aplicações.

  2. Selecione Criar uma aplicação.

    Captura de ecrã da página Aplicações do portal do programador do Twitter com a opção para criar uma nova aplicação.

  3. Em Detalhes da aplicação, introduza informações sobre a aplicação.

    Captura de ecrã a mostrar o formulário de detalhes da Aplicação Twitter para introduzir informações da aplicação.

  4. No programador do Twitter dashboard, selecione a aplicação que acabou de criar e, em seguida, selecione Detalhes.

    Captura de ecrã do programador do Twitter dashboard a mostrar os detalhes da aplicação e o ID da Aplicação.

  5. No separador Chaves e tokens , em Chaves de API de Consumidor, copie a Chave de API e a chave secreta da API e guarde-as num ficheiro de texto ou noutra localização de armazenamento. Em seguida, selecione Criar para gerar um token de acesso e um segredo do token de acesso e copie-os para um ficheiro de texto ou outra localização de armazenamento.

    Captura de ecrã da página Chaves e tokens da aplicação de programador do Twitter a mostrar a chave secreta da API.

    Selecione Criar para gerar um token de acesso e um segredo do token de acesso e copie-os para um ficheiro de texto ou outra localização de armazenamento.

  6. Selecione o separador Permissões e configure as permissões, conforme mostrado na seguinte captura de ecrã:

    Captura de ecrã do separador Permissões da aplicação Twitter com as permissões necessárias configuradas.

  7. Depois de guardar as definições de permissão, selecione o separador Detalhes da aplicação e, em seguida, selecione Editar > Detalhes de edição.

    Captura de ecrã da página de detalhes da aplicação Twitter com a opção Editar detalhes selecionada.

  8. Conclua as tarefas a seguir:

    • Selecione a caixa de verificação para permitir que a aplicação do conector inicie sessão no Twitter.
    • Adicione o Uri de redirecionamento OAuth com o seguinte formato: <connectorserviceuri>/Views/TwitterOAuth, em que o valor de connectorserviceuri é o URL do serviço de aplicações Azure para a sua organização.

    Captura de ecrã das definições da aplicação Twitter a mostrar a permissão de início de sessão ativada e o URI de redirecionamento de OAuth configurado.

A aplicação para programadores do Twitter está agora pronta a ser utilizada.

Passo 4: Configurar a aplicação Web do conector

  1. Aceda a https://<AzureAppResourceName>.azurewebsites.net (em que AzureAppResourceName é o nome do recurso da aplicação Azure que nomeou no Passo 2). A home page da aplicação tem o aspeto da seguinte captura de ecrã:

    Captura de ecrã da home page da aplicação Web do conector alojado Azure.

  2. Selecione Configurar para apresentar uma página de início de sessão.

    Captura de ecrã da página de início de sessão da aplicação Web do conector aberta a partir da opção Configurar.

  3. Na caixa ID do Inquilino, escreva ou cole o seu ID de inquilino Microsoft Entra (o ID do diretório (inquilino) do Microsoft Entra registo da aplicação). Na caixa palavra-passe, escreva ou cole o valor APISecretKey das definições do modelo de implementação Azure e, em seguida, selecione Definir Definições de Configuração para apresentar a página de detalhes de configuração.

    Captura de ecrã da página de início de sessão com o ID do Inquilino e os campos de chave secreta da API.

  4. Introduza as seguintes definições de configuração:

    • Chave de API do Twitter: A chave de API para a aplicação do Twitter que criou no Passo 3.
    • Chave Secreta da API do Twitter: A chave secreta da API para a aplicação do Twitter que criou no Passo 3.
    • Token de Acesso do Twitter: O token de acesso que criou no Passo 3.
    • Segredo do Token de Acesso do Twitter: O segredo do token de acesso que criou no Passo 3.
    • Microsoft Entra ID da Aplicação: o ID da aplicação para a aplicação Microsoft Entra que criou no Passo 1
    • Microsoft Entra Segredo da Aplicação: o valor do segredo do cliente da aplicação Microsoft Entra que criou durante o registo da aplicação no Microsoft Entra ID.

  5. Selecione Guardar para guardar as definições do conector.

Passo 5: Configurar um conector do Twitter

  1. Inicie sessão no portal do Microsoft Purview.

  2. Selecione Definições>Conectores de dados.

  3. Selecione Os meus conectores e, em seguida, selecione Adicionar conector.

  4. Na lista, selecione Twitter.

  5. Na página Termos de serviço , selecione Aceitar.

  6. Na página Adicionar credenciais para a aplicação do conector , introduza as seguintes informações e, em seguida, selecione Validar ligação.

    • Na caixa Nome , escreva um nome para o conector, como a alça de ajuda do Twitter.
    • Na caixa URL do Conector, escreva ou cole o URL do serviço de aplicações Azure.
    • Na caixa Palavra-passe, escreva ou cole o valor APISecretKey das definições do modelo de implementação Azure.
    • Na caixa Azure App ID, escreva ou cole o valor do ID da Aplicação Aplicativo Azure (também denominado ID de cliente) que obteve no Passo 1.

  7. Depois de a ligação ser validada com êxito, selecione Seguinte.

  8. Na página Autorizar o Microsoft 365 a importar dados , escreva ou cole a APISecretKey novamente e, em seguida, selecione Iniciar sessão na aplicação Web.

  9. Selecione Iniciar sessão com o Twitter.

  10. Na página de início de sessão do Twitter, inicie sessão com as credenciais da conta do Twitter da sua organização. Depois de iniciar sessão, a página do Twitter apresenta a seguinte mensagem, "Tarefa do Conector do Twitter Configurada com Êxito".

  11. Selecione Continuar para concluir a configuração do conector do Twitter.

  12. Na página Definir filtros , pode aplicar um filtro para importar inicialmente itens com uma determinada idade. Selecione uma idade e, em seguida, selecione Seguinte.

  13. Na página Escolher localização de armazenamento , escreva o endereço de e-mail da caixa de correio do Microsoft 365 para a qual os itens do Twitter são importados e, em seguida, selecione Seguinte.

  14. Selecione Seguinte para rever as definições do conector e, em seguida, selecione Concluir para concluir a configuração do conector.

  • Last updated on