Lindy セキュリティの基本

概要

Lindy AI インテグレーション向けの重要なセキュリティプラクティス。

前提条件

• 管理者アクセス権を持つ Lindy アカウント
• セキュリティ要件の理解
• シークレット管理ソリューションへのアクセス

手順

ステップ 1: API キーの安全な保管

// NEVER do this
const apiKey = 'lnd_abc123...'; // Hardcoded - BAD!

// DO this instead
const apiKey = process.env.LINDY_API_KEY;

// Or use secret management
import { SecretManager } from '@google-cloud/secret-manager';

async function getApiKey(): Promise<string> {
  const client = new SecretManager();
  const [secret] = await client.accessSecretVersion({
    name: 'projects/my-project/secrets/lindy-api-key/versions/latest',
  });
  return secret.payload?.data?.toString() || '';
}

ステップ 2: 環境別キー

# .env.development
LINDY_API_KEY=lnd_dev_xxx
LINDY_ENVIRONMENT=development

# .env.production
LINDY_API_KEY=lnd_prod_xxx
LINDY_ENVIRONMENT=production

// Validate environment
function validateEnvironment(): void {
  const env = process.env.LINDY_ENVIRONMENT;
  const key = process.env.LINDY_API_KEY;

  if (!key) {
    throw new Error('LINDY_API_KEY not set');
  }

  if (env === 'production' && key.startsWith('lnd_dev_')) {
    throw new Error('Development key used in production!');
  }
}

ステップ 3: エージェントのパーミッション設定

import { Lindy } from '@lindy-ai/sdk';

const lindy = new Lindy({ apiKey: process.env.LINDY_API_KEY });

async function createSecureAgent() {
  const agent = await lindy.agents.create({
    name: 'Secure Agent',
    instructions: 'Handle data securely.',
    permissions: {
      // Restrict to specific tools
      allowedTools: ['email', 'calendar'],
      // Prevent external network access
      networkAccess: 'internal-only',
      // Limit data access
      dataScopes: ['read:users', 'write:tickets'],
    },
  });

  return agent;
}

ステップ 4: 監査ログ

async function withAuditLog<T>(
  operation: string,
  fn: () => Promise<T>
): Promise<T> {
  const start = Date.now();
  const requestId = crypto.randomUUID();

  console.log(JSON.stringify({
    type: 'audit',
    operation,
    requestId,
    timestamp: new Date().toISOString(),
    status: 'started',
  }));

  try {
    const result = await fn();
    console.log(JSON.stringify({
      type: 'audit',
      operation,
      requestId,
      duration: Date.now() - start,
      status: 'completed',
    }));
    return result;
  } catch (error: any) {
    console.log(JSON.stringify({
      type: 'audit',
      operation,
      requestId,
      duration: Date.now() - start,
      status: 'failed',
      error: error.message,
    }));
    throw error;
  }
}

セキュリティチェックリスト

[ ] API キーが環境変数またはシークレット管理に保存されている
[ ] 開発/ステージング/本番環境で異なるキーを使用している
[ ] 起動時にキー検証を実施している
[ ] エージェントのパーミッションが設定されている（最小権限の原則）
[ ] 監査ログが有効化されている
[ ] ネットワークアクセスが可能な限り制限されている
[ ] 定期的なキーローテーションがスケジュール済みである
[ ] アクセス権が四半期ごとに確認されている

出力

• API キーの安全な保管パターン
• 環境別設定
• エージェントのパーミッション制御
• 監査ログの実装

エラーハンドリング

リスク	対策	実装
キーの露出	シークレット管理	クラウドシークレットを使用
環境間違い	検証	キープレフィックスを確認
パーミッション過多	最小権限の原則	エージェントツールを制限
監査ログなし	ログ記録	すべての操作をログに記録

例

本番環境対応のセキュリティ

// security/index.ts
export async function initializeLindy(): Promise<Lindy> {
  // Validate environment
  validateEnvironment();

  // Get key from secret manager
  const apiKey = await getApiKey();

  // Initialize with security options
  const lindy = new Lindy({
    apiKey,
    timeout: 30000,
    retries: 3,
  });

  // Verify connection
  await lindy.users.me();

  console.log('Lindy initialized securely');
  return lindy;
}

リソース

• Lindy Security
• API キーのベストプラクティス
• SOC 2 コンプライアンス

次のステップ

本番環境の準備完了確認については、lindy-prod-checklist に進んでください。