プラグイン利用状況AI検索台帳プラグイン（無料）
kintone環境にインストール済みのプラグインと、それを利用しているアプリの一覧を専用の「台帳アプリ」に 自動収集し、簡易AI検索やAI用データダウンロードで「目的に合ったプラグインを探す」ことができるように するプラグインです。社内にどんなプラグインが増えてきたか把握しづらくなってきた組織向けです。
こんな方におすすめ
- kintone環境にどのプラグインがどのアプリで使われているか把握したい
- プラグインの棚卸しをしたい
- 「kintone プラグイン一覧 管理」を探している
- 退職・異動時の引き継ぎ資料としてプラグイン利用状況を残したい
紹介動画
ユースケース
「台帳アプリ」の一覧画面に置かれた「プラグイン利用状況を同期」ボタンを押すと、kintone環境全体のインストール済みプラグイン一覧と、各プラグインを実際に追加しているアプリの一覧をREST APIで取得し、プラグイン単位のレコード(利用アプリはサブテーブル)として自動的にUPSERTします。運用が長くなるほど把握しづらくなる「野良プラグイン」の棚卸しに使えます。
設定で簡易AI検索を有効にすると、台帳アプリの一覧画面にAI検索ボタンが表示され、「日付を和暦にしたい」のような自然文で台帳内のプラグインをベクトル検索できます(ブラウザ内で完結する軽量モデルによる検索)。新しく業務要件が出たとき、似た機能のプラグインが社内に既にないかをまず探せます。
簡易AI検索をオフにしている場合でも、「AI用データをダウンロード」ボタンで台帳の全レコードをJSON形式の.txtファイルとして常時ダウンロードできます。社内で使っているNotebookLMやChatGPTなどにそのままアップロードして、対話形式でプラグインを探す用途に使えます(この操作自体は外部通信を伴いません)。
セットアップ手順
- プラグインを「台帳アプリ」として使いたいアプリに追加し、設定画面を開く。
- 必要に応じて「簡易AI検索を有効にする」にチェックを入れ、「プラグイン利用状況を同期」ボタンを表示するグループを選んで保存する(グループ未選択の場合、同期ボタンは表示されません)。
- 保存すると、台帳アプリに必要なフィールド(プラグインID・名称・バージョン・詳細・利用アプリ一覧テーブル)が自動作成され、運用環境への反映まで自動で行われます(手動でのフィールド作成・アプリ更新操作は不要です)。
- 台帳アプリの一覧画面を開き、「プラグイン利用状況を同期」ボタンを押す。実行にはcybozu.com共通管理者権限が必要です(下記セキュリティレビュー参照)。
同期ボタンの表示・非表示はあくまで画面上の絞り込みです。実際にプラグイン利用アプリの一覧を取得できるのはcybozu.com共通管理者のみのため、権限を持たないユーザーが実行すると失敗します。
セキュリティレビュー結果サマリ
kintoneセキュアコーディングガイドラインに沿って実装時にチェックしています。特に重要な点は次のとおりです。
- 【例外事項】簡易AI検索を有効にした場合のみ、外部CDN(cdn.jsdelivr.net)からベクトル検索用ライブラリを読み込みます。本プラグインに限り「外部通信を行わない」という他プラグイン共通の方針の例外としており、バージョンは完全固定(可変指定はしない)しています。AI検索を無効のままにするか、代わりにAI用データダウンロード機能(外部通信なし)を使うことで、この通信を避けられます。
- 「同期ボタンを表示するグループ」の設定は画面上の絞り込みに過ぎず、真の権限境界ではありません。実際にプラグイン利用アプリの一覧を取得できるのはcybozu.com共通管理者のみで、この権限を持たないユーザーが実行してもAPIが失敗するだけで、意図しないデータ取得は起きません。
- 台帳アプリへのフィールド自動作成は、既存のフィールドコードとの衝突を避けるため一意なコード(
pcb_apps_table等)を使用し、2回目以降の設定保存で既存フィールドを再作成しようとしてエラーになることがないよう冪等に実装しています。 - すべてのkintone操作は
kintone.api()(kintone自身への呼び出し専用の内部ラッパー)経由で行い、生のfetch/XMLHttpRequestでURLを直接組み立てていません。APIトークンやパスワード等の認証情報はコード・設定に一切含めていません。 - 簡易AI検索の検索結果・設定画面の描画は
innerHTMLではなくtextContentやdocument.createElement()のみで組み立てており、DOMへ構造として解釈されません。
詳細な確認項目・確認日は下記GitHubのチェックリストに全項目を掲載しています。
設定画面イメージ
API実行数について
設定保存時に、台帳アプリのフィールド構成確認・必要に応じたフィールド追加・デプロイ(数回)を実行します。 「プラグイン利用状況を同期」ボタンを押すたびに、プラグイン一覧取得(1回以上)・プラグインごとの 利用アプリ取得(プラグイン数と同じ回数)・利用アプリ情報取得(100件区切り)・台帳アプリへの書き込み (100件区切り)を実行します。実行前に概算のAPI実行回数を確認ダイアログで表示します。 簡易AI検索を有効にした場合、検索ダイアログを開くたびに台帳アプリの全レコードを取得します (kintoneへの通信のみで、外部への通信ではありません)。