Box

Crawl documentos que são armazenados em uma fonte de dados da Caixa.

IBM Cloud Pak for Data IBM Software Hub

Essas informações se aplicam apenas a implementações instaladas. Para obter mais informações sobre conexão com o Box a partir de uma implementação gerenciada, consulte Caixa.

Quais documentos estão engatinados

  • Somente os documentos compatíveis com Discovery em suas pastas Box são rastreados; todos os outros são ignorados. Para obter mais informações, consulte Tipos de arquivos suportados.
  • A segurança de nível de documentos é suportada apenas para conectores configurados para usar o App + Enterprise Access como o nível de acesso app do aplicativo Box. Quando essa opção está ativada, seus usuários podem rastrear e consultar o mesmo conteúdo que podem acessar quando estão conectados ao Box. Para obter mais informações, consulte Apoiando a segurança de nível de documentos.
  • Quando uma fonte é rastreada novamente, novos documentos são adicionados, documentos atualizados são modificados para a versão atual e documentos excluídos são excluídos do índice da coleção.
  • Todos os conectores de origem de dados Discovery são de leitura. Independentemente das permissões que são concedidas à conta de crawl, Discovery nunca grava, atualiza ou exclui qualquer conteúdo na origem de dados original.
  • As notas do Box são armazenadas no formato JSON, portanto, o Discovery também ingere todas as notas do Box nas pastas especificadas.

Requisitos da origem de dados

Além dos requisitos de origem de dados para todas as implementações instaladas, sua origem de dados da Caixa deve atender ao seguinte requisito:

  • Você deve obter quaisquer licenças de serviço necessárias para a fonte de dados com a qual você deseja se conectar. Para obter mais informações sobre licenças, entre em contato com o administrador do sistema da fonte de dados.

Etapas de pré-requisito

Se você deseja habilitar a segurança de nível de documento, você deve tomar algumas etapas para configurá-lo. Para obter mais informações, consulte Sobre a segurança de nível de documento.

Você deve criar um aplicativo personalizado em Box antes de se conectar a Box a partir de Discovery. Qualquer um pode criar o app personalizado, mas apenas um administrador da Caixa pode autorizar.

Para criar um aplicativo personalizado, conclua as etapas a seguir:

  1. Certifique-se de que você tenha uma conta Box. Durante esse processo, você recebe o arquivo de configuração e o ID do cliente.

  2. Em seguida, crie um app personalizado que use Autenticação do Servidor com JWT como seu método de autenticação.

    Para obter etapas detalhadas, consulte Configuração com JWT na Documentação do desenvolvedor da Box.

    Siga estas diretrizes ao criar o app:

    1. Durante o procedimento de setup, escolha usar o método Autenticação do Servidor com JWT para verificar a identidade do aplicativo com um par de chaves.

    2. Escolha o nível de acesso apropriado para o conteúdo da Caixa que você deseja engatinhar:

      • Arquivos de caixa que são compartilhados com usuários gerenciados: App acesso mais acesso Corporativo
      • Arquivos de caixa que são compartilhados com a conta de serviço: App de acesso apenas
      • Arquivos de caixa que são compartilhados com a conta de serviço e seus usuários do app: App de acesso apenas

      O suporte para configurar o acesso ao nível da Caixa com acesso App apenas foi adicionado com a liberação 4.6.

    3. Configure o nível de acesso seguindo as etapas apropriadas para o seu tipo de nível de acesso ao app:

      • acesso do App mais o acesso Corporativo

        Escolha os seguintes escopos de aplicativos:

        • Ler todas as pastas armazenadas no Box
        • Gravar todas as pastas armazenadas no Box
        • Gerenciar usuários

        Habilite o seguinte recurso avançado:

        • Gerar tokens de acesso do usuário

      • Apenas acesso ao App

        Para engatinhar arquivos que são compartilhados com apenas a conta de serviço, complete as seguintes etapas:

        1. Escolha os seguintes escopos de aplicativos:

          • Ler todas as pastas armazenadas no Box
          • Gravar todas as pastas armazenadas no Box

        2. Compartilhe as pastas e arquivos do Box de destino com a conta de serviço, completando as seguintes etapas:

          1. A partir da página Configurações Gerais, copie o e-mail para o ID da conta de serviço.
          2. Ao logado como um usuário gerenciado, compartilhe a pasta ou arquivos que deseja que o conector seja capaz de engatinhar.
          3. Inclua o e-mail de ID da conta de serviço como a pessoa a convidar para compartilhar os arquivos.

          Para obter mais informações, consulte a documentação do Box.

        Para engatinhar arquivos que são compartilhados com a conta de serviço e seus usuários do app, preencha as seguintes etapas:

        1. Escolha os seguintes escopos de aplicativos:

          • Ler todas as pastas armazenadas no Box
          • Gravar todas as pastas armazenadas no Box
          • Gerenciar usuários

        2. Habilite o seguinte recurso avançado:

          • Gerar tokens de acesso do usuário

        3. Compartilhe as pastas e arquivos do Box de destino com os usuários do app apropriados.

          Para obter mais informações, consulte a documentação do Box.

  3. Criar chaves para autenticação. Certifique-se de concluir as tarefas a seguir:

    1. A partir da página Configurações gerais, clique em Adicionar uma Chave Pública.
    2. Salve o arquivo de configuração baixado que é gerado para a chave privada.
    3. Clique em Salvar Mudanças.
    4. A partir da página Configuração, copie o valor ID do Cliente.

  4. Em seguida, você deve pedir a um administrador do Box para autorizar o app. No console do administrador do Box, conclua as tarefas a seguir:

    1. Na página Apps> Custom Apps Manager, clique em Adicionar App.

    2. Digite o ID do cliente e clique em Next.

      Para obter mais informações, consulte Aprovação de App personalizado.

  5. Etapa do administrador da caixa: A partir do console admin da Caixa, verifique se as informações do app são precisas e, em seguida, clique em Autorizar.

Como conectar à fonte de dados da Caixa

Em seu projeto Discovery, conclua as seguintes etapas:

  1. A partir da pane de navegação, escolha Gerenciar coleções.

  2. Clique em New collection (Nova coleção ).

  3. Clique em Box e, em seguida, clique em Next.

  4. Nomeia a coleção.

  5. Se a linguagem dos documentos em Box não for o inglês, selecione a linguagem apropriada.

    Para obter uma lista de idiomas suportados, consulte Suporte ao idioma.

  6. Opcional. Alterar o cronograma de sincronização.

    Para obter mais informações, consulte Opções de planejamento de Crawl.

  7. Na seção Digite suas credenciais, clique em Selecionar arquivo e, em seguida, navegue para encontrar o arquivo de configuração que foi gerado e baixado quando adicionou a chave pública como parte das etapas do pré-requisito.

    Você pode fazer o download de um arquivo de configuração novamente a partir da página de configuração no site do Developer Box.

  8. Opcional. Na seção Especifique o que você deseja engatinhar, escolha um conteúdo de usuário específico ou uma pasta específica com conteúdo que deseja engatinhar. Se você não especificar nada, o serviço engatinha todo o conteúdo que está disponível para o app personalizado.

    • Para efetuar crawl de uma empresa inteira, insira box://app.box.com/.

    • Para rastrear uma pasta específica, digite box://app.box.com/user/USER'S_ACCOUNT_ID/folder/FOLDER_ID/FolderName.

      Por exemplo,box://example.app.box.com/user/460250779/folder/158001591642/My Folder

    • Para rastrear um usuário específico, digite box://app.box.com/user/USER'S_ACCOUNT_ID/.

  9. Opcional: Se você estiver usando um servidor proxy para acessar o servidor de origem de dados, então na seção Configurações de Proxy, configure o comutador Ativar configurações de proxy para On. Inclua valores nos seguintes campos:

    Nome do usuário
    Opcional. O nome de usuário que você usa para autenticar, se o servidor proxy exigir autenticação. Se você não souber o nome do usuário, será possível obtê-lo junto ao administrador do servidor proxy.
    Senha
    Opcional. A senha que você usa para autenticar, se o servidor proxy exigir autenticação. Se você não souber a senha, será possível obtê-la junto ao administrador do servidor proxy.
    Nome do host ou endereço IP do servidor proxy
    O nome do host ou o endereço IP do servidor proxy.
    Número da porta do servidor proxy
    A porta de rede à qual você deseja se conectar no servidor proxy.

  10. Opcional. Se você deseja ativar a segurança de nível de documento, na seção Segurança, configure o comutador Ativar Segurança de Nível de Documento para On.

    Quando essa opção está ativada, seus usuários podem rastrear e consultar o mesmo conteúdo que podem acessar quando estão conectados ao Box. Para obter mais informações, consulte Apoiando a segurança de nível de documentos.

  11. Se você deseja que o crawler extraia texto a partir de imagens no site, expanda Mais configurações de processamentoe configure Aplicar reconhecimento de caracteres ópticos (OCR) a On.

    Quando o OCR é ativado e seus documentos contêm imagens, o processamento demora mais. Para obter mais informações, consulte Reconhecimento de caracteres Ópticos.

  12. Clique em Finish.

A coleção é criada rapidamente. É preciso mais tempo para que os dados sejam processados conforme ele é adicionado à coleção.

Se você quiser verificar o progresso, acesse a página Atividade. A partir da pane de navegação, clique em Gerenciar coleções e, em seguida, clique para abrir a coleção.