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:
- Inicie uma sessão no Autotask.
- Passe o mouse sobre o ícone Autotask e vá para Admin > Resources (Users).
- Em Resources, passe o mouse sobre New e selecione New API User.
-
Em Add API User, sob General, digite os detalhes nos campos obrigatórios.
-
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.
-
Clique em Active.
-
-
Em Security Level, selecione API User (system).
- Em Credentials, clique em Generate Key.
-
Em Credentials, clique em Generate Secret.
-
Em API Tracking Identifier, clique em Integration Vendor. Na caixa abaixo, selecione Sophos Central - Security.
-
Clique em Save & Close. A conta é adicionada à lista de recursos.
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:
- Verifique qual perfil de segurança está atribuído ao usuário da API.
- 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:
- No Autotask, passe o cursor sobre o ícone Autotask e vá para Admin > Company Settings & Users > Resources/Users (HR) > Resources/Users.
- Selecione o usuário da API que você criou anteriormente.
- 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:
- No Autotask, passe o cursor sobre o ícone Autotask e vá para Admin > Company Settings & Users > Resources/Users (HR) > Security > Security Levels.
- Em Security Levels, encontre o nome do perfil de segurança que você anotou anteriormente.
- Clique em Edit e expanda a seção Other.
- 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.
- 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".