# Symphony AI ![Symphony AI](https://www.manageengine.com/active-directory-360/marketplace/images/logos/marketplace-symphonyai-logo-24.png) ## Otimize o gerenciamento de usuários com a integração do SymphonyAI e do AD **Categoria:** Provisionamento de identidade O SymphonyAI é uma plataforma orientada por IA que ajuda organizações a otimizar processos de negócios, fornecendo soluções preditivas e generativas para análise de dados, automação e tomada de decisões, resultando em maior eficiência operacional e insights. Sua integração com o ADManager Plus permite que as organizações sincronizem as alterações de criação de usuários no AD, Exchange, Microsoft 365 e outras aplicações. Ao conectar o SymphonyAI ao AD usando o ADManager Plus, as organizações têm uma abordagem simplificada para automatizar o gerenciamento do ciclo de vida do usuário e a tomada de decisões baseada em dados. ### Criação de usuário automatizada Crie automaticamente contas de usuário no AD, Exchange e Microsoft 365 com base em dados e gatilhos gerados no SymphonyAI. ### Sincronização bidirecional Configure os workflows do ADManager Plus para garantir que as mudanças do usuário no Active Directory e no SymphonyAI sejam sincronizadas de forma consistente em todos os sistemas integrados, permitindo fluxos de dados precisos e atualizados em ambas as direções. ## Como integrar o ADManager Plus e o Symphony ### Pré-requisitos Certifique-se de fornecer o [bearer token](https://eitdocs.atlassian.net/wiki/spaces/TAHSP3/pages/24973288/API+Authentication+and+Authorization) para acessar as informações desejadas e executar tarefas no Symphony AI. Consulte as [referências de API do Symphony AI](https://eitdocs.atlassian.net/wiki/spaces/TAHSP3/pages/24973288/API+Authentication+and+Authorization) para mais detalhes. ### Privilégios - **Importar usuários (ação de entrada):** A conta utilizada na autorização deve ter permissão para ler todas as contas de usuário. - **Executar ações ou consultas (ação de saída):** A conta usada 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 a ação que você precisa não estiver disponível, consulte a referência de API da Symphony AI para obter os detalhes necessários para configurar webhooks de entrada/saída e executar as ações requeridas. ## Configuração de autorização 1. Faça login no ADManager Plus e acesse a guia **Automation**. 2. No painel esquerdo, em Configuration, clique em **Application Integrations**. 3. Em Enterprise Applications, clique em **Symphony AI**. 4. Ative o botão **Enable Symphony AI Integration**. 5. Na página Symphony AI Configuration, clique em **Authorization**. 6. Execute as [etapas para gerar o bearer token no Symphony AI](https://eitdocs.atlassian.net/wiki/spaces/TAHSP3/pages/24973288/API+Authentication+and+Authorization) e cole o token no **campo Value**. 7. Clique em **Configure**. ## Configuração de webhook de entrada O webhook de entrada permite ao ADManager Plus obter dados de usuários diretamente do Symphony AI. O mapeamento de atributos definido aqui poderá ser selecionado como fonte de dados ao [configurar automatizações](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html). ### Etapas 1. Em Inbound Webhook, clique em **Symphony AI Endpoint Configuration**. 2. Na guia Endpoint Configuration, você encontrará um endpoint pré-configurado (ENDPOINT DE USUÁRIOS do Symphony AI) com campos **URL do endpoint, Método de API, Cabeçalhos e Parâmetros** para obter contas de usuário. - Substitua **{Customer_URL}** pelo URL da sua instância Symphony AI no campo Endpoint URL. - Para usar um novo endpoint, clique em **+ Add API endpoint** e preencha os campos obrigatórios conforme as [referências de API do Symphony AI](https://eitdocs.atlassian.net/wiki/spaces/TAHSP3/pages/24973288/API+Authentication+and+Authorization). - Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) para saber como configurar. **Notas:** - O par chave-valor da API já vem pré-configurado como cabeçalho conforme definido na **Configuração de Autorização**. - É possível adicionar macros para alterar dinamicamente o endpoint. - Configure cabeçalhos e parâmetros adicionais conforme necessário. 3. Após concluir, clique em **Test & Save**. - A janela de resposta exibirá os parâmetros retornados pela API. - Verifique os dados e clique em **Proceed**. **Notas:** - Consulte as [referências de API do Symphony AI](https://eitdocs.atlassian.net/wiki/spaces/TAHSP3/pages/24973288/API+Authentication+and+Authorization) para configurar parâmetros específicos. - É possível configurar múltiplos endpoints usando **+ Add API endpoint**. Saiba mais [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html). 4. Clique em **Data Source - LDAP Attribute Mapping** para vincular endpoints e mapear atributos LDAP. 5. Clique em **+ Add New Configuration** e: - Insira o **Nome da configuração** e a **Descrição**. - Selecione a **Categoria de automação**. - Em **Select Endpoint**, escolha o endpoint desejado e uma **Chave primária** exclusiva (ex.: employeeIdentifier). > **Nota:** Quando múltiplos endpoints estiverem configurados, a chave deve manter o mesmo valor em todos eles. - Em **Attribute Mapping**, associe o atributo LDAP ao correspondente no Symphony AI. - Para criar um novo formato personalizado, clique em **Add New Format**. - Clique em **Save**. ## Configuração de webhook de saída Webhooks de saída permitem enviar alterações feitas no AD para o Symphony AI e executar tarefas diretamente pelo ADManager Plus. Eles podem ser incluídos em [Modelos de orquestração](https://www.manageengine.com/products/ad-manager/help/orchestration/new-orchestration-template.html), usados em [automações acionadas por eventos](https://www.manageengine.com/products/ad-manager/help/orchestration/orchestration-profile.html) e [automações agendadas](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html), ou aplicados diretamente em: **Management > Advanced Management > Orchestration** ### Etapas 1. Em Outbound Webhook, clique em **Symphony AI Webhook Configuration**. 2. Clique em **+ Add Webhook**. 3. Insira um nome e uma descrição. 4. Consulte as [referências de API do Symphony AI](https://eitdocs.atlassian.net/wiki/spaces/TAHSP3/pages/24973288/API+Authentication+and+Authorization) para obter detalhes como URL, cabeçalhos e parâmetros. 5. Selecione o método HTTP apropriado. 6. Insira a URL do endpoint. 7. Configure **cabeçalhos, parâmetros** e o **tipo de mensagem** conforme a API. 8. Clique em **Test and Save**. 9. Na janela pop-up, selecione usuários ou grupos do AD para testar a chamada e clique em **OK**. 10. Verifique os detalhes da solicitação e resposta. Se estiver correto, clique em **Save**.