Implantar um conector para arquivar dados do Twitter

Este artigo descreve o processo de implantação de um conector que usa o serviço de importação do Microsoft 365 para importar dados da conta do Twitter da sua organização para o Microsoft 365. Para obter uma visão geral de alto nível desse processo e uma lista de pré-requisitos necessários para implantar um conector do Twitter, consulte Configurar um conector para arquivar dados do Twitter.

Etapa 1: Criar um aplicativo no Microsoft Entra ID

  1. https://portal.azure.com Acesse e entre 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 usuários 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 tela da página de entrada do portal do Azure para credenciais de administrador global.

  2. Na navegação à esquerda, selecione Microsoft Entra ID.

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

  3. Na navegação à esquerda, selecione Registros de aplicativo (Versão prévia) e, em seguida, selecione Novo registro.

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

  4. Registre o aplicativo. Em URI de redirecionamento (opcional), selecione Web na lista suspensa do tipo de aplicativo e digite https://portal.azure.com na caixa do URI.

    Captura de tela das configurações de registro do aplicativo mostrando o URI de redirecionamento configurado para o portal do Azure.

  5. Copie a ID do aplicativo (cliente) e a ID do diretório (locatário) e salve-as em um arquivo de texto ou em outro local seguro. Você usará essas IDs em etapas posteriores.

    Captura de tela da página de visão geral do aplicativo mostrando a ID do aplicativo (cliente) e a ID do diretório (locatário).

  6. Acesse Certificados & segredos do novo aplicativo e, em Segredos do cliente, selecione Novo segredo do cliente.

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

  7. Criar um novo segredo. Na caixa de descrição, digite o segredo e selecione um período de expiração.

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

  8. Copie o valor do segredo e salve-o em um arquivo de texto ou em outro local de armazenamento. Esse é o segredo do aplicativo do Microsoft Entra que você usará nas etapas posteriores.

    Captura de tela do valor do segredo do cliente exibido para copiar e salvar.

Etapa 2: Implantar o serviço Web conector do GitHub para sua conta do Azure

  1. Acesse este site do GitHub e selecione Implantar no Azure.

    Captura de tela da página do repositório GitHub com o botão Implantar no Azure destacado.

  2. Depois de selecionar Implantar no Azure, você será redirecionado para um portal do Azure com uma página de modelo personalizada. Preencha os detalhes de Noções básicas e configurações e selecione Comprar.

    Captura de tela da página de modelo personalizado do portal do Azure com os campos Básico e Configurações para a implantação do conector.

    • Assinatura: Selecione a assinatura do Azure na qual você deseja implantar o serviço Web do conector do Twitter.
    • Grupo de recursos: Selecione ou crie um novo grupo de recursos. Um grupo de recursos é um contêiner que armazena os recursos relacionados de uma solução do Azure.
    • Localização: Selecione um local.
    • Nome do aplicativo Web: Forneça um nome exclusivo para o aplicativo Web do conector. O nome deve ter entre 3 e 18 caracteres. Esse nome é usado para criar a URL do serviço de aplicativo Azure; por exemplo, se você fornecer o nome do aplicativo Web do twitterconnector, a URL do serviço de aplicativo Azure será twitterconnector.azurewebsites.net.
    • tenantId: A ID de locatário da sua organização do Microsoft 365 que você copiou depois de criar o aplicativo do conector do Twitter no Microsoft Entra ID na Etapa 1.
    • APISecretKey: Você pode digitar qualquer valor como o segredo. Esse valor é usado para acessar o aplicativo Web do conector na Etapa 5.
  3. Quando a implantação é bem-sucedida, a página é semelhante à seguinte captura de tela:

    Captura de tela do portal do Azure mostrando uma implantação bem-sucedida do serviço web do conector.

Etapa 3: criar o aplicativo do Twitter

  1. Acesse https://developer.twitter.com, entre com as credenciais da conta de desenvolvedor da sua organização e selecione Aplicativos.

    Captura de tela da página inicial do portal do desenvolvedor do Twitter com a opção Aplicativos.

  2. Selecione Criar um aplicativo.

    Captura de tela da página Aplicativos do portal do desenvolvedor do Twitter com a opção de criar um novo aplicativo.

  3. Em Detalhes do aplicativo, insira informações sobre o aplicativo.

    Captura de tela do formulário de detalhes do aplicativo do Twitter para inserir informações do aplicativo.

  4. No dashboard do desenvolvedor do Twitter, selecione o aplicativo que você acabou de criar e selecione Detalhes.

    Captura de tela do dashboard do desenvolvedor do Twitter mostrando os detalhes do aplicativo e a ID do aplicativo.

  5. Na guia Chaves e tokens , em Chaves de API do consumidor, copie a chave de API e a chave secreta da API e salve-as em um arquivo de texto ou em outro local de armazenamento. Em seguida, selecione Criar para gerar um token de acesso e um segredo de token de acesso e copiá-los para um arquivo de texto ou outro local de armazenamento.

    Captura de tela da página Chaves e tokens do aplicativo de desenvolvedor do Twitter mostrando a chave secreta da API.

    Selecione Criar para gerar um token de acesso e um segredo de token de acesso e copie-os para um arquivo de texto ou outro local de armazenamento.

  6. Selecione a guia Permissões e configure as permissões conforme mostrado na captura de tela a seguir:

    Captura de tela da guia Permissões do aplicativo do Twitter com as permissões necessárias configuradas.

  7. Depois de salvar as configurações de permissão, selecione a guia Detalhes do aplicativo e, em seguida, selecione Editar > detalhes.

    Captura de tela da página de detalhes do aplicativo do Twitter com a opção Editar detalhes selecionada.

  8. Conclua as tarefas a seguir:

    • Marque a caixa de seleção para permitir que o aplicativo conector entre no Twitter.
    • Adicione o URI de redirecionamento OAuth usando o seguinte formato: <connectorserviceuri>/Views/TwitterOAuth, em que o valor de connectorserviceuri é a URL do serviço de aplicativo do Azure para sua organização.

    Captura de tela das configurações do aplicativo do Twitter mostrando a permissão de entrada habilitada e o URI de redirecionamento OAuth configurado.

O aplicativo de desenvolvedor do Twitter agora está pronto para uso.

Etapa 4: Configurar o aplicativo Web do conector

  1. Vá para https://<AzureAppResourceName>.azurewebsites.net (em que AzureAppResourceName é o nome do recurso de aplicativo do Azure que você nomeou na Etapa 2). A página inicial do aplicativo se parece com a seguinte captura de tela:

    Captura de tela da página inicial do aplicativo Web do conector hospedado no Azure.

  2. Selecione Configurar para exibir uma página de entrada.

    Captura de tela da página de entrada do aplicativo Web do conector aberta na opção Configurar.

  3. Na caixa ID do locatário, digite ou cole a ID do locatário do Microsoft Entra (a ID do diretório (locatário) do registro do aplicativo Microsoft Entra). Na caixa senha, digite ou cole o valor APISecretKey das configurações do modelo de implantação do Azure e selecione Definir Definições de Configuração para exibir a página de detalhes da configuração.

    Captura de tela da página de entrada com os campos ID do locatário e chave secreta da API.

  4. Insira as seguintes configurações:

    • Chave de API do Twitter: A chave de API do aplicativo do Twitter que você criou na Etapa 3.
    • Chave secreta da API do Twitter: A chave secreta da API para o aplicativo do Twitter que você criou na Etapa 3.
    • Token de Acesso ao Twitter: O token de acesso que você criou na Etapa 3.
    • Segredo do token de acesso ao Twitter: O segredo do token de acesso que você criou na Etapa 3.
    • ID do aplicativo Microsoft Entra: a ID do aplicativo para o aplicativo Microsoft Entra que você criou na Etapa 1
    • Segredo do Aplicativo do Microsoft Entra: o valor do segredo do cliente do aplicativo do Microsoft Entra que você criou durante o registro do aplicativo no Microsoft Entra ID.
  5. Selecione Salvar para salvar as configurações do conector.

Etapa 5: configurar um conector do Twitter

  1. Entre no portal do Microsoft Purview.

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

  3. Selecione 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 seu aplicativo conector , insira as seguintes informações e selecione Validar conexão.

    • Na caixa Nome , digite um nome para o conector, como o identificador de ajuda do Twitter.
    • Na caixa URL do Conector, digite ou cole a URL do serviço de aplicativo do Azure.
    • Na caixa Senha, digite ou cole o valor APISecretKey das configurações do modelo de implantação do Azure.
    • Na caixa ID do Azure App, digite ou cole o valor da ID do Aplicativo do Azure Azure (também chamada de ID do cliente) obtida na Etapa 1.
  7. Depois que a conexão for validada com êxito, selecione Avançar.

  8. Na página Autorizar o Microsoft 365 a importar dados , digite ou cole a APISecretKey novamente e selecione Aplicativo Web de Logon.

  9. Selecione Entrar com o Twitter.

  10. Na página de entrada do Twitter, entre usando as credenciais da conta do Twitter da sua organização. Depois de entrar, a página do Twitter exibe a seguinte mensagem: "Trabalho do conector do Twitter configurado com êxito".

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

  12. Na página Definir filtros , você pode aplicar um filtro para importar inicialmente itens que tenham uma determinada idade. Selecione uma idade e, em seguida, selecione Avançar.

  13. Na página Escolher local de armazenamento , digite o endereço de email da caixa de correio do Microsoft 365 para a qual os itens do Twitter são importados e selecione Avançar.

  14. Selecione Avançar para revisar as configurações do conector e, em seguida, selecione Concluir para concluir a configuração do conector.