サービスアカウントで API へアクセス

サービスアカウントは、バックエンドシステム・外部サービス・AI Agent などのプログラムから
NocodilySuite の API へ安全にアクセスするための専用アカウントです。

ユーザーのパスワードを共有する必要がなく、鍵（Key）による認証でシステム間連携を実現します。
鍵ごとにアクセス可能なスコープ（権限ロール）を設定できるため、最小権限の原則に基づいた運用が可能です。

サービスアカウントが必要なシーン

シーン	内容
AI Agent からの API 呼び出し	MCP サーバ経由で AI Agent が業務 API を操作する際に使用
バックエンドシステムとの連携	外部のバッチ処理・マイクロサービスから API を呼び出す際に使用
外部サービスとの統合	Webhook 受信・データ同期など、人手を介さない自動処理に使用
CI / 自動スクリプト	デプロイ・データ投入などの自動化スクリプトから API を呼び出す際に使用

サービスアカウントの作成・鍵の発行・無効化は、Admin WebUI（システム管理画面）からのみ行えます。
事前に IAM API に接続した Admin WebUI をデプロイしておく必要があります。

鍵は発行後に一度だけ表示されます。安全な場所に保管してください。
不要になった鍵は Admin WebUI から即座に無効化できます。

発行した鍵を使って、HTTP リクエストのヘッダーに認証情報を付与してアクセスします。

Authorization: Bearer <発行した鍵>

鍵に付与されたロールの範囲内でのみ、API の操作が許可されます。

サービスアカウントには以下のロールを付与できます。
詳細は認証基盤でサポートする権限を参照してください。