Admin UIプラグイン管理

Authrim Admin Consoleは、コードやAPI呼び出しを書かずにプラグインを管理するためのグラフィカルインターフェースを提供します。

プラグイン一覧

設定 > プラグインに移動して、登録済みのすべてのプラグインを表示します。

プラグイン一覧には以下が表示されます：

プラグインアイコンと名前
簡単な説明
カテゴリバッジ（notification、identity、authentication、flow）
ステータスインジケーター（有効/無効）
信頼レベルバッジ（Official/Community）

フィルタリング

フィルターコントロールを使用してリストを絞り込みます：

フィルター	オプション
カテゴリ	All、Notification、Identity、Authentication、Flow
ステータス	All、Enabled、Disabled
信頼レベル	All、Official、Community

プラグインカード

各プラグインカードには以下が表示されます：

要素	説明
アイコン	プラグインアイコン（Lucideアイコンまたはカスタム）
名前	メタデータからの表示名
バージョン	セマンティックバージョン（例：1.0.0）
説明	短い説明
カテゴリバッジ	notification、identity、authentication、またはflow
ステータスバッジ	Enabled（緑）またはDisabled（グレー）
信頼バッジ	Official（検証済み）またはCommunity（警告）

カードをクリックして詳細ダイアログを開きます。

詳細ダイアログ

プラグイン詳細ダイアログは包括的な情報とコントロールを提供します：

概要タブ

完全な説明
作者情報
ライセンス
ドキュメントリンク（ある場合）
リポジトリリンク（ある場合）
安定性ステータス（stable、beta、alpha、deprecated）
検索/分類用のタグ

設定タブ

設定フォームはプラグインのZodスキーマから自動生成されます：

スキーマタイプ	UIコンポーネント
`z.string()`	テキスト入力
`z.string().url()`	バリデーション付きURL入力
`z.number()`	min/max付き数値入力
`z.boolean()`	トグルスイッチ
`z.enum([...])`	ドロップダウン選択
機密フィールドパターン	パスワード入力（マスク）

設定フィールドには以下が表示されます：

ラベル（.describe()から）
現在の値
デフォルト値（異なる場合）
バリデーションメッセージ

ヘルスタブ

プラグインのヘルスチェック結果を表示：

ステータス	インジケーター	説明
`healthy`	緑	プラグインは正常に動作中
`degraded`	黄	動作中だが問題あり
`unhealthy`	赤	動作していない
`unknown`	グレー	ヘルスデータなし

ヘルスチェックの詳細には以下が含まれる場合があります：

最終チェックのタイムスタンプ
ステータスメッセージ
個別のチェック結果（API接続性、認証情報など）

管理者メモ

プラグインが管理者メモを提供する場合、折りたたみ可能なセクションに以下が表示されます：

設定のヒント
既知の制限事項
移行手順
デプロイメモ

設定の編集

プラグイン詳細ダイアログを開く
設定タブに切り替え
フィールド値を変更
設定を保存をクリック

バリデーション

入力中のリアルタイムバリデーション
必須フィールドインジケーター
数値のmin/max制約
URLフォーマット検証
カスタムバリデーションメッセージ

設定ソース

UIは現在の設定がどこから来ているかを表示します：

ソース	バッジ	説明
`kv`	KV Storage	Admin UI/API経由で保存
`env`	Environment	環境変数から
`default`	Default	スキーマのデフォルト値

有効化/無効化

プラグインの有効化

プラグイン詳細ダイアログを開く
有効化ボタンをクリック
設定が必要な場合は、まずフォームを完成させる
アクションを確認

プラグインの無効化

プラグイン詳細ダイアログを開く
無効化ボタンをクリック
依存関係の警告を確認（該当する場合）
アクションを確認

ヘルスチェック

手動ヘルスチェック

プラグイン詳細ダイアログを開く
ヘルスタブに切り替え
ヘルスチェック実行をクリック
結果を確認

自動ヘルスチェック

ヘルスチェックは自動的に実行されます：

プラグイン有効化時
定期的（設定可能な間隔）
設定変更時

コミュニティプラグインの警告

コミュニティプラグインを表示すると、警告バナーが表示されます：

コミュニティプラグイン

このプラグインはサードパーティによって提供されています。Authrimはそのセキュリティ、信頼性、互換性を保証しません。ソースコードを確認し、自己責任で使用してください。

警告には以下が含まれます：

作者情報
リポジトリリンク（ある場合）
ライセンス情報

マルチテナント設定

マルチテナントデプロイの場合：

テナントドロップダウン（右上）からテナントを選択
テナント固有の設定を表示/編集
テナント設定はグローバル設定をオーバーライド

テナント設定には以下が表示されます：

継承された値（グローバルから）
オーバーライドされた値（テナント固有）
グローバル値にリセットするオプション

クイックアクション

プラグイン一覧で、カードにホバーするとクイックアクションが表示されます：

アクション	アイコン	説明
トグル	スイッチ	ダイアログを開かずに有効/無効を切り替え
設定	歯車	設定タブに直接ジャンプ
ヘルス	ハート	ヘルスチェックを実行

検索

検索バーを使用して以下でプラグインを検索：

名前
説明
タグ
カテゴリ
作者

キーボードショートカット

ショートカット	アクション
`/`	検索にフォーカス
`Esc`	ダイアログを閉じる
`Tab`	フィールドをナビゲート
`Enter`	フォームを送信

APIリファレンス

プログラムによるアクセスについては、プラグイン管理APIドキュメントを参照してください。

テナント向けのAdmin Console画面は、現在のテナントコンテキストで/api/admin/plugins/...を呼び出します。Platform-level settings画面では/api/admin/platform/plugins/...を使い、テナント別overrideを編集する場合はtenant_idを渡せます。

一般的な操作：

タスク	APIエンドポイント
プラグイン一覧	`GET /api/admin/plugins`
プラグイン取得	`GET /api/admin/plugins/:id`
設定更新	`PUT /api/admin/plugins/:id/config`
有効化	`PUT /api/admin/plugins/:id/enable`
無効化	`PUT /api/admin/plugins/:id/disable`
ヘルスチェック	`GET /api/admin/plugins/:id/health`
スキーマ取得	`GET /api/admin/plugins/:id/schema`

トラブルシューティング

プラグインが表示されない

プラグインがワーカーに登録されているか確認
プラグインが正しくエクスポートされているか検証
ワーカーログで登録エラーを確認

設定が保存されない

フォームのバリデーションエラーを確認
管理者権限があるか検証
ブラウザコンソールでAPIエラーを確認

ヘルスチェックが失敗

エラーメッセージを確認
プラグインの依存関係（外部サービス）を確認
設定値（APIキー、エンドポイント）を検証
ワーカーからのネットワーク接続性を確認

コミュニティプラグインに関する懸念

コミュニティプラグインにセキュリティ上の懸念がある場合：

ソースコードを確認
作者の評判を確認
依存関係を監査
まずテスト環境で実行することを検討