• Overview
  • Configuração

Chargebee

Automatize o gerenciamento de usuários com a integração Chargebee e ADManager Plus

Provisionamento de identidade

O Chargebee é uma plataforma de gerenciamento e faturamento de assinaturas projetada para ajudar organizações a automatizar o faturamento recorrente, o gerenciamento do ciclo de vida da assinatura e as operações de receita. Ao integrar o Chargebee ao ADManager Plus da ManageEngine, as organizações podem sincronizar registros de usuários entre o Active Directory (AD) e o Chargebee, otimizando o gerenciamento do ciclo de vida do usuário. Essa integração automatiza a criação e a atualização de registros de usuários no Chargebee, melhorando a eficiência operacional e reduzindo a carga de trabalho administrativo.

 

Criar registros de usuários

Os administradores de TI podem automatizar a criação de registros de usuários de clientes no AD com base nas contas de clientes no Chargebee. Da mesma forma, os registros de usuários de clientes no AD podem ser usados para criar contas de clientes automaticamente no Chargebee, garantindo a sincronização perfeita entre as duas plataformas.

 

Desaprovisionamento oportuno de usuário

Quando uma conta de cliente é desativada ou cancelada no Chargebee, a integração com o ADManager Plus garante que os registros de usuário correspondentes no AD sejam atualizados ou removidos automaticamente.

 

Como integrar o Chargebee com o ADManager Plus

Pré-requisitos

O Chargebee usa autenticação por bearer token para autorizar solicitações de API. Consulte Chargebee API 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.

Para executar qualquer ação ou consulta no Chargebee (ação de saída): A conta usada deve ter permissão para realizar a ação desejada.

Nota: o ADManager Plus é disponibilizado com um conjunto pré-configurado de APIs para auxiliar na execução de ações básicas com a integração. Se a ação que você precisa não estiver disponível, consulte a referência de API do Chargebee para obter os detalhes de API necessários para a configuração de webhooks de entrada ou saída para executar as ações requeridas.

Configuração de autorização

  • Faça login no ADManager Plus e acesse Directory/Application Settings.
  • Em Application Integrations, localize e selecione Chargebee.
  • Ative o botão Enable Chargebee Integration.
  • Na página Chargebee Configuration, clique em Authorization.
  • Escolha Bearer como o tipo de autorização para a integração do API.
  • Clique em API widget no painel de configuração de integração para configurar a autenticação personalizada.
  • Na janela API for Authorization:
    • No campo Endpoint URL, substitua {hostname} pelo nome do host da sua instância do Chargebee.
    • No campo Message Type, substitua os espaços reservados {client_id}, {client_secret}, e {api.full_access} pelas respectivas credenciais e pelo identificador da empresa à sua instância do Chargebee.
    • Clique no botão Test and Configure para validar as configurações e concluir a integração.
    • Selecione o access token gerado e clique em Save.
  • Clique em Configure.

Configuração de webhook de entrada

Um webhook de entrada permite que você obtenha dados do usuário diretamente do Chargebee e os envie para o ADManager Plus. O mapeamento de atributos definido aqui poderá ser selecionado como fonte de dados ao configurar automatizações. Para configurar um webhook de entrada para o Chargebee:

  • Em Inbound Webhook, clique em Chargebee Endpoint Configuration.
  • No campo Endpoint URL, substitua {hostname} pelo nome do host da sua instância do Chargebee.
  • Insira a API Key associada à sua instância do Chargebee na seção Headers.
  • Substitua {username}, {password} e {company} no campo Message Type pelas respectivas credenciais para sua instância do Chargebee.
  • Clique em Test and Configure para validar as configurações e concluir o processo de configuração.
  • Clique em Test & Save. A janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos pela chamada da API. Após verificar se os parâmetros desejados foram retornados, clique em Proceed.
  • Nota:

    • Consulte as referências de API do Chargebee para saber quais parâmetros devem ser configurados para obter apenas parâmetros específicos.
    • Você pode configurar diversos endpoints para o Chargebee usando o botão + Add API endpoint. Clique aqui para saber como.
  • Clique em Data Source - LDAP Attribute Mapping para vincular endpoints e mapear atributos LDAP do AD aos respectivos atributos no Chargebee.
  • 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).
    • Nota: Quando vários endpoints estiverem configurados, essa chave deve manter o mesmo valor em todos eles.
    • No campo Attribute Mapping, selecione o atributo no menu suspenso LDAP Attribute Name e associe ele ao atributo correspondente no Chargebee.
    • Se você quiser criar um novo formato personalizado para isso, clique em Add New Format.
    • Clique em Save.

Configuração de webhook de saída

Um webhook de saída permite que você envie mudanças feitas no AD para o Chargebee e execute tarefas no Chargebee — tudo a partir do ADManager Plus. Os webhooks configurados nesta seção podem ser incluídos em Modelos de orquestração, que, por sua vez, podem ser usados durante automações acionadas por eventos e automações agendadas. Eles também podem ser aplicados diretamente aos usuários desejados para executar uma sequência de ações neles (Management > Advanced Management > Orchestration).

Para configurar webhooks de saída para o Chargebee:

  • Em Outbound Webhook, clique em Chargebee Webhook Configuration.
  • Clique em + Add Webhook.
  • Insira um nome e uma descrição para este webhook.
  • Decida sobre a ação que deve ser executada e consulte as referências de API do Chargebee para obter os detalhes de API, tais como URL, cabeçalhos, parâmetros e outros requisitos que serão necessários.
  • Selecione o método HTTP que possibilitará que você execute a ação desejada no endpoint do menu suspenso.
  • Insira a URL do endpoint.
  • Configure os cabeçalhos, os parâmetros e o tipo de mensagem no formato apropriado para a chamada de API desejada.
  • Clique em Test and Save .
  • 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.
  • Os detalhes da solicitação e da resposta do webhook serão exibidos. Verifique se a API está respondendo corretamente e clique em Save.