Aduana Digital de Defensa Argentina
ADDA アクセスを作成
← ADDA マニュアル

api-shield/1.0.0 · 2026/07/09 更新

API 保護

可視性を失わずに rate limit、レピュテーション、統合ルートを運用する方法。

API Shield は、統合ルート、自動化、プログラムによる利用を、人が操作するフォームとは異なる評価で保護します。

優先すべきことは異常な request のブロックだけではありません。有効な統合を壊さず、組織的なトラフィックと scraping を区別し、制限が重要なサービスに影響するときは Evidence を維持する必要があります。

API Shield を Access、WAF、Secrets と照合することで、リスクが単一の request ではなく、認証情報、トンネル、または送信元の姿勢にあるケースへ対応できます。

チェックリスト

  • • 重要な統合ルートを特定する。
  • • 送信元が既知の認証情報、トンネル、またはセッションを使用しているか確認する。
  • • 対策がサービス継続性を変える場合は、Evidence で判断を裏付ける。

クイックスタート

  1. 1. 孤立した request だけでなく、統合ルートから確認を始めます。
  2. 2. API が Secrets、Access、または有効な認証情報と結び付いているか確認します。
  3. 3. 調整に別の領域との連携が必要な場合は tasks を使います。

運用フロー

背景を把握

ルート、送信元、期待されるサービス継続性を読み取ります。

下流の依存関係を持つ API をむやみにブロックしません。

関連付け

シグナルを Secrets、Access、または keyring と照合し、信頼が変化したか判断します。

問題がトラフィック、ID、認証情報のどれにあるか確認します。

対応を合意

緩和策に複数チームが関与する場合は task または incident を作成します。

機微な変更に対するガバナンスを維持します。

flowchart LR
  S1["背景を把握"]
  S2["関連付け"]
  S3["対応を合意"]
  S1 --> S2
  S2 --> S3

バリデーターとチェック

この画面を文脈に沿って分析し、運用に重点を置いた推奨手順を返します。

API 保護を検証

統合または自動化されたルート向けの checks と記事を返します。

例

公開 API を確認するための payload

{
  "moduleKey": "api-shield",
  "query": "token reuse scraping",
  "domain": "api.capacero.ar"
}

リンクと参照

APIs

  • /api/adda/v1/shields/events
  • /api/adda/v1/secrets/status
  • /api/adda/v1/access/status

Docs とサポートルート

  • docs/ADDA_API.md
  • docs/ADDA_WAF.md

よくある問題

  • • プログラムによるトラフィックを人の閲覧として扱うと、対応が乱れます。
  • • Secrets や Access を確認せずに防御を調整すると、リスクの原因が残る可能性があります。

推奨アクション

  • • シグナルを関連する認証情報、セッション、またはトンネルと必ず照合します。
  • • API が重要なプロセスを支える場合は、急なブロックより先に制限と追跡可能性を優先します。

有用な Reason Codes

Score 辞書

wafRiskScore

観察対象のルートまたはフォームで検出されたリスク。

decision

決定された操作：許可、検証、制限、またはブロック。

matchedRules

保護が起動した理由を説明するルール。

プロトコル注記

  • • サービス継続性は、不正利用の抑制と同じくらい重要です。

記事の履歴

2026/07/09

継続性、認証情報、連携に焦点を当てた API Shield の記事を追加しました。