Pular para o conteúdo

Criar uma conta API User

A conta API User é usada pelo Sophos Central para se comunicar com o Autotask.

Para criar uma conta API User, faça o seguinte:

  1. Inicie uma sessão no Autotask.
  2. Passe o mouse sobre o ícone Autotask e vá para Admin > Resources (Users).
  3. Em Resources, passe o mouse sobre New e selecione New API User.
  4. Em Add API User, sob General, digite os detalhes nos campos obrigatórios.

    1. Insira o nome de usuário e senha que o Sophos Central usará para acessar o Autotask.

      Nota

      Anote-os, pois serão necessários mais tarde.

    2. Clique em Active.

  5. Em Security Level, selecione API User (system).

  6. Em Credentials, clique em Generate Key.
  7. Em Credentials, clique em Generate Secret.

    Credenciais do Autotask.

  8. Em API Tracking Identifier, clique em Integration Vendor. Na caixa abaixo, selecione Sophos Central - Security.

  9. Clique em Save & Close. A conta é adicionada à lista de recursos.

    Salve o usuário da API.

Ativar webhooks

Ao criar uma conta de usuário da API, você deve ativar webhooks para que o usuário da API possa criar e gerenciar webhooks.

As etapas principais são as seguintes:

  1. Verifique qual perfil de segurança está atribuído ao usuário da API.
  2. Atualize o perfil de segurança ou crie um novo para ativar os webhooks.

Verificar o perfil de segurança

Para verificar qual perfil de segurança está atribuído ao usuário da API, faça o seguinte:

  1. No Autotask, passe o cursor sobre o ícone Autotask e vá para Admin > Company Settings & Users > Resources/Users (HR) > Resources/Users.
  2. Selecione o usuário da API que você criou anteriormente.
  3. Anote o nome atribuído em Security Levels.

Atualizar ou criar um novo perfil de segurança

Para atualizar ou criar um novo perfil de segurança para ativar webhooks, siga as instruções a seguir:

  1. No Autotask, passe o cursor sobre o ícone Autotask e vá para Admin > Company Settings & Users > Resources/Users (HR) > Security > Security Levels.
  2. Em Security Levels, encontre o nome do perfil de segurança que você anotou anteriormente.
  3. Clique em Edit e expanda a seção Other.
  4. Clique em Webhooks e insira o número máximo de webhooks que o usuário da API pode criar durante a vida útil da conta. O valor padrão é 50.
  5. Clique em Save & Close.

Nota

Você não pode editar alguns dos níveis de segurança do Autotask. Se precisar clonar e criar um novo Nível de Segurança para ativar Webhooks, você precisa editar o usuário da API e, dessa vez, selecionar o Nível de Segurança com acesso a Webhook.

Antes de alterar o usuário da API no Sophos para a integração do Autotask, certifique-se de que as credenciais usadas para gerenciar webhooks continuam ativas. Manter os webhooks ativos permite que a integração remova os webhooks associados ao usuário da API anterior.

Quando você altera o usuário da API para a integração do Autotask, isso cria automaticamente um novo webhook usando as credenciais do novo usuário da API, e removerá o webhook antigo. Se o webhook não for removido automaticamente, você deve remover manualmente o webhook criado para o usuário da API anterior.

Para remover manualmente o webhook antigo, reative o usuário da API anterior associado a ele e, em seguida, exclua o webhook, chamando pela API do Autotask ou entrando em contato com o Suporte da Kaseya para obter assistência.

Para obter mais informações sobre webhooks, consulte Webhooks.

Depois de criar uma conta de usuário da API, você deve ativar o fornecedor de integração Sophos Central - Security. Consulte Ativar o fornecedor de integração "Sophos Central - Security".