# ServiceNow ![ServiceNow](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/marketplace-servicenow-logo-24.png) Automatize a sincronização ServiceNow — AD para um gerenciamento perfeito do ciclo de vida de usuários. **Provisionamento de identidade** **Gerenciamento de tickets** Sincronize o ServiceNow com o Active Directory usando o ADManager Plus. Com esta integração, as equipes de TI automatizam as tarefas de gerenciamento de identidade e acesso em todo o ambiente, simplificam o ciclo de vida dos usuários, otimizam procedimentos e administram colaboradores com mais eficiência. Essa integração simplifica o processo de solicitação de acesso dos usuários, reduz o trabalho manual, garante a alocação de recursos no tempo certo e reforça a conformidade e a segurança em toda a organização. ## Visão geral do produto ### Automatize o gerenciamento de identidade de usuários Automatize a criação, modificação e exclusão de usuários no AD, Exchange e M365 diretamente do console do ServiceNow. ### Gerenciamento de senhas simplificado Permita que os técnicos de help desk redefinam as senhas dos usuários finais, oferecendo maior controle e flexibilidade na administração de contas. ### Controle de contas de usuários Ative, desative ou desbloqueie contas de usuário bloqueadas sempre que necessário. ## Configuração ### Como configurar a integração ServiceNow no ADManager Plus O ADManager Plus oferece duas formas de integração com o ServiceNow: 1. **Widget**: Execute ações do Active Directory (AD) diretamente no console do ServiceNow. Clique [AQUI](https://www.manageengine.com/br/ad-manager/integrate-servicenow-with-admanagerplus.html) para saber mais sobre a integração do ADManager Plus com o ServiceNow. 2. **Integração via aplicação baseada em API:** Otimize o gerenciamento de tickets no ServiceNow importando periodicamente os tickets relevantes e executando as ações necessárias no ADManager Plus. O guia a seguir traz instruções passo a passo para configurar essa integração por aplicação baseada em API. **Pré-requisitos** Certifique-se de ter em mãos seu nome de usuário e sua senha do ServiceNow. Essas credenciais podem ser obtidas diretamente no console do ServiceNow e são indispensáveis para autenticar o processo de integração. **Privilégios** **Para importar usuários (ação de entrada):** a conta usada na autorização deve ter permissão para ler todas as contas de usuário. **Para executar qualquer ação ou consulta no ServiceNow (ação de saída):** a conta usada na autorização deve ter permissão para realizar a ação desejada. **Nota:** O ADManager Plus oferece um conjunto pré-configurado de APIs para efetuar as ações básicas da integração. Se precisar executar alguma ação não suportada por padrão, consulte a documentação de API do ServiceNow para obter os detalhes necessários para a configuração de webhooks de entrada e saída. ### Configuração de autorização 1. Faça login no ADManager Plus e acesse **Directory/Application Settings.** 2. Em **Application Integrations**, localize e selecione **ServiceNow.** 3. Ative a opção **Enable ServiceNow Integration.** 4. Na página Enable ServiceNow Integration, clique em **Authorization.** 5. Insira o nome de usuário e a senha do ServiceNow. 6. Clique em **Configure.** ### Configuração de webhook de entrada O webhook de entrada permite ao ADManager Plus obter dados de usuários diretamente do ServiceNow. O mapeamento de atributos configurado nesta seção pode ser selecionado como fonte de dados durante a [configuração de automações](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html) para executar a ação desejada na lista de usuários retornada pela resposta da API. Para configurar um webhook de entrada para o ServiceNow: 1. Em Inbound Webhook, clique em **ServiceNow Endpoint Configuration.** 2. Na aba **Endpoint Configuration**, você encontrará um endpoint pré-configurado ServiceNow USERS ENDPOINT, com campos para a **URL do endpoint, Método de API, Cabeçalhos** e **Parâmetros.** 3. Para usar este endpoint pré-configurado, substitua **{SERVICENOW-INSTANCE}** pelo nome da sua instância do ServiceNow e **{TABLE_NAME}** pelo nome da tabela de usuários correspondente (por exemplo, sys_user). Se desejar usar um novo endpoint para importar usuários, clique em **+ Add API endpoint** e preencha os campos obrigatórios conforme as [referências de API do ServiceNow](https://developer.servicenow.com/dev.do#!/reference/api/xanadu/rest/c_TableAPI). Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) para saber como. **Nota:** - O par chave-valor da API já vem pré-configurado como cabeçalho para autenticar as solicitações de API, conforme definido durante a **Configuração de Autorização.** - É possível adicionar macros na configuração do endpoint para alterá-lo dinamicamente por meio do componente de **seleção de macros.** - Consulte as [referências de API do ServiceNow](https://developer.servicenow.com/dev.do#!/reference/api/xanadu/rest/c_TableAPI) e configure cabeçalhos ou parâmetros, se necessário. 4. Após concluir, clique em **Test & Save.** A janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos pela chamada da API. Clique em **Proceed.** **Nota:** - Consulte as [referências de API do ServiceNow](https://developer.servicenow.com/dev.do#!/reference/api/xanadu/rest/c_TableAPI) para verificar quais **parâmetros** configurar e retornar apenas os dados desejados. - Clique em **+ Add API endpoint** para criar quantos endpoints forem necessários. Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) para saber como. 5. Clique em **Data Source - LDAP Attribute Mapping** para vincular endpoints e mapear atributos LDAP do AD aos atributos correspondentes no ServiceNow. (O ADManager Plus também permite personalizar o formato de atributos importados do ServiceNow.) 6. Clique em **+ Add New Configuration** e faça o seguinte: - Insira o **Nome da configuração** e a **Descrição**, e selecione a **Categoria de automação** no menu suspenso. - No campo **Select Endpoint**, escolha o endpoint desejado e defina uma **Chave primária** única para o usuário (por exemplo, employeeIdentifier). 7. [Configure uma automação](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html) informando a ação desejada, a frequência de repetição e o mapeamento de atributos criado acima. ### Configuração de webhook de saída O webhook de saída permite que você atualize as alterações feitas no AD usando o ADManager Plus para o ServiceNow ou busque ou encaminhe os detalhes necessários do ServiceNow e sincronize-os com o AD. Para configurar um webhook de saída para o ServiceNow: 1. Em *Outbound Webhook*, clique em **ServiceNow Webhook Configuration.** 2. Clique em **+ Add Webhook.** 3. Insira um nome e uma descrição para este webhook. 4. Defina a ação a ser executada e consulte as [referências de API do ServiceNow](https://developer.servicenow.com/dev.do#!/reference/api/xanadu/rest/c_TableAPI) para obter detalhes como URL, Cabeçalhos, Parâmetros e demais requisitos. 5. Selecione, no menu suspenso, o método HTTP que permitirá executar a ação desejada no endpoint. 6. Insira a URL do endpoint. 7. Configure os **Cabeçalhos, Parâmetros** e o **Tipo de mensagem** no formato apropriado para a chamada de API desejada. 8. Clique em **Test and Save.** 9. Uma janela pop-up exibirá uma lista de usuários e grupos do AD para testar a chamada de API configurada. Selecione o usuário ou grupo desejado para testar a chamada de API e clique em **OK.** Isso enviará uma solicitação em tempo real para a URL do endpoint e aplicará as modificações configuradas aos objetos selecionados. 10. Os detalhes da solicitação e da resposta do webhook serão exibidos. Verifique se a API está respondendo corretamente e clique em **Save.** 11. Os webhooks configurados podem ser incorporados a [Modelos de Orquestração](https://www.manageengine.com/products/ad-manager/help/orchestration/new-orchestration-template.html)—permitindo [automações agendadas](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html) ou [acionadas por eventos](https://www.manageengine.com/products/ad-manager/help/orchestration/orchestration-profile.html)—para que a ação definida no webhook de saída seja executada sequencialmente em um grupo de usuários ou em usuários individuais. **Nota:** use macros para enviar os dados do objeto no qual o webhook é executado. ## Ações compatíveis - Provisionar usuários - Redefinir senhas - Habilitar ou desabilitar contas de usuário no AD - Desbloquear contas de usuário no AD - Adicionar ou remover usuários de grupos - Definir ou revogar permissões de pastas - Excluir contas de usuário no AD ## Aplicações relacionadas - [Jira Service Management](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/jira-service-management-active-directory-integration-with-admanager-plus.html) - [ServiceDesk Plus](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/servicedesk-plus-active-directory-integration-with-admanager-plus.html) - [Halo ITSM](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/halo-active-directory-integration-with-admanager-plus.html) - [Zendesk](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/zendesk-active-directory-integration-with-admanager-plus.html) - [Zoho Desk](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/zoho-desk-active-directory-integration-with-admanager-plus.html)