Integração com Dropbox

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 7 min. de leitura

    • A integração da aplicação Gestão de ativos de software com o serviço Dropbox permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

    Para obter mais informações sobre o serviço Dropbox, consulte os Guias do administrador e do usuário do Dropbox Business.

    Importante:
    Minimize os riscos de segurança e proteja as informações concedendo acesso somente ao usuário ou às permissões de API necessárias.
    Tabela 1. Permissões mínimas do usuário
    Processo Função do usuário necessária na aplicação Dropbox Escopos de autenticação
    Download de assinaturas Administrador de segurança
    • membros.ler
    • equipe_dados.membro
    Extrair atividade do usuário Administrador de segurança
    • eventos.ler
    • equipe_dados.membro
    Recuperar assinatura Administrador de segurança
    • info_equipe.ler
    • membros.gravação
    • membros.excluir

    Criar uma aplicação Dropbox para assinaturas de usuário

    Crie uma aplicação na plataforma DBX para desenvolvedores.

    Antes de Iniciar

    Dropbox Função necessária: consulte a tabela Permissões mínimas do usuário.

    Procedimento

    1. Navegue até Aplicativos para desenvolvedores do Dropbox e entre na sua conta.
    2. Na página Meus apps, selecione Criar app.
    3. Selecione a API de acesso com escopo.
    4. Especifique o tipo de acesso ao Dropbox completo.
    5. Insira um nome para sua aplicação e selecione Criar app.
    6. Selecione a guia Permissão.
    7. Marque estas caixas de seleção de permissão:
      • info_equipe.ler
      • membros.gravação
      • membros.excluir
      • groups.read
      • eventos.ler
      • equipe_dados.membro
    8. Selecione Enviar para salvar as mudanças.
    9. Navegue até a guia Configurações.
    10. Obtenha a chave da aplicação e o segredo da aplicação.
      Você precisará copiar e colar esses valores nos campos ID do cliente e Segredo do cliente na sua instância ServiceNow nas etapas a seguir.
      Nota:
      A chave do app (ID do cliente) e o segredo do app (segredo do cliente) são confidenciais. Não os compartilhe.
    11. Insira https://instance.service-now.com/oauth_redirect.do como o URI de redirecionamento, em que instance é o nome da sua instância ServiceNow.
    12. Clique na guia Identidade visual e em Salvar mudanças.

    Criação do perfil de Integração Dropbox

    Crie um perfil de integração para rastrear assinaturas de software e otimizar o licenciamento do serviço Dropbox.

    Antes de Iniciar

    Para criar um perfil de integração Dropbox, solicite o plug-in Gestão de ativos de software - Gestão de licenças de SaaS (sn_sam_saas_int) na ServiceNow Store.

    ServiceNow Função necessária: sam_integrator ou administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Se você estiver usando Espaço para ativos de software, a opção para criar o perfil de integração Dropbox em IU principal estará inativa.

    Procedimento

    1. Usando as informações da aplicação com as permissões definidas para Acesso a arquivos de membro da equipe, retorne à sua instância ServiceNow para criar um perfil de integração.
    2. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Tudo > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
      2. Selecione Novo.
      3. Selecione Perfil de integração do Dropbox.
      Espaço de ativo do software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração diretos.
      2. Selecione Novo.
      3. Selecione Dropbox na lista suspensa.
      4. Selecione Continuar.
    3. No formulário, preencha os campos.
      Tabela 2. Formulário Perfil de integração
      Campo Valor
      Nome de exibição Nome do perfil de integração. Por exemplo, Integração com DropBox
      ID de Cliente ID de cliente da aplicação OAuth criada na conta de administrador SaaS.
      URL de redirecionamento URL do provedor OAuth para o qual você é redirecionado após a autenticação. Este valor é preenchido automaticamente.
      Segredo do cliente Senha associada ao ID do cliente.
      Tipo de perfil Tipo de perfil de integração. Este valor é definido automaticamente como Assinatura do DropBox.
      Analisar a atividade do usuário do
      No campo Analisar atividade do usuário, você também pode selecionar a data e a hora a partir de quando deseja analisar a atividade do usuário. Por padrão, você pode analisar a atividade do usuário até 60 dias antes da data atual e exibir eventos realizados por usuários individuais a partir do momento em que cria este perfil.
      Nota:
      Gestão de ativos de software extrai os eventos a partir do momento em que você começa a analisar a atividade do usuário, independentemente da data de criação do perfil.
      Você pode modificar este valor no campo Limite de última atividade das regras de recuperação de software. Para obter mais informações, consulte Revisar uma regra de recuperação de software.
    4. Na seção Configuração de processo, revise as funções de usuário necessárias ou as permissões de API especificadas no campo Configuração do fornecedor para cada processo para minimizar os riscos de segurança e otimizar SaaS licenças.
      Nota:
      Para obter mais informações sobre as funções e os escopos necessários, consulte Tabela de permissões mínimas do usuário.

      • A caixa de seleção Baixar assinaturas está marcada por padrão e você não pode desmarcá-la.

      • A caixa de seleção Baixar atividade está marcada por padrão. Se você desmarcar, o trabalho agendado de atividade SAM - Refresh <displayname> Events não será criado.

        No campo Analisar atividade do usuário, você também pode selecionar a data e a hora a partir de quando deseja analisar a atividade do usuário. Por padrão, você pode analisar a atividade do usuário até 60 dias antes da data atual e exibir eventos realizados por usuários individuais a partir do momento em que cria este perfil.
        Nota:
        Gestão de ativos de software extrai os eventos a partir do momento em que você começa a analisar a atividade do usuário, independentemente da data de criação do perfil.
        Você pode modificar este valor no campo Limite de última atividade das regras de recuperação de software. Para obter mais informações, consulte Revisar uma regra de recuperação de software.

      • A caixa de seleção Recuperar assinaturas está marcada por padrão. Se você não quiser recuperar assinaturas, poderá desmarcar esta caixa de seleção. Se você desmarcar, os candidatos a remoção serão criados, mas o subfluxo de assinatura de recuperação não será acionado ou o processo de recuperação não será iniciado.

    5. Selecione Enviar depois de preencher todos os campos obrigatórios.
      Sua instância ServiceNow cria um perfil de integração de rascunho.
    6. No formulário de perfil de integração, selecione Obter token OAuth.
      Nota:
      Para a função necessária para executar esta etapa, consulte a tabela Permissões mínimas do usuário.
    7. Navegue até a aplicação Dropbox.
      • Selecione Permitir se você já tiver feito login na aplicação Dropbox.
      • Se você não fez login na aplicação Dropbox, faça login com suas credenciais de administrador e prossiga com as próximas etapas.
      Nota:
      Quando as assinaturas de usuário são recuperadas, os arquivos das contas recuperadas são transferidos para a conta de administrador selecionada nesta etapa. Esta conta pode ser uma conta de administrador diferente da usada para configurar a integração. Se você precisar começar a transferir arquivos para um novo administrador, poderá selecionar o link relacionado Obter token OAuth novamente a qualquer momento para selecionar uma conta de administrador diferente. Depois de selecionar um novo administrador, você pode recuperar a conta do administrador antigo para transferir todos os arquivos para o novo administrador, incluindo todos os arquivos de usuário recuperados anteriormente.
    8. No formulário de perfil de integração, selecione Validar conexão para verificar os detalhes de conexão e credencial desta integração.

      A validação da conexão verifica as APIs Baixar assinaturas e Calcular atividade, mas não as APIs Recuperar assinaturas.

      Nota:
      Se você desmarcar a caixa de seleção Atividade de download depois que o perfil de integração for validado e os trabalhos agendados forem criados, você deverá revalidar as conexões porque os seguintes eventos ocorrem:
      • O campo Status no formulário de perfil de integração muda para Rascunho.
      • O botão Validar conexão aparece no formulário.
      • O trabalho SAM - Refresh <displayname> Events atual é excluído.

    O que Fazer Depois

    Depois que a integração se conecta, sua instância ServiceNow cria automaticamente modelos de software, regras de recuperação e assinaturas de software que são atualizadas diariamente.

    Se você quiser configurar vários perfis de integração com conexões exclusivas, crie aliases secundários para gerenciar diferentes configurações e definições para cada perfil de integração. Para obter mais informações, consulte Crie um alias secundário para configurar vários perfis de integração.

    Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas de usuário. Para obter mais informações, consulte Revisar uma regra de recuperação de software.

    Crie direitos de software para os modelos de software gerados automaticamente para rastrear o software usado em relação ao software de propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licenças (Gestão de ativos de software aplicação clássica) ou na exibição de uso de licença (Software Asset Workspace). Use esses resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade.