Configurar HMAC - Autenticação baseada em token

Configure o HMAC para oferecer suporte à autenticação de endpoints da REST API.

Antes de Iniciar

Função necessária: administrador

Plug-in necessário: chave de API e autenticação HMAC (com.glide.tokenbased_auth)

Procedimento

1. Crie uma configuração do HMAC.
   1. Navegar até Tudo > Serviços web do sistema > Políticas de acesso de API > Configuração de HMAC.
   2. Selecione Novo.
      Nota:

      Você também pode usar a codificação HMAC SHA256 Base64 padrão, criada durante a instalação do plug-in.
   3. No formulário, preencha os campos:

      Tabela 1. Configuração de HMAC

      Campo	Descrição
      Nome	Nome da configuração do HMAC.
      Aplicação	Escopo da configuração.
      Descrição	Descrição detalhada sobre a configuração.
      Algoritmo de hash	Escolha o Algoritmo de hash. Opções disponíveis: HmacSHA256 HmacSHA384 HmacSHA512
      Script do utilitário do HMAC	Script de utilitário para HMAC.

      
   4. Envie o registro.
2. Crie um perfil de autenticação de entrada.
   1. Navegar até Tudo > Serviços web do sistema > Políticas de acesso de API > Perfis de autenticação de entrada.
   2. Selecione Novo.
      O sistema exibe a mensagem Que tipo de perfil de autenticação?
   3. Selecione Criar perfis de autenticação HMAC.
      
   4. No formulário, preencha os campos.

      Tabela 2. Perfis de autenticação HMAC

      Campo	Descrição
      Nome	Nome para identificar a política de autenticação.
      Aplicação	Escopo da política de autenticação.
      Configuração do HMAC	Selecione a configuração do HMAC que foi criada.
      Parâmetro de autenticação	Selecione o parâmetro de autenticação para a solicitação de autenticação. Você pode selecionar as opções padrão ou criar um novo parâmetro de autenticação: x-sn-hmac-signature-256: cabeçalho de autenticação x-sn-hmac-signature-256: cabeçalho de parâmetro de consulta
      ID de chave padrão do segredo compartilhado	As informações de token que podem ser atualizadas neste campo para usar o HMAC.

      Nota:

      A opção selecionada deve ser definida na chamada REST como parte do cabeçalho de autenticação ou do parâmetro de consulta.
   5. Envie o formulário.
3. Crie um segredo do HMAC.
   1. Navegar até Tudo > Serviços web do sistema > Políticas de acesso de API > Segredo do HMAC da REST API.
   2. Selecione Novo.
   3. No formulário, preencha os campos:

      Tabela 3. Segredo do HMAC da REST API

      Campo	Descrição
      Nome	Nome para identificar o segredo do HMAC da REST API.
      Descrição	Descrição do segredo do HMAC da REST API.
      Ativo	Status do segredo do HMAC da REST API.
      Usuário	Usuário associado ao segredo HMAC da REST API. Use o ícone de pesquisa para selecionar o usuário.
      ID da chave	ID de chave que deve ser enviado como parte da chamada REST. O ID da chave é gerado após o envio do formulário.
      Segredo compartilhado	Segredos compartilhados do usuário. Por exemplo, a senha.
      Origem	Origem do registro.

   4. Envie o formulário.
   5. Abra o registro que foi criado.

      Encontre o ID da chave gerado pelo Now Platform para o usuário

      .

      Nota:

      Você pode adicionar o ID da chave que foi gerado durante o ID da chave no perfil de autenticação que foi criado para o HMAC se não quiser especificar o parâmetro Auth ou Query para a chamada de API.
4. Crie uma política de acesso de REST API.
   1. Navegar até Tudo > Serviços web do sistema > Políticas de acesso de REST API.
   2. Selecione Novo.
   3. No formulário, preencha os campos.

      Tabela 4. Políticas de acesso de API

      Campo	Descrição
      Nome	Nome exclusivo da política de acesso de API.
      Ativo	Opção para ativar a política de acesso de API.
      REST API	A REST API à qual a política de acesso é aplicada. Por exemplo, API de anexos.
      REST API PATH	Caminho da API da REST API. Esse campo é preenchido automaticamente com base na REST API selecionada. Por exemplo, now/attachment.
      Método HTTP	Método usado para interagir com a API. Esse campo é preenchido automaticamente com base na REST API selecionada.
      Versão	Versão da API. Por exemplo, v1. Esse campo é preenchido automaticamente com base na REST API selecionada. Nota: Se você quiser criar uma política de autenticação para todas as versões de uma REST API, deverá criar políticas individuais para cada versão.
      Recurso	Recurso secundário da REST API. Esse campo é preenchido automaticamente com base na REST API selecionada. Por exemplo, /now/attachment.
      Aplicação	Escopo da aplicação.
      Global	Habilite este campo para aplicar a política de autenticação a todos os métodos, versões e recursos da API. Nota: A autenticação baseada em token não é permitida na política da REST API global.
      Aplicar a todos os métodos	Habilite este campo para aplicar a política de autenticação da API a todos os métodos, versões e recursos da API.
      Aplicar a todos os recursos	Habilite este campo para aplicar a política de autenticação da API a todas as versões.
      Aplicar a todas as versões	Habilite este campo para aplicar a política de autenticação da API a todos os recursos.

   4. Adicione o perfil de autenticação de API que foi criado.
      
   5. Envie o formulário.
      Você pode enviar a chamada de REST API:

      • Com o x-sn-hmac-signature-256 que foi gerado por ServiceNow® durante a criação da chave de API no cabeçalho ou no parâmetro de consulta com base na configuração para autenticação.
      • Com o Script de pré-solicitação com segredo compartilhado especificado como parte da solicitação.

      Aviso:

      Use a solicitação POST ao enviar informações confidenciais para o servidor.