Como criar a política de acesso de REST API

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura
  • Crie uma política de acesso de API e mapeie um perfil de autenticação para restringir o tipo de autenticação de uma REST API. Por exemplo, você pode criar uma política de acesso de API que permita somente a autenticação de token de ID para uma REST API.

    Antes de Iniciar

    Procedimento

    1. Navegar até Todos > Serviços web do sistema > Políticas de acesso de REST API.
    2. Clique em Nova.
    3. No formulário, preencha os seguintes campos.
      Campos da política de acesso de API
      Tabela 1. 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 Habilita a aplicação da política de autenticação a todos os métodos, versões e recursos para a API.
      Aplicar a todos os métodos Habilita a aplicação da política de autenticação para a API a todos os métodos, versões e recursos para a API.
      Aplicar a todos os recursos Habilita a aplicação da política de autenticação para a API a todas as versões.
      Aplicar a todas as versões Habilita a aplicação da política de autenticação para a API a todos os recursos.
      Nota:
      Para entender mais sobre a priorização da política de acesso de API, consulte Priorização da política de acesso de API.
    4. Clique duas vezes em Inserir uma nova linha.
    5. Selecione um perfil de autenticação de entrada na lista e clique no ícone de salvar ícone de salvar.
      Por exemplo, você pode adicionar Autenticação básica, Token de ID, Autenticação baseada em certificados, OAuth ou Autenticação de WSSE.
      1. Para adicionar um ou mais perfis de autenticação de entrada, clique em Novo para criar um novo perfil.
      2. Selecione Que tipo de perfis de autenticação?.
        • Criar perfis de autenticação HTTP padrão
        • Criar perfis de autenticação de WSSE
        perfil de autenticação
      3. Depois de criar o perfil de autenticação, salve o registro.
    6. Clique em Enviar para enviar a política de acesso de REST API.