Webhook の説明: Webhook の仕組みと安全に受信する方法

  1. ホーム
  2. ブログ
  3. ソフトウェア開発

ソフトウェア開発

Webhook の説明: Webhook の仕組みと安全に受信する方法

Webhook を使用すると、選択した URL に HTTP リクエストを送信することで、何かが起こった瞬間にあるシステムが別のシステムに通知できます。ポーリングとの違い、署名の検証方法、および実行した受信機を使用して再試行やリプレイに耐える方法を学びます。

読了目安9分
Webhook の説明: Webhook の仕組みと安全に受信する方法

ポイント

  • Webhook は、イベントの発生時にプロバイダーが URL に送信する HTTP POST リクエストであるため、問い合わせを続ける必要はありません。
  • 誰でもパブリック URL を呼び出すことができるため、定数時間の比較により生の本文に対する HMAC 署名 を検証します。
  • 古いタイムスタンプを拒否してリプレイを停止し、再試行された配信が 1 回だけ処理されるようにイベント ID を保存します。
  • 私たちの実行では、受信側は有効なイベントを受け入れ、その再試行を無視し、改ざんされた本体、間違ったシークレット、および 10 分前のリプレイを拒否しました。

アプリは、支払いが成功したとき、ビルドが完了したとき、またはフォームが別のサービスに送信されたときを知る必要があります。そのサービスに「何か新しいことはありますか?」と毎分尋ねることもできますが、ほとんどの答えは「いいえ」でしょう。 Webhook は方向を反転します。サービスに URL を与えると、イベントが発生した瞬間にサービスが呼び出します。

単にアイデアを説明するのではなく、アイデアをテストするために、Python 3.13 の標準ライブラリを使用して小さな Webhook 受信側と送信側を作成し、両方を 1 台のマシン上で実行し、有効な、改ざんされ、再生され、再試行された有効なリクエストを送信しました。以下の結果は、その実行からコピーされたものです。 API 全般が初めての場合は、まず API とは をお読みください。

Webhook とは何ですか?

Webhook は HTTP コールバックです。 https://example.com/hooks/payments などのエンドポイントをプロバイダーに登録し、関心のあるイベントを選択します。これが発生すると、プロバイダーはイベントを説明する JSON 本文を含む POST リクエストをその URL に送信します。サーバーはそれを読み取り、本物であることを確認し、処理を実行して、2xx ステータス コードを返します。

Webhook を「リバース API」と呼ぶこともあります。通常の API 呼び出しでは、コードが質問し、プロバイダーが応答します。 Webhook を使用すると、プロバイダーが会話を開始します。

Webhook とポーリング

アスペクト APIのポーリング Webhook
誰が始めるか あなたのアプリをタイマーで 各イベントのプロバイダー
遅延 最大 1 回のポーリング間隔 通常は数秒
無駄な通話 空の応答が多い ほとんどない
サーバーに必要なもの アウトバウンドアクセスのみ パブリック HTTPS エンドポイント
見逃したイベント まれです。あなたはまた尋ねます 再試行回数が足りなくなった場合は可能

API レート制限ガイド で説明されているように、ポーリングではレート制限も使い切ります。多くのチームは、速度向上のための Webhook と、失敗した配信の欠落を検出するための定期的なチェックの両方を使用しています。

Webhook 配信の仕組み

  1. payment.succeeded などのイベントがプロバイダーで発生します。
  2. プロバイダーは JSON ペイロードを構築し、ユーザーのみに共有されるシークレットで署名し、URL に POST します。
  3. エンドポイントは署名とタイムスタンプを検証し、イベント ID を記録し、すぐに 200 を返します。
  4. エンドポイントが失敗するかタイムアウトになると、プロバイダーは後で再試行しますが、通常はギャップが大きくなります。

ペイロードの様子

POST /hook HTTP/1.1
Content-Type: application/json
X-Timestamp: 1794500000
X-Signature: b82128c3c09fb40a...

{"id": "evt_1", "type": "payment.succeeded", "amount": 500}

上記のタイムスタンプと署名の値は短縮された図です。ヘッダー名はプロバイダーによって異なりますが、ほとんどの場合、イベント ID、イベント タイプ、タイムスタンプ、署名が送信されます。私たちの Python JSON ガイド では、本文の安全な解析について説明しています。

リクエストの署名と検証

Webhook URL は公開されているため、それを知った人は誰でも、偽の「支払いが成功しました」などの偽のイベントを送信する可能性があります。標準の防御は HMAC 署名です。プロバイダーは共有シークレットを使用してタイムスタンプと生の本文の SHA-256 HMAC を計算し、それをユーザー側で再計算します。

import hmac, hashlib, time

SECRET = b"whsec_demo_only"   # load from an environment variable in real code

def sign(body: bytes, ts: str) -> str:
    return hmac.new(SECRET, f"{ts}.".encode() + body, hashlib.sha256).hexdigest()

def verify(body: bytes, ts: str, sig: str) -> bool:
    if not ts.isdigit() or abs(time.time() - int(ts)) > 300:
        return False                      # stale or missing timestamp
    return hmac.compare_digest(sign(body, ts), sig)

3 つの詳細が重要です。

  • 未加工の本文バイトを使用します。 フレームワークが最初に JSON を解析して再シリアル化すると、間隔やキーの順序が変更され、署名が一致しなくなる可能性があります。
  • 一定時間で比較します。 hmac.compare_digest では、最初の文字と最後の文字が異なっていても同じ時間がかかり、タイミング攻撃を無効にします。プレーン == は最初の不一致で停止する可能性があります。
  • シークレットをコード外に置きます。シークレットを環境変数またはシークレットマネージャーに保存し、漏洩した場合はローテーションします。

弊社のテスト結果

ローカル ポートで受信機を起動し、6 種類のリクエストを送信しました。

1 valid:                   (200, 'ok')
2 same event again (retry): (200, 'duplicate ignored')
3 tampered body:           (401, 'bad signature')
4 wrong secret:            (401, 'bad signature')
5 replay 10 min old:       (400, 'stale timestamp')
processed events: ['payment.succeeded', 'order.created']

改ざんされたケースでは、"amount": 500 で本文に署名し、輸送中にそれを 5000 に変更しました。署名が一致しなくなったため、リクエストは拒否されました。推測されたシークレットを使用して作成された署名も同様に失敗しました。さらに多くのリクエストが到着したにもかかわらず、合計で処理されたイベントは 2 つだけでした。 HTTP ステータス コード チートシート にリストされているように、ステータス コードは通常の HTTP の意味に従います。

リプレイ保護

有効な署名は、プロバイダーがリクエストを作成したことを証明しますが、リクエストが新しいことを証明するものではありません。攻撃者が本物のリクエストを 1 つ取得すると、後でそれを再送信する可能性があります。署名されたデータ内にタイムスタンプを含め、数分より古いものを拒否することで、そのギャップが解消されます。 10 分前のリクエストは、署名がチェックされる前に拒否されました。サーバーの時計を常に同期しておかないと、本物のイベントも拒否される可能性があります。

ヒント: 拒否されたすべての Webhook の理由をログに記録しますが、シークレットや完全な署名はログに記録しないでください。拒否ログは、ローテーション後に誤って設定されたシークレットに気づく方法です。

バックオフを伴う再試行

プロバイダーは、エンドポイントが失敗した場合、タイムアウトした場合、または 2xx 以外のステータスを返した場合に再試行します。回復するまでに 2 回失敗したエンドポイントをシミュレートしました。各試行の間の送信者の待機時間が長くなりました。

attempt 1: 500 temporarily down
attempt 2: 500 temporarily down
attempt 3: 200 ok
delivered: True

送信者は毎回待機時間を 2 倍にしました (50 ミリ秒、100 ミリ秒、次に 200 ミリ秒)。実際のプロバイダーは、同じアイデアを数分、数時間、多くの場合 1 日以上にわたって使用し、その後諦めてエンドポイントを無効にする場合があります。一部のプロバイダーはクライアント エラーで再試行を停止するため、不正な署名など、決して受け入れられないリクエストに対してのみ 4xx を返します。

べき等性: 各イベントを 1 回処理する

再試行はあなたを意味しますするだろうたとえば、サーバーがイベントを処理したが応答が失われた場合など、一部のイベントを複数回受信します。ハンドラーは冪等である必要があります。同じイベントを 2 回処理すると、1 回処理した場合と同じ効果が得られる必要があります。各イベント ID を保存し、繰り返しには「重複を無視」して応答しました。運用環境では、一意の制約を使用して ID をデータベース テーブルに保存します。これにより、2 つの並行配信が両方ともすり抜けることがなくなります。

迅速に応答し、後で作業します

プロバイダーはあなたの返信を数秒だけ待ちます。ハンドラーが電子メールを送信したり、他の API を呼び出したり、レポートを実行したりする場合は、返信後にその作業を実行します。検証して、イベントをキューまたはテーブルに保存し、200 を返し、バックグラウンド ジョブで処理します。これにより、配信のタイムアウトが回避され、低速期間中の再試行の嵐が回避されます。イベントは順序どおりに到着しない場合もあるため、各イベントが最新であると仮定するのではなく、オブジェクトの現在の状態を確認してください。

Webhook をテストする方法

  • 既知の本文、タイムスタンプ、予期される署名、および改ざんおよび期限切れのケースを使用して検証ツールを単体テストします。
  • 私たちが行ったように、レシーバーをローカルで実行して署名付きリクエストを送信するか、プロバイダーの CLI またはダッシュボードを使用してテスト イベントを送信します。
  • プロバイダーがラップトップに到達する必要がある場合は、トンネリング ツールを使用してローカル ポートを公開します。その後閉じてください。
  • 正常なパスだけでなく、重複、順序が乱れたイベント、低速なダウンストリーム サービスをテストします。

Postman などのツールは、手作りの Webhook リクエストを送信することもできます。 Postman を使用した API テスト ガイドを参照してください。

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

  1. HTTPS のみを受け入れます。
  2. 定数時間比較を使用して、生の本体に対する HMAC 署名を検証します。
  3. 短いウィンドウの外側のタイムスタンプを拒否します。
  4. イベント ID を保存し、重複を無視します。
  5. 秘密をコードではなく構成に保持し、ローテーションをサポートします。
  6. すぐに返信し、バックグラウンドで処理します。
  7. ペイロードを信頼できない入力として扱います。疑わしい場合は、プロバイダーの API から重要な詳細を取得します。

まとめ

Webhook は表面的には単純で、単なる HTTP POST ですが、信頼できる受信者にはいくつかの意図的な習慣が必要です。私たちのテストでは、署名が改ざんと偽の送信者を停止し、タイムスタンプがリプレイを停止し、イベント ID が二重処理を停止し、バックオフが短時間の停止を通じて配信を実行したことにより、それぞれが機能することがわかりました。これらを最初のバージョンから組み込むと、Webhook は実行する最も信頼できる統合の 1 つになります。

よくある質問

Webhook とは簡単に言うと何ですか?

Webhook は、支払いの成功などのイベントが発生したときに、システムが選択した URL に送信する自動 HTTP リクエストです。これにより、変更を繰り返しポーリングする必要がなくなります。

Webhook と API の違いは何ですか?

API を使用すると、コードはプロバイダーにデータを要求します。 Webhook を使用すると、何かが発生したときにプロバイダーがエンドポイントにデータを送信します。多くのサービスは両方を提供します。

Webhook 署名を検証するにはどうすればよいですか?

未処理のリクエスト本文と共有シークレットのタイムスタンプに対して HMAC (通常は SHA-256) を再計算し、hmac.compare_digest などの定数時間関数を使用してヘッダーと比較します。

同じ Webhook を 2 回受信するのはなぜですか?

プロバイダーは、イベントがすでに処理されている場合でも、時間内に 2xx 応答を取得できない場合は再試行します。イベント ID を保存し、重複をスキップすることで、処理が冪等に保たれます。

Webhook エンドポイントはどのようなステータス コードを返す必要がありますか?

イベントが検証され保存されたら、すぐに 2xx コードを返します。不正な署名など、決して受け入れられないリクエストの場合は 4xx を返し、プロバイダーに再試行してもらいたい場合は 5xx を返します。

学び続ける

Stack Quoraと連携する

テスト、WordPress、または SEO についてサポートが必要ですか?

私たちは、チームがより優れたソフトウェアを出荷し、サイトを成長させるのを支援します。あなたが取り組んでいることを教えてください。明確な次のステップを提案します。

読み続けてください

詳しいガイドはこちら テスト、AI、最新の開発

この記事は気に入りましたか?トピックを選択して、最新のチュートリアルに直接アクセスしてください。

人工知能

RAG チャンキング戦略の説明: 固定、オーバーラップ、センテンス、再帰および見出し、測定

tiktoken 0.14 を使用した 1 つのドキュメントでの RAG チャンク戦略の比較: 固定サイズ、オーバーラップ、センテンス パッキング、再帰的分割、見出しベースのチャンク、分割ファクト、孤立見出し、ストレージ コストの測定。

記事を読む →
ソフトウェア開発

API 冪等性の説明: 冪等性キーと安全な再試行、テスト済み

API 冪等性は、私たちが実行した Python サーバーとクライアントで説明されました。応答が失われたため、キーなしでは二重請求、キーありでは単一請求が発生し、さらにキーの再利用、同時再試行、ストレージ ルールが発生しました。

記事を読む →
DevOps

Git Stash の説明: 保存、適用、ポップ、および追跡されていないファイルのテスト済み

Git stash について、Git 2.56 で実行したコマンドを使用して説明しました。メッセージ付きのプッシュ、追跡されていないファイル、リストと表示、適用とポップ、インデックスの保持、競合、スタッシュ ブランチ、ドロップとクリアです。

記事を読む →
ソフトウェアテスト

ペアごとのテストの説明: オールペアによって 216 個のテストが 13 個に削減される方法 (テスト済み)

ペアワイズ テストについては、Python 3.13 で実行したジェネレーターで説明しました。13 のテストでカバーされる 216 の組み合わせのチェックアウト、検証済みのカバレッジ、より大きな例、およびペアワイズで見逃される可能性がある 3 方向のバグです。

記事を読む →
テスト自動化

テストダブルの説明: ダミー、スタブ、スパイ、モック、フェイク、テスト済みの Python コード

テスト ダブルについて、pytest 9.2 で実行される Python の例 (ダミー、スタブ、スパイ、モック、フェイク)、それぞれをいつ使用するか、状態と動作のチェック、およびプレーン モックが隠したバグを autospec がどのようにキャッチするかを説明します。

記事を読む →
データベースとSQL

SQL COALESCE の説明: デフォルト、NULLIF、IFNULL と ISNULL およびトラップ、テスト済み

SQL COALESCE では、SQLite 3.50 で実行したクエリ、つまり最初の非 null 値、空の文字列、数学における NULL、ゼロ除算の NULLIF、集計、LEFT JOIN ギャップ、IFNULL と ISNULL について説明しました。

記事を読む →
データベースとSQL

SQL 自己結合の説明: 従業員とマネージャー、ペアと行の比較、テスト済み

SQL 自己結合については、SQLite 3.50 で実行したクエリで説明しました。従業員とマネージャー、マネージャー以上の収入、一意のペア、日々の変化、2 ホップ チェーン、インデックス作成です。

記事を読む →
ソフトウェア開発

JavaScript スプレッド演算子の説明: スプレッドと残り、コピーと落とし穴、テスト済み

JavaScript スプレッド演算子については、ノード 24 で実行したコード (配列、オブジェクト、浅いコピー、残りのパラメーター、Math.max 制限、reduce のパフォーマンス トラップ) で説明しました。

記事を読む →
ソフトウェア開発

Python コレクション モジュールの説明: Counter、defaultdict、deque など、テスト済み

Python コレクションは、Python 3.13 で実行したコード (Counter、defaultdict、deque、namedtuple、OrderedDict、ChainMap) を使用して説明されています。さらに、list と deque のタイミングとチートシートも含まれています。

記事を読む →
人工知能

LLM コンテキスト ウィンドウの説明: トークン、制限、およびさらに適合させる方法、測定

LLM コンテキスト ウィンドウは、tiktoken を使用して測定したトークン数で説明されています。散文、コード、ヒンディー語の単語とトークン、入出力の予算、チャット履歴のトリミング、RAG のチャンク化とコストです。

記事を読む →
ソフトウェア開発

Webhook の説明: Webhook の仕組みと安全に受信する方法

Webhook について、Python で実行した受信側と送信側で説明しました。プッシュとポーリング、HMAC-SHA256 署名、改ざんおよび再実行されたリクエストの拒否、バックオフによる再試行、冪等性、およびテストのヒントです。

記事を読む →
DevOps

Git Cherry-Pick の説明: 必要なコミットを安全にコピーし、テスト済み

Git チェリーピックでは、Git 2.56 で実行したコマンド、つまりリリース ブランチへのホットフィックスのコピー、新しいハッシュとパッチ ID、-x、-n、コミット範囲、競合、–abort、–skip、およびその後のマージについて説明しました。

記事を読む →
テスト自動化

スナップショット テストの説明: 仕組み、役立つ場合と問題となる場合

スナップショットのテストについては、私たちが実行した pytest と syrupy のデモで説明しました。スナップショットの作成、コード変更後の diff の読み取り、タイムスタンプのマスク、安全な更新、スナップショットが役立つ場合と有害な場合について説明しました。

記事を読む →
ソフトウェアテスト

突然変異テストの説明: 100% のカバー率でもバグを見逃す理由

ミューテーション テストについては、私たちが構築して実行した小さなミューテーション ツールで説明しました。14 個のミュータント、79% のスコアを獲得した 100% のライン カバレッジのテスト スイート、100% に達した境界テスト、さらにツール、コスト、CI ヒントです。

記事を読む →
人工知能

プロンプト インジェクションの説明: AI アプリがどのように騙されるのか、そしてどのように防御するのか

ビルダー向けに説明されたプロンプト インジェクション: 直接攻撃と間接攻撃、キーワード フィルターが失敗する理由 (テストでは 4 つのうち 1 つがブロックされました)、最小権限、ツール許可リスト、出力チェックなどの多層防御。

記事を読む →
DevOps

DNS レコードの説明: A、AAAA、CNAME、MX、TXT、TTL と実際のルックアップ

DNS レコードは、実行したルックアップで説明されています。解決の仕組み、A と AAAA、CNAME ルール、MX と null MX、SPF と検証のための TXT、NS、TTL とキャッシュ、安全な DNS 変更です。

記事を読む →
DevOps

機能フラグの説明: 安全なリリース、段階的なロールアウト、およびフラグの衛生状態

私たちが実行したロールアウト シミュレーションで説明された機能フラグ: フラグの種類、安定したハッシュを使用したパーセンテージ ロールアウト、キル スイッチ、許可リスト、両方のパスのテスト、フラグの負債とベスト プラクティス。

記事を読む →
テスト自動化

Python Faker を使用したテストデータ生成: 現実的で再現性のある安全なデータ

Python Faker でデータ生成をテストし、実行して測定します。再現可能なデータ、ロケール、一意の値、ドメイン形状のレコード、Faker がミスするエッジ ケースのシード、本番データと速度のマスキング。

記事を読む →
ソフトウェアテスト

シフトレフト テストの説明: チームの作業を遅らせることなくバグを早期に発見する

シフトレフト テストについて説明しました。その意味、初期不良の方が安い理由、要件レビューから CI チェックまでの実践、テスターの役割の変化、シフトライト、メトリクス、展開計画について説明します。

記事を読む →
データベースとSQL

SQL 文字列関数の説明: TRIM、SUBSTR、REPLACE、CONCAT、およびデータ クリーンアップ

SQL 文字列関数を実行したクエリとともに説明しました。連結と NULL、TRIM、UPPER と LOWER、SUBSTR と INSTR、REPLACE、パディング、Unicode 長さ、乱雑なデータのクリーニング、方言の違いなどです。

記事を読む →
データベースとSQL

SQL トリガーの説明: BEFORE トリガーと AFTER トリガー、監査ログ、および落とし穴

SQL トリガーについて、実行したトリガーを使用して説明します: BEFORE と AFTER、OLD と NEW、監査ログ、検証、ストック更新、WHEN 条件、ロールバック、方言の違い、およびそれらを回避するタイミング。

記事を読む →
ソフトウェア開発

Python JSON モジュールの説明: ダンプ、ロード、カスタム タイプ、および一般的なエラー

Python JSON モジュールでは、ダンプとロード、ファイル、型変換、日付と小数点、カスタム エンコーダー、object_hook、float 精度、解析エラー、JSON 行など、実行したコードを使用して説明しました。

記事を読む →
ソフトウェア開発

ES モジュールと CommonJS: Node.js での JavaScript インポートの動作 (テスト済み)

ES モジュールと CommonJS について、Node.js で実行したコード (インポートおよびエクスポート構文、require、ライブ バインディング、キャッシュ、トップレベルの待機、動的インポート、ファイル拡張子、相互運用) を使用して説明しました。

記事を読む →
ソフトウェア開発

Python 正規表現の説明: パターン、グループ、先読みと落とし穴、テスト済み

Python 正規表現は、検索と一致、findall、グループと名前付きグループ、貪欲と遅延、サブ、先読み、フラグ、Unicode のサプライズ、壊滅的なバックトラッキングなど、実行したパターンで説明しました。

記事を読む →
人工知能

LLM 構造化出力の説明: AI モデルから信頼性の高い JSON を取得する

LLM 構造化出力は、Pydantic で実行した検証とともに説明されています。JSON モードとスキーマ、制約付きデコード、モデル出力が中断される方法、再試行ループ、セマンティック チェックです。

記事を読む →
DevOps

SSH キーの説明: 仕組み、ssh-keygen、Ed25519、および安全な習慣

SSH キーについて、私たちが生成したキーとともに説明しました: 公開キーと秘密キー、ssh-keygen、Ed25519 と RSA、指紋、パスフレーズ、ssh-agent、authorized_keys、構成ファイル、GitHub、およびキーの衛生状態。

記事を読む →
DevOps

HTTP キャッシュの説明: ライブ テストによるキャッシュ制御、ETag、および 304 レスポンス

HTTP キャッシュについて、私たちが実行した小規模サーバーで説明しました。キャッシュ制御ディレクティブ、最大有効期間、キャッシュなしとストアなし、ETag の再検証と 304 応答、CDN、キャッシュ無効化とヘッダーのテストです。

記事を読む →
テスト自動化

API コントラクトのテストの説明: 重大な変更を出荷前に把握する

API contract testing explained with a schema check we ran: what a contract is, consumer-driven contracts, Pact, OpenAPI, which changes break consume…

記事を読む →
ソフトウェアテスト

リスクベースのテストの説明: リスクをスコアリングし、マトリックスを構築し、重要なものをテストする

リスクベースのテストについて段階的に説明します。リスクの特定、可能性と影響のスコアリング、リスク マトリックスの構築、テストの深さへのリスクのマッピング、実際の例とよくある間違いです。

記事を読む →
データベースとSQL

SQL 制約の説明: NOT NULL、UNIQUE、CHECK、および FOREIGN KEY、テスト済み

SQL 制約について、実行したテストで説明しました。NOT NULL、UNIQUE、CHECK、DEFAULT、PRIMARY、FOREIGN KEY、NULL の抜け穴、SQLite の外部キー設定、名前付け制約とそれらのテストです。

記事を読む →
データベースとSQL

SQL 日付関数の説明: バグのない日付の追加、比較、グループ化

SQL の日付関数を、実行したクエリで説明しました。間隔の追加、月末のサプライズ、日付の違い、BETWEEN トラップ、日別のグループ化、タイム ゾーン、インデックス、方言の違いなどです。

記事を読む →
ソフトウェア開発

Python asyncio の説明: リアル タイミングでの async、await、gather、および TaskGroup

Python asyncio は、コルーチン、await、gather、TaskGroup、エラー処理、タイムアウト、同時実行の制限、パフォーマンスを損なうブロッキングコールの間違いなど、時間を測定したコードで説明しました。

記事を読む →
ソフトウェア開発

JavaScript におけるデバウンスとスロットル: それぞれの仕組み、いつ使用するか、テスト済み

JavaScript でのデバウンスとスロットルについて、Node.js で測定したタイミングを使用して説明します。それぞれの仕組み、単純な実装、先頭と末尾の呼び出し、実際の使用例とテストです。

記事を読む →
ソフトウェア開発

Python コンテキスト マネージャーの説明: with ステートメント、contextlib、および実際の使用法

Python コンテキスト マネージャーは、実行したコードを使用して説明しました。仕組み、__enter__ と __exit__、contextlib.contextmanager、suppress、ExitStack、データベース トランザクション、およびよくある間違いについて説明しました。

記事を読む →
人工知能

LLM 温度と Top-p の説明: AI モデルが次の単語を選択する方法

LLM 温度と top-p は、私たちが実行したシミュレーションで説明しました。確率がどのように再形成されるか、top-p が保持するもの、タスク別の推奨設定、決定論、AI 機能のテストです。

記事を読む →
DevOps

YAML の説明: 構文、ノルウェー問題、テストしたその他の罠

YAML は、基本構文、リストとマップ、ノルウェー問題、浮動小数点数に変換されるバージョン、8 進郵便番号、60 進数、アンカー、複数行テキスト、安全な読み込みなどのパーサー テストで説明されています。

記事を読む →
DevOps

Cron ジョブの説明: 構文、実際のスケジュール、およびそれらを壊す間違い

Cron ジョブは、検証したスケジュールとともに説明されています。5 つのフィールド、演算子、実際の例、月日または曜日のトラップ、環境の問題、ロギング、重複、タイム ゾーンです。

記事を読む →
人工知能

AI 幻覚の説明: 言語モデルが物事をでっち上げる理由とそれを軽減する方法

AI 幻覚について説明しました。幻覚とは何か、言語モデルが幻覚を生成する理由、一般的な種類、グラウンディングとプロンプトで幻覚を軽減する方法、そして私たちが実行した簡単なチェックです。

記事を読む →
DevOps

環境変数の説明: .env ファイル、シークレット、および設定が正しく行われている

実行した Python の例を使用して環境変数について説明します。環境変数の読み取りと設定、すべての値が文字列である理由、.env ファイル、プロセスの継承、シークレット、検証について説明します。

記事を読む →
ソフトウェア開発

API レート制限の説明: アルゴリズム、ヘッダー、および 429 エラーの処理

API レート制限については、実行したシミュレーションで説明します。トークン バケット、固定ウィンドウ、スライディング ウィンドウ、429 応答、レート制限ヘッダー、バックオフによる再試行、およびテスト制限です。

記事を読む →
テスト自動化

Python でのモッキング:unittest.mock、patch、およびテストを嘘にする間違い

Python でのunittest.mockによるモック、テスト済み: モックとreturn_value、side_effect、名前が使用されている場所のパッチ、仕様と自動仕様、日付のモック、およびよくある間違い。

記事を読む →
ソフトウェアテスト

コードカバレッジの説明: 回線カバレッジとブランチカバレッジ、および 100% の実際の意味

実際のcoverage.pyの実行でコードカバレッジを説明: 行、分岐、条件のカバレッジ、レポートの読み取り、100%のカバレッジでもバグを見逃す可能性がある理由、および賢明なターゲット。

記事を読む →
データベースとSQL

SQL における DELETE、TRUNCATE、DROP: 違い、ロールバック、およびそれぞれをいつ使用するか

DELETE、TRUNCATE、DROP について、テスト済み SQL を使用して説明します。それぞれの削除内容、ロールバック、トリガー、ID リセット、速度、PostgreSQL、MySQL、SQL Server、SQLite の違いについて説明します。

記事を読む →
データベースとSQL

SQL ビューの説明: 作成、使用、落とし穴の回避、例を示します

SQL ビューについて、実行したクエリとともに説明しました。ビューの作成、ライブ結果、列の非表示、パフォーマンス、更新可能なビューと具体化されたビュー、壊れた依存関係、ベスト プラクティスについて説明します。

記事を読む →
ソフトウェア開発

TypeScript インターフェイスと型: 実際の違い、コンパイラでテスト

TypeScript インターフェイスと型、実際のコンパイラでチェック: 両方でできること、片方だけでできること、宣言のマージ、拡張と交差、および従うべき簡単なルール。

記事を読む →
ソフトウェア開発

Python *args と **kwargs の説明: 柔軟な関数と明確な例

Python の *args と **kwargs について、実行したコードで説明しました。パッキングとアンパッキング、パラメーターの順序、キーワードのみの引数と位置のみの引数、デコレーター、一般的なエラーです。

記事を読む →
ソフトウェア開発

Python Lambda 関数: 構文、実際の用途、および使用すべきでない場合

Python のラムダ関数について、実行したコードとともに説明します。構文、キーによるソート、マップとフィルター、クロージャー、遅延バインディング トラップ、通常の def がより適切な選択である場合。

記事を読む →
人工知能

AIエージェントとは何ですか?シンプルなエージェント ループを実行できる仕組み

AIエージェントとは何ですか?エージェント ループ、ツール、メモリ、ガードレール、実行した小さな Python ループ、実際のリスク、およびシンプルなチャットボットがより良い選択である場合についてのわかりやすいガイドです。

記事を読む →
DevOps

モニタリングと可観測性: ログ、メトリクス、トレースによる本当の違い

モニタリングと可観測性について説明: 既知および未知の障害、ログ、メトリクスとトレース、チェックアウト インシデントのウォークスルー、ゴールデン シグナル、OpenTelemetry、および便利なアラート。

記事を読む →
DevOps

Docker ボリュームとバインド マウント: コンテナ データを正しい方法で保持する

Docker ボリュームとバインド マウントについて説明します。コンテナ データが消える理由、名前付きボリューム、バインド マウント、tmpfs、Compose の例、バックアップ、アクセス許可、およびそれぞれをいつ使用するかについて説明します。

記事を読む →
テスト自動化

TDD と BDD: 主な違い、1 つの機能が両方の方法で構築され、それぞれをいつ使用するか

TDD と BDD は、両方の方法で構築された 1 つの割引機能で説明されています。実行したコードによるレッド-グリーン-リファクタリング、Given-When-Then シナリオ、ツール、トレードオフ、およびそれぞれをいつ使用するかです。

記事を読む →
ソフトウェアテスト

ユーザー受け入れテスト (UAT): プロセス、チェックリスト、および実際の例

ユーザー受け入れテストの説明: 誰が実行するか、QA との違い、7 段階のプロセス、UAT テスト ケース テンプレート、チェックリスト、サインオフ基準、およびよくある間違い。

記事を読む →
データベースとSQL

SQL NULL 値の説明: IS NULL、COALESCE、NULLIF、および回避すべきトラップ

SQL の NULL 値について、実行したクエリで説明しました。3 つの値のロジック、IS NULL、COALESCE、NULLIF、集計、結合、並べ替えでの NULL の扱い方、およびそれが密かに引き起こすバグです。

記事を読む →
データベースとSQL

SQL CASE WHEN ステートメント: 構文、実際の例、およびよくある間違い

SQL CASE WHEN では、単純な検索フォーム、条件順序、SUM を使用したピボット、COUNT トリック、カスタム並べ替え、更新、回避すべき NULL トラップなど、実行したクエリを使用して説明しました。

記事を読む →
ソフトウェア開発

JWTとは何ですか? JSON Web トークンを実際の例で説明する

JWTとは何ですか? JSON Web トークンについて説明しました。3 つの部分、実行したコード内で構築および改ざんされたトークン、JWT とセッション、ストレージ、リフレッシュ トークン、およびセキュリティ上の間違いです。

記事を読む →
ソフトウェア開発

JavaScript イベントループの説明: コールスタック、マイクロタスク、タイマーと例

JavaScript イベント ループについて、実行したコードで説明しました。コール スタック、タスク キュー、マイクロタスク キュー、setTimeout 0 が即時ではない理由、ブロッキング、スターベーション、およびインタビュー クイズです。

記事を読む →
ソフトウェア開発

Python ジェネレーターと収量の説明: 実際の例でメモリを節約する

Python ジェネレーターと Yield について、実行したコードを使用して説明します。一時停止と再開の方法、メモリ節約の測定、パイプライン、無限シーケンス、Yield from、send、および一般的なトラップについて説明します。

記事を読む →
人工知能

埋め込みとは何ですか?ベクトルとコサインの類似度を簡単に説明

埋め込みとは何ですか?ベクトル、コサイン類似度、セマンティック検索に関する平易なガイド。私たちが実行した小さな例、一般的な使用法、モデルの選択、既知の制限が含まれています。

記事を読む →
DevOps

Blue-Green デプロイメントと Canary デプロイメント: 違い、トレードオフ、および選択方法

ブルー グリーン デプロイメントとカナリア デプロイメントについて説明: それぞれの仕組み、コスト、リスクとロールバック、テストした安定したユーザー バケット化、データベース移行、ローリング アップデート、および選択方法。

記事を読む →
テスト自動化

不安定なテスト: 問題の原因とそれを永久に修正する方法

不安定なテストについては、私たちが実行したデモを使用して説明しました。主な原因、確認および診断する方法、タイミングの適切な修正、共有された状態と日付、隔離プロセスなどです。

記事を読む →
ソフトウェアテスト

負荷テストとストレス テスト: 違い、メトリクス、および k6 の例

ロード テストとストレス テストについて説明します。それぞれが何を証明するか、スパイク テストとソーク テスト、重要な指標、平均値が誤解を招く理由、K6 の例、テストの計画方法について説明します。

記事を読む →
ソフトウェアテスト

テスト ケースとテスト シナリオ: 主な違い、例、およびそれぞれをいつ使用するか

テスト ケースとテスト シナリオの説明: 明確な定義、並べて表、シナリオからケースへの 1 つのパスワード リセット機能、テンプレート、およびそれぞれをいつ使用するか。

記事を読む →
データベースとSQL

SQL クエリの最適化: 実行プランを読み取り、タイミングを考慮して遅いクエリを修正

SQL クエリの最適化は 100 万行でテストされています。実行プランの読み取り、適切なインデックスの追加、検索対象外のフィルターの修正、複合インデックスとキーセットのページネーションの使用。

記事を読む →
データベースとSQL

SQL UNION と UNION ALL: 違い、例、テストされたパフォーマンス

SQL UNION と UNION ALL について、実行したクエリで説明しました。重複、両方に従うルール、実際のデータのバグ、測定されたパフォーマンス、INTERSECT と EXCEPT、およびそれぞれをいつ使用するかについて説明します。

記事を読む →
ソフトウェア開発

JavaScript Fetch API チュートリアル: GET、POST、エラー処理、タイムアウト

ローカル サーバーに対してテストされた JavaScript Fetch API チュートリアル: GET と POST、404 がスローされない理由、再利用可能なヘルパー、クエリ文字列、タイムアウト、CORS、およびよくある間違い。

記事を読む →
ソフトウェア開発

Python ファイル処理: 読み取り、書き込み、CSV、JSON、パスライブラリと例

Python のファイル処理について、実行したコードで説明します。オープン モード、大きいファイルの読み取り、CSV、JSON、パスライブラリ、バイナリ ファイル、安全な書き込み、エラー処理、およびよくある間違いについて説明します。

記事を読む →
ソフトウェア開発

Python のクラスとオブジェクト: 実際の例を含む OOP チュートリアル

Python のクラスとオブジェクトについて、実行したコードとともに説明します: __init__、メソッド、クラスとインスタンスの属性、継承、プロパティ、ダンダー メソッド、データクラス、およびよくある間違い。

記事を読む →
人工知能

大規模言語モデルとは何ですか? LLM の仕組みを誇大広告なしで説明

大規模言語モデルとは何ですか? LLM は、トークン、エンベディング、アテンション、トレーニング、温度およびコンテキスト ウィンドウ、小さな次の単語のデモ、実際の制限など、平易な言葉で説明されています。

記事を読む →
DevOps

初心者のための Linux コマンド: 例を含む基本ターミナル ガイド

初心者向けの Linux コマンド。ナビゲーション、ファイル、ログの表示、grep、パイプ、権限、プロセス、アーカイブなどのタスク別にグループ化されており、実用的なログ分析の例も含まれています。

記事を読む →
テスト自動化

Selenium と Playwright: 主な違い、コードの比較、どちらを選択するか

Selenium と Playwright の比較: アーキテクチャ、待機、ブラウザと言語のサポート、デバッグ、両方のツールでの同じテスト、移行のアドバイスと選択方法。

記事を読む →
ソフトウェアテスト

等価性分割: テスト設計手法を実際の例で説明

等価性パーティション化について説明しました。有効なパーティションと無効なパーティションを見つける方法、年齢、パスワード、クーポンに関する実際の例、実行したテスト、境界と組み合わせる理由。

記事を読む →
ソフトウェアテスト

ソフトウェアテストにおける重大度と優先度: 相違点、マトリックス、および実際の例

ソフトウェア テストにおける重大度と優先度について説明します。明確な定義、例を含む 4 方向のマトリックス、レベル スケール、それぞれの設定者、バグ トリアージの実行方法。

記事を読む →
データベースとSQL

SQL サブクエリのチュートリアル: 型、相関サブクエリ、および EXISTS と例

実行したクエリを含む SQL サブクエリのチュートリアル: スカラー、IN、FROM、SELECT サブクエリ、相関サブクエリ、EXISTS、NOT IN NULL トラップ、サブクエリ対 JOIN 対 CTE。

記事を読む →
データベースとSQL

SQL トランザクションと ACID の説明: COMMIT、ROLLBACK、分離レベル

SQL トランザクションと ACID について、実行した銀行振込で説明しました。COMMIT、ROLLBACK、セーブポイント、ロック、分離レベル、ダーティ リード、デッドロック、ベスト プラクティスについて説明します。

記事を読む →
ソフトウェア開発

Git コマンドのチートシート: 実際に使用するコマンドと例

実際のデモ リポジトリからの出力を含む、タスク別にグループ化された Git コマンド チート シート (セットアップ、ステージング、ブランチ、リモート、スタッシュ、履歴、間違いの取り消し)。

記事を読む →
ソフトウェア開発

JavaScript Promise の説明: then、catch、Promise.all、およびよくある間違い

JavaScript の Promise を、実行したコードで説明します。ステート、then および catch チェーン、エラー処理、Promise.all、allSettled、race および any、イベント ループ、およびよくある間違いです。

記事を読む →
ソフトウェア開発

Python 辞書チュートリアル: メソッド、例、一般的なパターン

私たちが実行したコードを含む Python 辞書チュートリアル: 辞書の作成、読み取り、更新、主要なメソッド、マージ、内包表記、パターンのカウントとグループ化、およびよくある間違い。

記事を読む →
人工知能

RAGとは何ですか?検索拡張生成を実際の例で説明する

RAGとは何ですか?検索拡張生成について、インデックス作成、チャンク化、埋め込み、検索、実際に動作する小さな Python の例、評価、一般的な失敗など、ステップごとに説明します。

記事を読む →
DevOps

初心者向け Terraform チュートリアル: 最初のファイルからモジュールまでのコードとしてのインフラストラクチャ

初心者向けの Terraform チュートリアル: クラウド アカウントなしで開始し、初期化、計画、適用を学び、次に変数、出力、状態、モジュール、安全なチーム ワークフローを学びます。

記事を読む →
DevOps

Docker と Kubernetes: 主な違い、連携方法、どちらが必要か

Docker と Kubernetes について説明しました。それぞれの機能、同じアプリを両方で実行すること、Docker Compose と Swarm の比較、dockershim の変更、必要なものを決定する方法などです。

記事を読む →
テスト自動化

初心者向けの Pytest チュートリアル: フィクスチャ、パラメータ化、実際の例

pytest 9.2 で実行したテストを含む初心者向けの pytest チュートリアル: アサーション、フィクスチャ、parametrize、conftest、マーカー、tmp_path、monkeypatch、便利なフラグ、CI。

記事を読む →
ソフトウェアテスト

ソフトウェア テスト ライフ サイクル (STLC): 6 つのフェーズ、開始基準と終了基準、例

ソフトウェア テストのライフ サイクルについては、開始基準と終了基準を含む 6 つの STLC フェーズ、成果物、実際に動作するログイン機能の例、STLC と SDLC、およびアジャイルにおける STLC について説明しました。

記事を読む →
ソフトウェア開発

Git mergeとrebaseの違い:例と使い分け

Git mergeとrebaseの違いを、実際のログ出力、比較表、rebaseの黄金律、安全なチームワークフローで解説します。

記事を読む →
ソフトウェア開発

Pythonのリスト内包表記:構文・例・使うべきでない場面

Pythonのリスト内包表記を解説:構文、フィルタ、if-else、ネストしたループ、実測した処理時間、そして通常のforループの方が良い場面。

記事を読む →
データベースとSQL

SQL JOINを例で解説(Inner・Left・Right・Full)

サンプルのテーブルとクエリでSQL JOINを順に解説。INNER、LEFT、RIGHT、FULL、CROSS、SELFに加え、よくある間違いとパフォーマンスのコツも紹介します。

記事を読む →