Este guia mostra como configurar a integração entre a Segura® Platform e ServiceNow usando a API REST.
Requisitos
- URL da instância do ServiceNow.
- Dados de autenticação para um dos dois métodos suportados:
- OAuth 2.0 (Client Credentials) (recomendado): Client ID e Client Secret.
- Basic (usuário e senha): Usuário e Senha.
Configurar o ServiceNow
- Na Segura® Platform, na barra de navegação, passe o mouse sobre o Menu de produtos e selecione Configurações.
- No menu lateral, selecione Integrações > ITSM > Conexões ITSM.
- No relatório Conexões ITSM, clique no botão + Adicionar.
- Na janela Cadastro de integração com sistema de ticket, clique no botão ServiceNow.
- Na aba Geral, complete os campos:
- Nome da conexão *: nome da integração na Segura® Platform.
- URL da instância *: URL da instância do ServiceNow.
- Descrição: descrição opcional da integração.
- Ativo: selecione Sim para habilitar a conexão.
- Clique em Continuar.
- Na aba Autenticação, selecione o Método de autenticação *. As opções são OAuth 2.0 (Client Credentials) ou Basic (usuário e senha).
- Preencha os campos de acordo com o método selecionado:
- Para OAuth 2.0 (Client Credentials): preencha os campos Client ID e Client Secret.
- Para Basic (usuário e senha): preencha os campos Usuário e Senha.
- Clique em Continuar.
- Na aba Comportamento, defina os parâmetros operacionais:
- Timeout de conexão (segundos)
- Timeout de leitura (segundos)
- Máximo de tentativas
- TTL do cache de validação (segundos)
- Intervalo de health check (minutos)
- Clique em Continuar.
- Na aba Fallback, selecione o comportamento desejado em caso de indisponibilidade do ITSM:
- Negar acesso quando o ITSM estiver inacessível
- Permitir apenas acesso emergencial (break-glass)
- Permitir acesso e registrar para auditoria posterior
- Se necessário, clique em Testar conexão para validar a configuração.
- Clique em Continuar.
- Na aba Revisão, confira as informações configuradas.
- Clique em Salvar.
Disponibilizar a conexão para uso
Criar uma conexão ITSM não a coloca em uso automaticamente. Escolha uma das opções a seguir:
- Defini-la como padrão global: acesse Configurações > Integrações > ITSM > Conexões ITSM e selecione esta conexão como padrão. As políticas de acesso que não especificam sua própria conexão usam esta.
- Sobrescrevê-la para uma política de acesso específica: na aba Aprovadores da política de acesso, selecione esta conexão no campo Conexão ITSM. Isso tem precedência sobre o padrão global para essa política.
Info
A integração com ServiceNow usa o endpoint /api/now/table/ e o fluxo de aprovação aceita solicitações apenas para tickets com status Em andamento.