Dicas para escrever integrações

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura
  • Evite algumas das dificuldades que você pode encontrar ao escrever suas próprias integrações, seguindo estas diretrizes.

    Use a funcionalidade da plataforma ServiceNow sempre que possível

    Em sua maioria, as capacidades de integração integradas nas aplicações [ Security Operations (Security Incident Response, Inteligência contra ameaçase Vulnerability Response) têm como objetivo aprimorar ou simplificar a funcionalidade de integração da plataforma ServiceNow existente. Ao escrever integrações, sempre use a funcionalidade da plataforma quando ela existir. Estas são algumas funcionalidades ServiceNow comuns que podem ser usadas em vez de "criar o seu próprio".

    • Serviços Web de saída - para a maioria das interações com sistemas de terceiros, a comunicação é por meio de serviços Web. Nesses casos, utilize os serviços Web de saída da plataforma (REST e SOAP são compatíveis).
    • Fontes de dados/conjuntos de importação/mapa de transformação – para processar dados e inserir em tabelas ServiceNow, o mecanismo preferencial é usar fontes de dados e componentes associados.

    Use estruturas de integração do Security Operations sempre que possível

    Como os mecanismos de integração Security Operations resolveram muitos problemas comuns, não é necessário reimplementar as funcionalidades básicas para cada integração. Por exemplo, os dados de vulnerabilidade e as estruturas de origem da ameaça oferecem suporte à manipulação de várias páginas e à passagem desses dados para fontes de dados/transformações/conjuntos de importação. Da mesma forma, a estrutura de origem de verificação ou pesquisa fornece funcionalidade de limitação de taxa configurável. Como regra, ao implementar um recurso ou conjunto de recursos, verifique se a estrutura de integração Security Operations existente cobre seu caso de uso. Em caso afirmativo, use essa estrutura.

    Estenda as estruturas de integração do Security Operations existentes conforme necessário

    A maioria das tabelas e scripts usados pelas estruturas de integração Security Operations foram estendidas para atender às necessidades futuras. Se um caso de uso for encontrado enquanto você estiver gravando uma integração, estenda uma tabela de integração ou script para melhor atender a esse caso de uso.

    Forneça feedback para a ServiceNow sobre problemas encontrados durante a integração

    Conforme uma integração está sendo desenvolvida ou testada, forneça feedback quando forem encontrados problemas. Mesmo que uma solução alternativa seja necessária, a equipe de Suporte e atendimento ao cliente pode fornecer uma melhoria em versões futuras que podem atenuar o problema para integrações futuras.

    Testar com carga razoável

    Um problema comum com integrações é que elas não estão preparadas para lidar com cargas realistas. Como cada integração é uma aplicação com escopo, há mais limitações impostas pela plataforma para garantir a estabilidade do sistema. Essas limitações podem resultar no encerramento de trabalhos de longa execução ou de chamadas de API. Você pode garantir que processos de longa execução ou processos que processam muitos dados sejam tratados normalmente, reduzindo o tempo que cada chamada ou processo leva (geralmente fornecendo um meio de paginar solicitações de API ou agrupando grandes conjuntos de dados).