# CloudBees

![CloudBees](https://www.manageengine.com/active-directory-360/marketplace/images/logos/marketplace-cloudbees-logo-24.png)

## Automatize a criação de usuários com a integração do CloudBees e do AD

**Categoria:** Provisionamento de identidade

O CloudBees é uma plataforma DevOps de nível empresarial que ajuda as organizações a simplificar o desenvolvimento e a entrega de software, automatizando e gerenciando processos de CI/CD de integração contínua. A automação da criação de usuários e a sincronização dos detalhes dos usuários entre o CloudBees e o AD garantem que as equipes de desenvolvimento possam acessar rapidamente as ferramentas necessárias para colaborar e gerenciar os processos de integração e entrega contínuas, enquanto as equipes de TI podem manter dados de usuários precisos e seguros em toda a organização.

### Criação automatizada de contas de usuário

Quando um novo usuário é adicionado ao CloudBees, o ADManager Plus cria automaticamente a conta de usuário correspondente no AD, bem como em sistemas relacionados, como o Exchange e o Microsoft 365, e garante que os funcionários tenham acesso oportuno aos recursos de que precisam desde o momento em que seu processo de onboarding é feito no CloudBees.

### Sincronização de dados de usuários

Garante que os registros de usuários permaneçam consistentes e precisos em todas as plataformas. Todas as atualizações das informações de usuários no AD, como mudanças de funções, departamentos ou informações de contato, são automaticamente sincronizadas com o CloudBees.

## Como integrar o ADManager Plus e o CloudBees

**Pré-requisitos:**

Certifique-se de fornecer o [token de portador](https://docs.cloudbees.com/docs/cloudbees-feature-management-rest-api/latest/introduction) para recuperar as informações desejadas e executar tarefas no CloudBees. Consulte as [referências de API do CloudBees](https://docs.cloudbees.com/docs/cloudbees-feature-management-rest-api/latest/introduction) para obter mais detalhes.

**Privilégios:**

- Para importar usuários (ação de entrada): Certifique-se de que a conta usada para autorização tenha permissão para ler todas as contas de usuário.
- Para executar qualquer ação ou consulta no CloudBees (ação de saída): Certifique-se de que a conta usada para autorização tenha permissão para executar a ação desejada.

**Observação:** O ADManager Plus vem com um conjunto pré-configurado de APIs que ajuda a executar ações básicas com a integração. Se a ação que você deseja não estiver disponível, obtenha os detalhes necessários da API na documentação de API do CloudBees para configurar webhooks de entrada/saída para executar as ações necessárias.

## Configuração de autorização

1. Efetue login no ADManager Plus e navegue até a aba **Automation**.
2. No painel esquerdo, em Configuration, clique em **Application Integrations**.
3. Em Enterprise Applications, clique em **CloudBees**.
4. Ative o botão **Enable CloudBees Integration**.
5. Na página CloudBees Configuration, clique em **Authorization**.
6. Execute as [etapas para gerar o token do portador no CloudBees](https://docs.cloudbees.com/docs/cloudbees-feature-management-rest-api/latest/introduction) e cole o token do portador no **Value field**.
7. Clique em **Configure**.

## Configuração do webhook de entrada

O webhook de entrada permite buscar dados de usuário do CloudBees para o ADManager Plus. O mapeamento de atributos configurado nesta seção pode ser selecionado como a fonte de dados durante a [configuração da automação](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html).

Para configurar um webhook de entrada para o CloudBees:

1. Em Inbound Webhook, clique em **CloudBees Endpoint Configuration**.
2. Na aba Endpoint Configuration, um endpoint, **CloudBees USERS ENDPOINT**, vem pré-configurado com campos **Endpoint URL, API Method, Headers e Parameters** para buscar contas de usuários do CloudBees.

   **Observação:**

   - O par de valores de chave de API é pré-configurado como um cabeçalho para autenticar solicitações de API, conforme configurado durante a **Authorization Configuration**.
   - Macros: Você pode adicionar macros à configuração de seu endpoint para mudá-lo dinamicamente conforme sua necessidade usando o componente macro chooser.
   - Consulte as [referências de API do CloudBees](https://docs.cloudbees.com/docs/cloudbees-feature-management-rest-api/latest/introduction) e configure cabeçalhos e parâmetros adicionais, se necessário.

3. Clique em **Test & Save**. Uma janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos usando a chamada de API. Após verificar se os parâmetros solicitados foram chamados à ação, clique em **Proceed**.

   **Observação:**

   - Consulte as [referências de API do CloudBees](https://docs.cloudbees.com/docs/cloudbees-feature-management-rest-api/latest/introduction) para saber os **Parameters** que devem ser configurados para buscar apenas parâmetros específicos.
   - Você pode configurar vários endpoints para o CloudBees usando o botão **+ Add API endpoint**. Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) para saber como.

4. Clique em **Data Source - LDAP Attribute Mapping** para corresponder endpoints e mapear os atributos LDAP do AD com os respectivos atributos no CloudBees.
5. Clique em **+ Add New Configuration** e faça o seguinte:
   - Digite o **Configuration Name** e a **Description** e selecione a **Automation Category** no menu suspenso.
   - No **Select Endpoint field**, selecione o endpoint desejado e uma **Primary Key** que seja exclusiva de um usuário (por exemplo, employeeIdentifier).

     **Observação:** Quando vários endpoints são configurados, esse atributo deve ter o mesmo valor em todos os endpoints.

   - No campo **Attribute Mapping**, selecione o atributo no menu suspenso LDAP Attribute Name e mapeie-o com o respectivo atributo no CloudBees.
   - Se você quiser criar um novo formato personalizado para isso, clique em **Add New Format**.
   - Clique em **Save**.

## Configuração do webhook de saída

O webhook de saída permite que você envie mudanças feitas no AD para o CloudBees e execute tarefas no CloudBees — tudo a partir do ADManager Plus.

Os webhooks configurados nesta seção podem ser incluídos nos [modelos de orquestração](https://www.manageengine.com/products/ad-manager/help/orchestration/new-orchestration-template.html), que, por sua vez, podem ser usados durante [automações programadas](https://www.manageengine.com/products/ad-manager/help/orchestration/orchestration-profile.html) e [orientadas por eventos](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html). Eles também podem ser aplicados diretamente nos usuários desejados para executar uma sequência de ações neles (**Management > Advanced Management > Orchestration**).

Para configurar webhooks de saída para o CloudBees:

1. Em Outbound Webhook, clique em **CloudBees Webhook Configuration**.
2. Clique em **+ Add Webhook**.
3. Digite um nome e uma descrição para esse webhook.
4. Decida a ação que deve ser executada e consulte as [referências de API do CloudBees](https://docs.cloudbees.com/docs/cloudbees-feature-management-rest-api/latest/introduction) para obter os detalhes da API, como URL, cabeçalhos, parâmetros e outros requisitos que serão necessários.
5. Selecione o método HTTP que permitirá que você execute a ação desejada no endpoint no menu suspenso.
6. Digite o URL do endpoint.
7. Configure **Headers**, **Parameters** e **Message Type** no formato apropriado com base na chamada de API que você gostaria de executar.
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 sobre o qual essa solicitação de API deve ser testada e clique em **OK**. Isso fará uma chamada em tempo real para o URL do endpoint e os objetos selecionados serão modificados de acordo com a configuração.
10. A resposta do webhook e os detalhes da solicitação serão exibidos. Verifique se eles correspondem ao comportamento esperado da API e clique em **Save**.

## Aplicações relacionadas

- [Github](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/github-active-directory-integration-with-admanager-plus.html)
- [Bitbucket](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/bitbucket-active-directory-integration-with-admanager-plus.html)
- [Jira Service Management](https://www.manageengine.com/active-directory-360/marketplace/admanager-plus/jira-service-management-active-directory-integration-with-admanager-plus.html)
- [SonarCloud](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/sonarcloud-active-directory-integration-with-admanager-plus.html)
- [Buildkite](https://www.manageengine.com/active-directory-360/marketplace/admanager-plus/buildkite-active-directory-integration-with-admanager-plus.html)

## Produtos relacionados

- [ADManager Plus](https://www.manageengine.com/br/ad-manager/index.html?src=ad360-related-products-br)
- [Exchange Reporter Plus](https://www.manageengine.com/br/exchange-reports/index.html?src=ad360-related-products-br)
- [RecoveryManager Plus](https://www.manageengine.com/br/ad-recovery-manager/index.html?src=ad360-related-products-br)
- [ADAudit Plus](https://www.manageengine.com/br/active-directory-audit?src=ad360-related-products-br)
- [EventLog Analyzer](https://www.manageengine.com/products/eventlog/index.html?src=ad360-related-products)
- [SharePoint Manager Plus](https://www.manageengine.com/br/sharepoint-management-reporting/index.html?src=ad360-related-products)
- [ADSelfService Plus](https://www.manageengine.com/br/self-service-password?src=ad360-related-products-br)
- [DataSecurity Plus](https://www.manageengine.com/br/data-security?src=ad360-related-products-br)
- [M365 Manager Plus](https://www.manageengine.com/br/microsoft-365-management-reporting?src=ad360-related-products-br)