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
- Vá para Configurações → Integrações.
- Escolha a integração desejada no catálogo.
- 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.
- 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
- O que você pode conectar — as integrações disponíveis e o que elas desbloqueiam.
- Controlar quem pode usar um conector — defina o acesso por ação.
- Reaja aos eventos do provedor — responde a eventos de um serviço conectado.