連携を接続する

連携を接続すると、Slack や GitHub のような外部サービスのアカウントが Kliv アプリにリンクされ、アプリがそのサービスと連携できるようになります。これは Kliv の設定から自分で行います。接続されると、Kliv が認証情報を安全に保管し、アプリはそれを使い始められます。

このページでは、接続フローと Kliv が保存するものを説明します。

接続フロー

  1. Settings → Integrations に移動します。
  2. カタログから接続したい連携を選びます。
  3. Connect を選びます。次に起きることはサービスによって異なります。
    • サービスにサインインする。 ほとんどの連携(Slack、Notion、HubSpot など)は、そのサービスへ送ってサインインとアクセス承認を行わせ、その後 Kliv に戻します。Kliv があなたに代わって操作することを承認します。キーを自分でコピーすることはありません。
    • アプリをインストールする。 GitHub のような一部のサービスでは、Kliv のアプリを自分のアカウントまたは組織にインストールし、何に到達できるかを選びます。
    • キーを貼り付ける。 一部のサービスは、そのサービスの設定から取得したアクセスキーを貼り付けて接続します。Kliv はそれを vault に保存します。
  4. Kliv に戻ると、連携は接続済みで利用可能として表示されます。

同じサービスに対して複数のアカウント、たとえば 2 つの Slack ワークスペースを接続し、アプリの特定部分がどれを使うか選べます。

Kliv が保存するもの

接続すると、Kliv はそのサービスの認証情報を安全な vaultに保存します。知っておくべきことは次のとおりです。

  • 認証情報は Kliv の vault にあり、アプリのコードには入りません。 アプリの訪問者は見ることができず、あなたもトークンを自分で管理する必要はありません。
  • Kliv が裏側で認証情報を提供します。 アプリが呼び出しを行うと、Kliv はサーバー側で適切な認証情報を添付します。アプリコードは何をするかだけを記述し、どう認証するかは記述しません。
  • 一部の接続は自動的に更新されます。 アクセスに期限があるサービスでは、Kliv が更新します。サービス側がアクセスを取り消した場合、たとえば相手側で Kliv のアプリを削除した場合は、連携が再接続を求めます。

管理または切断

同じ Integrations 領域から、接続済み連携の確認、誰が使えるかの設定、イベントトリガーの設定、または切断ができます。切断すると保存された認証情報が削除され、アプリはそのサービスを使えなくなります。

問題が起きた場合

  • "Not connected" — 連携がまだ接続されていないか、アクセスが削除されています。Settings → Integrations から接続(または再接続)します。
  • "Reconnect required" — 外部サービスが Kliv のアクセスを取り消しました。連携を開き、再度接続します。
  • 複数の接続 — アプリが同じサービスに複数のアカウントを接続している場合、どれを使うか伝える必要があることがあります。各接続のページには connection selector、つまりアプリが接続を選び分けるための短いラベルが表示されます。

関連