통합 연결하기
통합을 연결하면 Slack이나 GitHub 같은 외부 서비스의 계정이 Kliv 앱에 연결되어, 앱이 해당 서비스와 함께 작동할 수 있게 됩니다. Kliv 설정에서 직접 수행하며, 연결되면 Kliv가 자격 증명을 안전하게 보관하고 앱이 이를 사용하기 시작할 수 있습니다.
이 페이지에서는 연결 흐름과 Kliv가 대신 저장하는 내용을 안내합니다.
연결 흐름
- 설정 → 통합으로 이동합니다.
- 카탈로그에서 원하는 통합을 선택합니다.
- 연결을 선택합니다. 다음에 일어나는 일은 서비스에 따라 다릅니다.
- 서비스에 로그인. 대부분의 통합(Slack, Notion, HubSpot 등)은 로그인하고 액세스를 승인하도록 해당 서비스로 보냈다가 다시 Kliv로 돌려보냅니다. Kliv가 사용자를 대신해 작동하도록 승인하는 것이며, 키를 직접 복사할 일은 없습니다.
- 앱 설치. GitHub 같은 일부 서비스는 Kliv의 앱을 계정이나 조직에 설치하고 접근 범위를 선택하도록 요청합니다.
- 키 붙여넣기. 몇몇 서비스는 해당 서비스 설정에서 가져온 액세스 키를 붙여넣어 연결합니다. Kliv가 이를 볼트에 저장합니다.
- Kliv로 돌아오면 통합이 연결되어 사용할 준비가 된 것으로 표시됩니다.
동일한 서비스에 대해 두 개 이상의 계정(예: 두 개의 Slack 워크스페이스)을 연결하고, 앱의 특정 부분이 어느 계정을 사용할지 선택할 수 있습니다.
Kliv가 대신 저장하는 것
연결하면 Kliv는 해당 서비스의 자격 증명을 보안 볼트에 저장합니다. 알아 둘 몇 가지 사항:
- 자격 증명은 Kliv의 볼트에 있으며, 앱 코드에는 절대 들어가지 않습니다. 앱 방문자는 이를 볼 수 없으며, 토큰을 직접 관리할 필요가 없습니다.
- Kliv가 보이지 않는 곳에서 자격 증명을 공급합니다. 앱이 호출을 하면 Kliv가 서버 측에서 올바른 자격 증명을 첨부합니다. 앱 코드는 무엇을 할지만 기술하고, 어떻게 인증할지는 다루지 않습니다.
- 일부 연결은 자동으로 갱신됩니다. 액세스가 만료되는 서비스의 경우 Kliv가 대신 갱신합니다. 서비스 쪽에서 액세스를 취소한 경우(예: 해당 서비스에서 Kliv 앱을 제거한 경우) 통합이 다시 연결하라고 요청합니다.
관리 또는 연결 해제
동일한 통합 영역에서 연결된 통합을 검토하고, 사용을 허용할 사람을 설정하고, 이벤트 트리거를 구성하거나, 연결을 해제할 수 있습니다. 연결을 해제하면 저장된 자격 증명이 제거되고 앱이 해당 서비스를 더 이상 사용할 수 없게 됩니다.
문제가 생기면
- "연결되지 않음" — 통합이 아직 연결되지 않았거나 액세스가 제거되었습니다. 설정 → 통합에서 연결(또는 다시 연결)하세요.
- "다시 연결 필요" — 외부 서비스가 Kliv의 액세스를 취소했습니다. 통합을 열고 다시 연결하세요.
- 연결이 두 개 이상인 경우 — 동일한 서비스에 여러 계정이 연결되어 있으면 어떤 계정을 사용할지 앱에 알려줘야 할 수 있습니다. 각 연결의 페이지에는 연결 선택기가 표시되는데, 앱이 연결을 구분해 선택하는 데 사용하는 짧은 라벨입니다.
관련 문서
- 연결할 수 있는 서비스 — 사용 가능한 통합과 이를 통해 열리는 기능.
- 커넥터 사용 권한 제어 — 작업별 액세스를 설정합니다.
- 공급자 이벤트에 반응하기 — 연결된 서비스의 이벤트에 응답합니다.