Integração com Box

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 7 min. de leitura

    • Integrando seu Software Asset Management aplicação com Box o serviço permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

    Importante:
    Minimize os riscos à 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 Box aplicaçã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 Gerenciar 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 Box, consulte Comunidade do Box .

    Crie um Box aplicação

    Crie uma aplicação no Box Plataforma.

    Antes de Iniciar

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

    Procedimento

    1. Navegue até Console do desenvolvedor do Box e entre em sua conta.
    2. Na página Meus aplicativos, selecione Criar novo app .
    3. Selecione Aplicativo personalizado .
    4. Na página Método de autenticação, selecione OAuth 2,0 padrão (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 ServiceNow nas 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, em que instância é o nome do seu ServiceNow instância.
    8. Marque as seguintes caixas de seleção Escopo da aplicação:
      • Lê e grava todos os arquivos e pastas armazenados em Box
      • Gerenciar usuários
      • Gerenciar 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 utilizadas.

    9. Selecione 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 Box serviço.

    Antes de Iniciar

    Para criar um Box perfil de integração, solicite o. Software Asset Management- Gestão de licenças de SaaS plug-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. Box perfil de integração em IU principal está 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 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 Caixa na lista suspensa.
      4. Selecione Continuar.
    2. 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 do Box
      ID de Cliente ID do cliente da aplicação OAuth criada no SaaS conta 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 em Configuração do fornecedor campo 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 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, a atividade será programada SAM - Refresh <displayname> Eventsnão foi criado.

        Em Analisar a atividade do usuário , você também pode selecionar a data e a hora a partir da qual 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:
        Software Asset Management extrai os eventos da hora 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 a remoção serão criados, mas o subfluxo Recuperar assinatura não será acionado ou o processo de recuperação não será iniciado.

    4. Selecione Enviar.
      . ServiceNow a 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 Box conta 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 do 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.

      Validar a conexão verifica as APIs Baixar assinaturas e Calcular atividade, mas não as APIs Recuperar 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 caixa de seleção depois que o perfil de integração for validado e os trabalhos agendados forem criados, você deverá revalidar as conexões porque ocorrem os seguintes eventos:
      • . Status o campo no formulário de perfil de integração muda para Rascunho .
      • . Validar 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. Software Asset Management extrai os eventos da hora em que você começa a baixar assinaturas do usuário, independentemente da data de criação do perfil.

    O que Fazer Depois

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

    Depois de criar um perfil de integração, exiba informações sobre o perfil no Espaço para ativos de software navegando até Operações de licença > Assinatura de usuário > Perfis de integração diretos. Você pode selecionar um perfil de integração para exibir as listas relacionadas a seguir. Se todas as listas relacionadas a seguir não estiverem visíveis para um perfil de integração na exibição padrão, você poderá selecionar a exibição de integração personalizada na guia Detalhes:
    • Modelos de software
    • Identificadores de assinatura não reconhecidos
    • Trabalhos agendados
    • Resultados de trabalhos programados
    • Assinaturas de Software
    • Regra de exclusão de identificador de assinatura
    • Regra de exclusão do usuário de assinatura

    Depois de criar um perfil de integração, você pode definir regras de exclusão de assinatura para manter determinadas assinaturas dos cálculos de custo de licença. Para obter mais informações, consulte Exclusões de assinatura para SaaS E aplicações SSO.

    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 do 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 os resultados de reconciliação no Workbench de licença ( Software Asset Management aplicação clássica) ou 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.