Paloalto MCP Server

🚀 Palo Alto ファイアウォール API 使用ガイド

このドキュメントは、Palo Alto ファイアウォール API の使用方法を詳細に説明します。API を使用することで、ファイアウォールのルールの作成、取得、削除などの操作を自動化することができます。

🚀 クイックスタート

📦 インストール

以下のコマンドを使用して、palo-alto-api をインストールします。

npm install palo-alto-api

基本的な使用法

入站ルールの操作

• 入站ルールの作成：以下のコードで、簡単な入站ルールを作成できます。

await useMcpTool("paloalto-policy", "create_inbound_rule", {
  name: "允许 SSH 访问",
  source: ["any"],
  destination: ["any"],
  service: ["ssh"]
});

• 入站ルールの取得：すべての現在の入站ルールを取得するには、次のコードを使用します。

const rules = await useMcpTool("paloalto-policy", "get_inbound_rules", {});

• 入站ルールの削除：特定の入站ルールを削除するには、以下のコードを使用します。

await useMcpTool("paloalto-policy", "delete_inbound_rule", {
  name: "允许 SSH 访问"
});

📚 ドキュメント

ルールの作成

出站ルールの作成

以下のコードで、Web 閲覧を許可する出站ルールを作成できます。

await useMcpTool("paloalto-policy", "create_outbound_rule", {
  name: "允许网页浏览",
  source: ["内部网络"],
  destination: ["any"],
  service: ["web-browsing"]
});

ルールの取得

すべてのセキュリティポリシーの取得

const securityPolicies = await useMcpTool("paloalto-policy", "get_security_policies", {});

特定のセキュリティポリシーの取得

const specificPolicy = await useMcpTool("paloalto-policy", "get_security_policy", {
  name: "允许网页浏览"
});

ルールの削除

特定のセキュリティポリシーを削除するには、以下のコードを使用します。

await useMcpTool("paloalto-policy", "delete_security_policy", {
  name: "允许网页浏览"
});

💻 使用例

基本的な使用法

以下のコードは、ルールの作成、取得、削除の一連の操作を行う簡単な例です。

async function createAndDeleteRule() {
  try {
    // 创建规则
    await useMcpTool("paloalto-policy", "create_outbound_rule", {
      name: "临时访问规则",
      source: ["192.168.1.0/24"],
      destination: ["10.0.0.0/24"],
      service: ["icmp"]
    });

    // 获取所有规则
    const rules = await useMcpTool("paloalto-policy", "get_outbound_rules", {});

    console.log("创建的规则:", rules);

    // 删除规则
    await useMcpTool("paloalto-policy", "delete_outbound_rule", {
      name: "临时访问规则"
    });

  } catch (error) {
    console.error("操作失败:", error);
  }
}

createAndDeleteRule();

高度な使用法

以下のコードは、新しいセキュリティポリシーを作成し、変更をコミットする高度な例です。

async function applyConfigChanges() {
  try {
    // 创建新规则
    await useMcpTool("paloalto-policy", "create_security_policy", {
      name: "新安全策略",
      source: ["192.168.0.0/16"],
      destination: ["172.16.0.0/12"],
      service: ["smtp"]
    });

    // 获取所有安全策略
    const policies = await useMcpTool("paloalto-policy", "get_security_policies", {});

    console.log("所有安全策略:", policies);

    // 提交更改
    await useMcpTool("paloalto-config", "commit_changes", {
      message: "添加新SMTP规则"
    });

  } catch (error) {
    console.error("配置应用失败:", error);
  }
}

applyConfigChanges();

🔧 トラブルシューティング

エラー処理

API 呼び出し中にエラーが発生した場合、以下のように try-catch ブロックを使用してエラーをキャッチします。

try {
  // 尝试创建规则
  await useMcpTool("paloalto-policy", "create_inbound_rule", {
    name: "测试规则",
    source: ["invalid-network"],
    destination: ["any"],
    service: ["ftp"]
  });
} catch (error) {
  console.error("错误信息:", error);
}

バルク操作

複数のルールを一括で作成および削除するには、以下のコードを使用します。

async function bulkOperations() {
  try {
    // 创建多条规则
    const newRules = [
      { name: "规则1", source: ["192.168.1.0/24"], destination: ["any"], service: ["http"] },
      { name: "规则2", source: ["192.168.2.0/24"], destination: ["any"], service: ["https"] }
    ];

    // 使用循环创建规则
    for (const rule of newRules) {
      await useMcpTool("paloalto-policy", "create_outbound_rule", rule);
    }

    console.log("所有新规则已创建");

    // 删除所有规则
    const existingRules = await useMcpTool("paloalto-policy", "get_outbound_rules", {});

    for (const rule of existingRules) {
      await useMcpTool("paloalto-policy", "delete_outbound_rule", { name: rule.name });
    }

  } catch (error) {
    console.error("批量操作失败:", error);
  }
}

bulkOperations();

❓ よくある質問

API エラーをどのように処理するか？

API 呼び出しを行う際には、常に try-catch ブロックを使用してエラーをキャッチすることをお勧めします。

try {
  // 执行 API 调用
} catch (error) {
  console.error("出现错误:", error);
}

変更をどのようにコミットするか？

すべての設定変更が完了したら、commit_changes メソッドを使用して変更をコミットしてください。

await useMcpTool("paloalto-config", "commit_changes", {
  message: "应用新配置"
});

🤝 コントリビューションガイド

エラーレポートまたは機能リクエストの送信

以下の方法で問題や機能リクエストを送信することができます。

• GitHub Issues
• サポートセンター

コードのコントリビューション方法

1. リポジトリをフォークします。
2. 新しい機能ブランチを作成します：git checkout -b feature/new-feature
3. 変更をコミットします：git commit -m "添加新功能"
4. リモートブランチにプッシュします：git push origin feature/new-feature
5. Pull Request を送信します。

📄 ライセンス

• MIT License：個人および商用利用に適用され、自由な使用、変更、配布が許可されます。

詳細情報については、Palo Alto API ドキュメントを参照してください。