Como integrar com Box

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 5 min. de leitura

    • Você pode integrar sua instância ServiceNow com o serviço Box para rastrear suas assinaturas de software e recuperar licenças não utilizadas.

    A conta Box que você usa para conectar a integração requer as seguintes permissões de acesso do usuário.
    Tabela 1. Editar permissões de acesso do usuário
    Permissão Valor
    Contatos compartilhados Permita que este usuário veja todos os usuários gerenciados.
    Habilitar sincronização de caixa Permita que este usuário sincronize arquivos entre Box e a área de trabalho do usuário.
    Coadministrador O usuário recebe os seguintes privilégios administrativos.
    Usuários e Grupos
    • Gerenciar usuários
    • Gerenciar grupos
    Arquivos e pastas
    • Exibir conteúdo de usuários
    • Editar conteúdo de usuários
    • Fazer login nas contas dos usuários
    Relatórios e configurações
    • Exibir configurações e aplicações para sua empresa
    • Editar configurações e aplicações para sua empresa
    • Executar novos relatórios e acessar relatórios existentes
    Essas permissões permitem que a integração obtenha uma lista de usuários, obtenha a atividade do usuário e recupere assinaturas não utilizadas.

    Para obter informações adicionais sobre o serviço Box, consulte o Box Community.

    Criar uma aplicação Box

    Crie uma aplicação na plataforma Box.

    Antes de Iniciar

    Box Função necessária: administrador

    Procedimento

    1. Navegue até o Console do desenvolvedor do Box e entre na sua conta.
    2. Na página Meus apps, clique em Criar novo app.
    3. Selecione Aplicativo personalizado.
    4. Na página Método de autenticação, selecione OAuth 2.0 padrão (Autenticação de usuário).
    5. Insira um nome de aplicação e clique em 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 na sua instância ServiceNow nas etapas a seguir.

      Nota:
      Seu ID de cliente e segredo do cliente são confidenciais. Não os compartilhe.
    7. Insira https://instance.service-now.com/oauth_redirect.do como o URI de redirecionamento, em que instance é o nome da sua instância ServiceNow.
    8. Marque as seguintes caixas de seleção de escopo da aplicação:
      • Ler todos os arquivos e pastas armazenados em Box
      • Ler e gravar todos os arquivos e pastas armazenados em Box
      • Gerenciar usuários
      • Gerenciar propriedades do Enterprise

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

    9. Clique em Salvar 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 do serviço Box.

    Antes de Iniciar

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

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

    Por Que e Quando Desempenhar Esta Tarefa

    Se você estiver usando o Software Asset Workspace, a opção para criar o perfil de integração Box na IU principal ficará inativa.

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Todos > 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 ativo do software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração direta.
      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 visualização Nome do perfil de integração. Por exemplo, Box Integration
      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ê será 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 da caixa.
      Analisar a atividade do usuário de Você pode optar por começar a analisar os 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 porque 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ê exiba os resultados.
    3. Clique em Enviar.
    4. No perfil de integração, selecione Obter token OAuth.
    5. Na janela pop-up, selecione sua conta de administrador Box e clique em Permitir.
      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 iniciar a transferência de arquivos para um novo administrador, poderá clicar no 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 de administrador antiga para transferir todos os arquivos para o novo administrador, incluindo todos os arquivos de usuário recuperados anteriormente.

    Resultado

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

    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 usuário que são atualizadas diariamente.

    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 sua propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho programado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licença (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 para corrigir qualquer não conformidade.