すべてのCloudプランで利用できます。セルフホストではBusinessプラン以上が必要です。
- 接続：OAuthでTeableに許可したサードパーティーのアカウント。Google、Slack、Feishuなど。
- シークレット：自分で保存する文字列。APIキーやアクセストークンなど。
認証情報は設定 → 統合でまとめて管理し、そこから個々のアプリやオートメーションへ付与します。付与したあとは、そのアプリやオートメーションを実行する全員が、付与した人の認証情報を使います。値は誰にも表示されず、オートメーションのテスト結果でもマスクされます。
接続とシークレットを管理する
左下のアバターをクリックし、設定 → 統合を開きます。ページは自分の接続、自分のシークレット、許可したサードパーティアプリの3つに分かれています。
シークレットを追加では次の項目を入力します。
接続は新しいアカウントを接続から追加します。認可の期限が切れた接続には再接続が表示されます。
各認証情報には、現在いくつのリソースで使われているかが表示されます。表示をクリックするとアプリとオートメーションの一覧が開き、個別に認可を解除できます。
アプリやオートメーションへ付与する
リソースの認証情報パネルを開きます。
- アプリ：App Builderのチャットパネルで**+** → もっと → 認証情報と設定。
- オートメーション：ワークフローを開き、編集タブで認証情報と設定をクリック。
付与には3つの方法があります。既存のシークレットを付与は自分のシークレットや接続から選びます。シークレットを追加はその場で作成してすぐ付与します。サービスの一覧から選ぶこともでき、未接続のサービスはOAuthに進み、接続済みと表示されているサービスはそのまま付与されます。
付与には変数名が必要です。これはそのアプリやオートメーション内での認証情報のエイリアスで、命名規則はシークレットのKeyと同じです。コードが読み取るのもこの名前です。
パネルには未バインドのプレースホルダーが並ぶこともあります。アプリのコピー、ワークフローの複製、ベースのインポートや複製では、コードが必要とするエイリアスだけが引き継がれ、認証情報は引き継がれません。自分のをバインドで自分の認証情報を割り当てると、アプリやオートメーションが動くようになります。
エイリアスに他の人の認証情報がバインドされている場合は、自分のに置き換えで引き継げます。**付与のみ解除（プレースホルダーを残す）**を選ぶとバインドだけが外れ、プレースホルダーは残るため、コードの変更は不要です。
リソースの付与を変更するには、そのアプリやオートメーションの編集権限が必要です。付与できるのは自分の認証情報だけです。
コードから読み取る
オートメーションの入力欄にキーらしき文字列を貼り付けると、Teableはそれを自分のシークレットとして保存し、その場には参照だけを残します。平文がワークフローの設定に残ることはありません。貼り付けたままにしたい場合は、通知の元に戻すをクリックします。
AIチャットでの認証情報リクエスト
AIが外部アカウントを必要とする場合、どのサービスの接続か、どのエイリアスのシークレットかを示す認証情報リクエストのカードが会話に固定されます。選択肢は次のとおりです。
- 自分のアカウントを接続：OAuthを実行します。新しい接続はそのリソースへ自動的に付与されます。
- 自分の…を付与：すでに持っている接続やシークレットを使います。
- スキップ：認証情報を渡しません。AIはそれに依存しない部分の処理を続けます。
値の変更、削除、スペースからの退出
シークレットの値を変更する、シークレットを削除する、接続を解除する前に、Teableはそれをまだ使っているアプリとオートメーションを一覧表示します。削除と接続解除を実行すると、それらのリソースはすぐに動かなくなります。動かし続けたい場合は、先にリソース側で別の認証情報に切り替えてください。以前のシークレットの値は復元できません。
新しい値を保存すると、オートメーションは次回の実行から新しい値を使います。アプリはプレビュー環境の再起動後、公開済みのアプリは再公開後に反映されます。
スペースから退出したあとも、そこのアプリやオートメーションがあなたの認証情報を使っている場合、統合ページにこのスペースから退出済みと表示されます。提供をやめるには認可を解除をクリックします。
