Conecte uma integração

Conectar uma integração vincula sua conta de um serviço externo — como Slack ou GitHub — ao seu aplicativo Kliv, para que seu aplicativo possa funcionar com ele. Você mesmo faz isso nas configurações do Kliv; uma vez conectado, Kliv mantém as credenciais seguras e seu aplicativo pode começar a usá-lo.

Esta página percorre o fluxo de conexão e o que Kliv armazena para você.

O fluxo de conexão

  1. Vá para Configurações → Integrações.
  2. Escolha a integração desejada no catálogo.
  3. Escolha Conectar. O que acontece a seguir depende do serviço:
    • Faça login no serviço. A maioria das integrações (Slack, Notion, HubSpot e outras) envia você a esse serviço para fazer login e aprovar o acesso e, em seguida, trazê-lo de volta ao Kliv. Você está aprovando que Kliv aja em seu nome — você mesmo não copia nenhuma chave.
    • Instale um aplicativo. Alguns, como GitHub, pedem que você instale o aplicativo Kliv em sua conta ou organização e escolha o que ele pode alcançar.
    • Cole uma chave. Alguns serviços se conectam colando uma chave de acesso das configurações desse serviço. Kliv armazena para você no cofre.
  4. Ao retornar ao Kliv, a integração aparece como conectada e pronta para uso.

Você pode conectar mais de uma conta para o mesmo serviço — por exemplo, dois espaços de trabalho Slack — e escolher qual deles uma determinada parte do seu aplicativo usa.

O que Kliv armazena para você

Quando você se conecta, Kliv salva as credenciais desse serviço em um cofre seguro. Algumas coisas para saber:

  • As credenciais ficam no cofre do Kliv, nunca no código do seu aplicativo. Os visitantes do seu aplicativo não podem vê-las e você nunca precisa gerenciar os tokens por conta própria.
  • Kliv fornece a credencial nos bastidores. Quando seu aplicativo faz uma chamada, Kliv anexa a credencial correta no lado do servidor. O código do seu aplicativo descreve apenas o que fazer, nunca como autenticar.
  • Algumas conexões são atualizadas automaticamente. Para serviços cujo acesso expira, Kliv o renova para você. Se um serviço revogar o acesso — por exemplo, você removeu o aplicativo Kliv do lado dele — a integração solicitará que você se reconecte.

Gerenciar ou desconectar

Na mesma área Integrações você pode revisar uma integração conectada, configurar quem tem permissão para usá-la, configurar gatilhos de eventos ou desconectá-la. A desconexão remove as credenciais armazenadas e impede que seu aplicativo use esse serviço.

Se algo der errado

  • "Não conectado" — a integração ainda não foi conectada ou seu acesso foi removido. Conecte-o (ou reconecte-o) em Configurações → Integrações.
  • "Reconexão necessária" — o serviço externo revogou o acesso de Kliv. Abra a integração e conecte-a novamente.
  • Mais de uma conexão — se seu aplicativo tiver diversas contas conectadas para o mesmo serviço, talvez seja necessário informar qual delas usar — a página de cada conexão mostra um seletor de conexão, um rótulo curto que seu aplicativo usa para escolher entre elas.

Relacionado