Integração com Box

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

    • Integrando seu Gestão de ativos de softwareaplicação com Boxo serviço permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

    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 de usuário necessária no Boxaplicação Escopos de autenticação
    Download de assinaturas Co-administrador com Gerenciar usuários permissão Gerenciar usuários
    Extrair atividade do usuário Co-administrador com a permissão Executar novos relatórios e acessar relatórios existentes Gerencie propriedades da empresa
    Recuperar assinatura
    • Co-administrador com Gerenciar usuários permissão
    • Co-administrador com Exibir o conteúdo dos usuários permissão
    • Gerenciar usuários
    • Leia todos os arquivos e pastas armazenados em Box
    • Grave todos os arquivos e pastas armazenados em Box

    Para obter informações adicionais sobre Boxserviço, consulte Comunidade do Box .

    Crie um Boxaplicação

    Crie uma aplicação no BoxPlataforma.

    Antes de Iniciar

    BoxFunção necessária: Consulte Permissões mínimas do usuário tabela.

    Procedimento

    1. Navegue até Console do desenvolvedor do Box e entre na sua conta.
    2. Na página Meus apps, selecione Criar novo app .
    3. Selecione App personalizado .
    4. Na página Método de autenticação, selecione OAuth padrão 2,0 (autenticação do usuário) .
    5. Insira um nome de aplicação e selecione Criar app .
    6. Na página Configuração, obtenha o ID do cliente e o segredo do cliente.

      Você precisará copiar e colar esses valores em seu ServiceNownas etapas a seguir.

      Nota:
      Seu ID de cliente e segredo do cliente são confidenciais. Não os compartilhe.
    7. Insira https:// instância .service-now.com/oauth_redirect.do Como o URI de redirecionamento, onde instância é o nome do seu ServiceNowinstância.
    8. Marque as seguintes caixas de seleção Escopo da aplicação:
      • Leia e grave todos os arquivos e pastas armazenados em Box
      • Gerenciar usuários
      • Gerencie propriedades da empresa

      Esses escopos permitem que a integração obtenha uma lista de usuários, obtenha atividades do usuário e recupere assinaturas não usadas.

    9. Selecione Salve as mudanças .

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

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

    Antes de Iniciar

    Para criar um Boxperfil de integração, solicite o. Gestão de ativos de software- Gestão de licenças de SaaSplug-in (sn_sam_saas_int) do ServiceNow Store .

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

    Por Que e Quando Desempenhar Esta Tarefa

    Se você estiver usando Espaço para ativos de software, a opção para criar o. Boxperfil de integração em IU principalestá inativo.

    Procedimento

    1. 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 Box .
      Espaço de ativos de software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração diretos.
      2. Selecione Novo.
      3. Selecione Caixa na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 2. Formulário de perfil de integração
      Campo Valor
      Nome de exibição Nome do perfil de integração. Por exemplo, Integração do Box
      ID de Cliente ID do cliente para a aplicação OAuth criada no SaaSconta de administrador.
      URL de redirecionamento URL do provedor OAuth para o qual você foi 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 BoxAssinatura .
      Analisar atividade do usuário a partir de Você pode optar por começar a analisar dados a partir da data atual ou de até 60 dias no passado. Escolher uma data no passado permite detectar assinaturas obsoletas sem esperar em tempo real, pois você pode ver assinaturas que não foram usadas recentemente. Como escolher uma data no passado aumenta a quantidade de dados analisados, pode levar várias horas para que você possa exibir os resultados.
    3. Na seção Configuração do processo, revise as funções de usuário necessárias ou as permissões de API especificadas no Configuração do fornecedor campo para cada processo para minimizar os riscos de segurança e otimizar SaaSlicenças.
      Nota:
      Para obter mais informações sobre as funções e escopos necessários, consulte Permissões mínimas do usuário tabela.

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

      • . Atividade de download a caixa de seleção está marcada por padrão. Se você limpar, o trabalho agendado da atividade SAM - Refresh <displayname> Eventsnão foi criado.

        Em Analise a atividade do usuário você também pode selecionar a data e a hora a partir de quando você 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 você cria este perfil.
        Nota:
        Gestão de ativos de software extrai os eventos 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 da última atividade das regras de recuperação de software. Para obter mais informações, consulte Revise uma regra de recuperação de software.

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

    4. Selecione Enviar.
      Seu ServiceNowa instância cria um perfil de integração de rascunho.
    5. No perfil de integração, selecione Obter token OAuth .
      Nota:
      Para obter a função necessária para executar esta etapa, consulte Permissões mínimas do usuário tabela.
    6. Na janela pop-up, selecione seu Boxconta de administrador e selecione Permitir .
      Nota:
      Quando as assinaturas do 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ê transferir arquivos para um novo administrador, poderá selecionar Obter token OAuth link relacionado novamente a qualquer momento para selecionar uma conta de administrador diferente. Depois de selecionar um novo administrador, você pode recuperar a conta de administrador antiga para transferir todos os arquivos para o novo administrador, incluindo todos os arquivos de usuário recuperados anteriormente.
    7. 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 de recuperação de assinaturas.

    8. Depois que a conexão for validada, selecione Publicar .
    9. Na caixa de diálogo Confirmação de publicação, selecione OK .
      Nota:
      Se você limpar Atividade de download depois que o perfil de integração for validado e os trabalhos agendados forem criados, você deve revalidar as conexões porque os seguintes eventos ocorrem:
      • . Status o campo no formulário de perfil de integração muda para Rascunho .
      • . Valide a conexão o botão aparece no formulário.
      • O atual SAM - Refresh <displayname> Eventso trabalho é excluído.

    Resultado

    Você pode exibir eventos realizados por usuários individuais até um ano antes da data atual. Para obter mais informações, consulte Revise uma regra de recuperação de software. Gestão de ativos de softwareextrai os eventos do momento em que você começa a baixar assinaturas de usuário, independentemente da data de criação do perfil.

    O que Fazer Depois

    Após a integração se conectar, seu ServiceNowa instância 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 configuraçõ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 Revise 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 próprio.
    A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir seus resultados de reconciliação no Workbench de licença ( Gestão de ativos de softwareaplicação clássica) ou o. Exibição de uso de licença (Espaço de ativos de software). Use estes resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade.