{
  "description": "Test vectors for verifying the Mountaya-Signature header of a webhook delivery. The signature is the lowercase hexadecimal HMAC-SHA256 of `<t>.<body>`, keyed by the endpoint's secret as UTF-8 bytes, its `whsk_` prefix included, where `<t>` is the header's `t` and `<body>` the request body exactly as it arrived. The header is `t=<t>,v1=<signature>`, with one `v1` per secret in force: two while a rotated secret overlaps its successor. A receiver accepts a delivery when one `v1` equals the signature it computes with its secret, compared in constant time, and `t` is within `tolerance_seconds` of its own clock, either way. Every case gives the secret the receiver holds, the receiver's clock as `now`, the header and the body, and whether the delivery verifies; `signatures` gives each signature the header carries, and `signed_body`, where the body was changed on the way, the body they were computed over. scripts/check-events.mjs recomputes every one.",
  "algorithm": "hmac-sha256",
  "tolerance_seconds": 300,
  "cases": [
    {
      "name": "valid",
      "description": "One secret in force, and the receiver's clock 5 seconds past `t`.",
      "secret": "whsk_8f3c2a71b845d0e4c7a6b3f180d92e5a17c4e9b0d36f2a58e1c7b4093d6a2f15",
      "now": 1763111569,
      "header": "t=1763111564,v1=ad18de77c0892dba398f210f0f3205666e41c17025feaf8d42ae5998d8545f5d",
      "body": "{\"id\":\"019a8eed-e1ad-7753-b049-b0e20d79577a\",\"object\":\"webhook_event\",\"type\":\"organization.member.updated\",\"api_version\":\"0.8.0\",\"created_at\":\"2026-11-14T09:12:44Z\",\"organization_id\":\"d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b\",\"task\":\"organization.member.update\",\"related_object\":{\"type\":\"organization.member\",\"id\":\"7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1\"},\"data\":{\"object\":{\"object\":\"organization.member\",\"user_id\":\"7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1\",\"role\":\"contributor\",\"joined_at\":\"2026-03-11T14:02:09Z\"},\"previous_attributes\":{\"role\":\"viewer\"}},\"request\":{\"id\":\"2c5ed6d8b8f7c706e9a0d5c5144ed90b\"},\"actor\":{\"type\":\"user\",\"user_id\":\"1b9d4e72-0c35-4a8f-b6e1-5f2c7d904a18\",\"key_id\":\"3b1f9c02-6d4e-4a87-b5c1-70e2af3d8916\"}}",
      "signatures": [
        {
          "secret": "whsk_8f3c2a71b845d0e4c7a6b3f180d92e5a17c4e9b0d36f2a58e1c7b4093d6a2f15",
          "signature": "ad18de77c0892dba398f210f0f3205666e41c17025feaf8d42ae5998d8545f5d"
        }
      ],
      "expect": {
        "valid": true
      }
    },
    {
      "name": "rotation-new-secret",
      "description": "During a rotation the header carries one `v1` per secret; a receiver holding the new secret verifies the first.",
      "secret": "whsk_8f3c2a71b845d0e4c7a6b3f180d92e5a17c4e9b0d36f2a58e1c7b4093d6a2f15",
      "now": 1763111594,
      "header": "t=1763111564,v1=ad18de77c0892dba398f210f0f3205666e41c17025feaf8d42ae5998d8545f5d,v1=4e6b9453fbe787bdc2f4a686b21a2e572f6070a0c5ec7bdfa418198b8e253174",
      "body": "{\"id\":\"019a8eed-e1ad-7753-b049-b0e20d79577a\",\"object\":\"webhook_event\",\"type\":\"organization.member.updated\",\"api_version\":\"0.8.0\",\"created_at\":\"2026-11-14T09:12:44Z\",\"organization_id\":\"d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b\",\"task\":\"organization.member.update\",\"related_object\":{\"type\":\"organization.member\",\"id\":\"7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1\"},\"data\":{\"object\":{\"object\":\"organization.member\",\"user_id\":\"7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1\",\"role\":\"contributor\",\"joined_at\":\"2026-03-11T14:02:09Z\"},\"previous_attributes\":{\"role\":\"viewer\"}},\"request\":{\"id\":\"2c5ed6d8b8f7c706e9a0d5c5144ed90b\"},\"actor\":{\"type\":\"user\",\"user_id\":\"1b9d4e72-0c35-4a8f-b6e1-5f2c7d904a18\",\"key_id\":\"3b1f9c02-6d4e-4a87-b5c1-70e2af3d8916\"}}",
      "signatures": [
        {
          "secret": "whsk_8f3c2a71b845d0e4c7a6b3f180d92e5a17c4e9b0d36f2a58e1c7b4093d6a2f15",
          "signature": "ad18de77c0892dba398f210f0f3205666e41c17025feaf8d42ae5998d8545f5d"
        },
        {
          "secret": "whsk_2d9e41f7a0c35b86e2f1d4c907a3b58e6c1f2d4a9b07e35c8d6f1a2b4c3e5d70",
          "signature": "4e6b9453fbe787bdc2f4a686b21a2e572f6070a0c5ec7bdfa418198b8e253174"
        }
      ],
      "expect": {
        "valid": true
      }
    },
    {
      "name": "rotation-previous-secret",
      "description": "The same delivery, verified by a receiver still holding the previous secret, which matches the second `v1`.",
      "secret": "whsk_2d9e41f7a0c35b86e2f1d4c907a3b58e6c1f2d4a9b07e35c8d6f1a2b4c3e5d70",
      "now": 1763111594,
      "header": "t=1763111564,v1=ad18de77c0892dba398f210f0f3205666e41c17025feaf8d42ae5998d8545f5d,v1=4e6b9453fbe787bdc2f4a686b21a2e572f6070a0c5ec7bdfa418198b8e253174",
      "body": "{\"id\":\"019a8eed-e1ad-7753-b049-b0e20d79577a\",\"object\":\"webhook_event\",\"type\":\"organization.member.updated\",\"api_version\":\"0.8.0\",\"created_at\":\"2026-11-14T09:12:44Z\",\"organization_id\":\"d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b\",\"task\":\"organization.member.update\",\"related_object\":{\"type\":\"organization.member\",\"id\":\"7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1\"},\"data\":{\"object\":{\"object\":\"organization.member\",\"user_id\":\"7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1\",\"role\":\"contributor\",\"joined_at\":\"2026-03-11T14:02:09Z\"},\"previous_attributes\":{\"role\":\"viewer\"}},\"request\":{\"id\":\"2c5ed6d8b8f7c706e9a0d5c5144ed90b\"},\"actor\":{\"type\":\"user\",\"user_id\":\"1b9d4e72-0c35-4a8f-b6e1-5f2c7d904a18\",\"key_id\":\"3b1f9c02-6d4e-4a87-b5c1-70e2af3d8916\"}}",
      "signatures": [
        {
          "secret": "whsk_8f3c2a71b845d0e4c7a6b3f180d92e5a17c4e9b0d36f2a58e1c7b4093d6a2f15",
          "signature": "ad18de77c0892dba398f210f0f3205666e41c17025feaf8d42ae5998d8545f5d"
        },
        {
          "secret": "whsk_2d9e41f7a0c35b86e2f1d4c907a3b58e6c1f2d4a9b07e35c8d6f1a2b4c3e5d70",
          "signature": "4e6b9453fbe787bdc2f4a686b21a2e572f6070a0c5ec7bdfa418198b8e253174"
        }
      ],
      "expect": {
        "valid": true
      }
    },
    {
      "name": "tampered-body",
      "description": "The header was computed over the body as sent, and the body was changed on the way: no `v1` matches.",
      "secret": "whsk_8f3c2a71b845d0e4c7a6b3f180d92e5a17c4e9b0d36f2a58e1c7b4093d6a2f15",
      "now": 1763111569,
      "header": "t=1763111564,v1=ad18de77c0892dba398f210f0f3205666e41c17025feaf8d42ae5998d8545f5d",
      "body": "{\"id\":\"019a8eed-e1ad-7753-b049-b0e20d79577a\",\"object\":\"webhook_event\",\"type\":\"organization.member.updated\",\"api_version\":\"0.8.0\",\"created_at\":\"2026-11-14T09:12:44Z\",\"organization_id\":\"d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b\",\"task\":\"organization.member.update\",\"related_object\":{\"type\":\"organization.member\",\"id\":\"7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1\"},\"data\":{\"object\":{\"object\":\"organization.member\",\"user_id\":\"7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1\",\"role\":\"admin\",\"joined_at\":\"2026-03-11T14:02:09Z\"},\"previous_attributes\":{\"role\":\"viewer\"}},\"request\":{\"id\":\"2c5ed6d8b8f7c706e9a0d5c5144ed90b\"},\"actor\":{\"type\":\"user\",\"user_id\":\"1b9d4e72-0c35-4a8f-b6e1-5f2c7d904a18\",\"key_id\":\"3b1f9c02-6d4e-4a87-b5c1-70e2af3d8916\"}}",
      "signed_body": "{\"id\":\"019a8eed-e1ad-7753-b049-b0e20d79577a\",\"object\":\"webhook_event\",\"type\":\"organization.member.updated\",\"api_version\":\"0.8.0\",\"created_at\":\"2026-11-14T09:12:44Z\",\"organization_id\":\"d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b\",\"task\":\"organization.member.update\",\"related_object\":{\"type\":\"organization.member\",\"id\":\"7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1\"},\"data\":{\"object\":{\"object\":\"organization.member\",\"user_id\":\"7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1\",\"role\":\"contributor\",\"joined_at\":\"2026-03-11T14:02:09Z\"},\"previous_attributes\":{\"role\":\"viewer\"}},\"request\":{\"id\":\"2c5ed6d8b8f7c706e9a0d5c5144ed90b\"},\"actor\":{\"type\":\"user\",\"user_id\":\"1b9d4e72-0c35-4a8f-b6e1-5f2c7d904a18\",\"key_id\":\"3b1f9c02-6d4e-4a87-b5c1-70e2af3d8916\"}}",
      "signatures": [
        {
          "secret": "whsk_8f3c2a71b845d0e4c7a6b3f180d92e5a17c4e9b0d36f2a58e1c7b4093d6a2f15",
          "signature": "ad18de77c0892dba398f210f0f3205666e41c17025feaf8d42ae5998d8545f5d"
        }
      ],
      "expect": {
        "valid": false,
        "reason": "signature"
      }
    },
    {
      "name": "outside-tolerance",
      "description": "A correct signature, received 301 seconds after `t`: past the 300-second tolerance, a replay is refused.",
      "secret": "whsk_8f3c2a71b845d0e4c7a6b3f180d92e5a17c4e9b0d36f2a58e1c7b4093d6a2f15",
      "now": 1763111865,
      "header": "t=1763111564,v1=ad18de77c0892dba398f210f0f3205666e41c17025feaf8d42ae5998d8545f5d",
      "body": "{\"id\":\"019a8eed-e1ad-7753-b049-b0e20d79577a\",\"object\":\"webhook_event\",\"type\":\"organization.member.updated\",\"api_version\":\"0.8.0\",\"created_at\":\"2026-11-14T09:12:44Z\",\"organization_id\":\"d5a83e17-92c6-4b0f-a7d3-1e6482f9c05b\",\"task\":\"organization.member.update\",\"related_object\":{\"type\":\"organization.member\",\"id\":\"7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1\"},\"data\":{\"object\":{\"object\":\"organization.member\",\"user_id\":\"7a4e1c98-3b52-4f60-9d81-c05e2f7a83b1\",\"role\":\"contributor\",\"joined_at\":\"2026-03-11T14:02:09Z\"},\"previous_attributes\":{\"role\":\"viewer\"}},\"request\":{\"id\":\"2c5ed6d8b8f7c706e9a0d5c5144ed90b\"},\"actor\":{\"type\":\"user\",\"user_id\":\"1b9d4e72-0c35-4a8f-b6e1-5f2c7d904a18\",\"key_id\":\"3b1f9c02-6d4e-4a87-b5c1-70e2af3d8916\"}}",
      "signatures": [
        {
          "secret": "whsk_8f3c2a71b845d0e4c7a6b3f180d92e5a17c4e9b0d36f2a58e1c7b4093d6a2f15",
          "signature": "ad18de77c0892dba398f210f0f3205666e41c17025feaf8d42ae5998d8545f5d"
        }
      ],
      "expect": {
        "valid": false,
        "reason": "timestamp"
      }
    }
  ]
}
