Configurar MID Web Server Autenticação de chave de API

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • Autenticar solicitações de entrada de clientes para MID Web Server Extensão usando autenticação de chave de API. A autenticação de API é uma maneira segura e simples de autenticar sua solicitação. Você pode criar ou modificar um MID Web Server Chave de API.

    Antes de Iniciar

    Crie um MID Web Server Extensão para usar autenticação de chave de API, conforme descrito em Configure o. MID Web Server extensão. Certifique-se de selecionar Chave de API nas extensões Tipo de autenticação campo.

    Função necessária: Event_mgmt_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Por padrão, o número máximo de chaves de API que você pode criar em uma instância é 10. Para mudar este número, modifique o. mid.webserver.max.api.keysValor da propriedade na página Propriedades do sistema.

    Ao trabalhar no domínio global enquanto a Separação de domínios está habilitada, as chaves de API ficam disponíveis para todas as extensões, independentemente do domínio. Ao trabalhar em um domínio específico, as chaves de API ficam disponíveis para extensões nesse domínio, seus domínios primários , e o domínio global.

    Você pode configurar chaves de API para expirar em uma data especificada.

    Ao criar uma nova extensão com autenticação de chave de API (ou atualizar uma existente para usar a autenticação de chave de API), o sistema verifica se há uma chave de API disponível para a extensão. Se não houver nenhuma chave de API disponível, o sistema criará uma.

    Procedimento

    1. Navegar até Tudo > MID Server > Perfis e implantações > Chave de API de servidor Web MID.
    2. Crie uma nova chave de API ou modifique uma chave de API existente .
      • Para criar uma nova chave de API:
        1. Selecione Novo.
        2. No formulário Chave de API do MID Web Server, preencha os campos.
          Tabela 1. MID Web Server Formulário Chave de API
          Campo Descrição
          Nome Nome da chave de API.
          Ativo Opção para ativar a chave de API.
          Chave de autenticação Valor codificado somente leitura da chave de autenticação. Nenhum valor aparece até que você configure a chave.
          Expira Opção para definir uma data de expiração para a chave de API.

          Chaves de API expiradas, desativadas ou excluídas não são aceitas pela extensão do servidor web.

        3. Selecione Enviar Para salvar a chave de API.

          A chave de API aparece na página Chaves de API do MID Web Server.

      • Para modificar uma chave de API existente:
        1. Navegar até MID Server > Perfis e implantações > Chave de API de servidor Web MID.
        2. Selecione uma chave de API na página.
        3. Em Links relacionados , selecione Exibir chave de API .
        4. Copie a chave de API que aparece na caixa de diálogo do MID Web Server.

          Ao se conectar a um MID Web Server Extensão configurada com autenticação de chave de API, coloque uma chave de API à qual a extensão tenha acesso no cabeçalho de autorização da solicitação no seguinte formato:

          Key <API_KEY>

          onde <API_KEY> É o valor da chave de API exibida após a seleção Exibir chave de API .
        5. Selecione Enviar.