prop/test/microwaveprop/accounts/user_api_token_test.exs
Graham McIntire c6d2c48264
feat: secure /api/v1 REST API for regular-user actions
Adds bearer-token authenticated REST API at /api/v1 covering every
action a non-admin user can perform on the website: contact + beacon
submission, beacon-monitor management, propagation queries, profile
read/update, and self-service API token issuance/revocation.

Security: SHA-256-hashed bearer tokens (mwp_ prefix, plaintext shown
once at creation), RFC 9457 problem+json error responses, RFC 9651
RateLimit-* headers backed by an ETS bucket (600/min per token,
60/min per anonymous IP, 30/min on /auth/tokens), private-contact
filtering by viewer.

Docs at docs/api/README.md (prose reference) and docs/api/openapi.yaml
(OpenAPI 3.1 spec covering every endpoint, response, and schema).

Tests: 124 new tests across schema, plug, error renderer, rate
limiter, fallback, and every controller. 16/17 API modules at 100%
line coverage; FallbackController at 87.5% (one defmodule line, an
Erlang-cover artifact for action_fallback-only modules).
2026-05-09 08:59:54 -05:00

71 lines
2.3 KiB
Elixir

defmodule Microwaveprop.Accounts.UserApiTokenTest do
use Microwaveprop.DataCase, async: true
alias Microwaveprop.Accounts.UserApiToken
alias Microwaveprop.AccountsFixtures
describe "token_prefix/0" do
test "is a stable namespaced prefix" do
assert UserApiToken.token_prefix() == "mwp_"
end
end
describe "build/2" do
setup do
%{user: AccountsFixtures.user_fixture()}
end
test "returns plaintext + valid changeset on good attrs", %{user: user} do
assert {:ok, {plaintext, changeset}} =
UserApiToken.build(user, %{name: "MyLaptop"})
assert String.starts_with?(plaintext, "mwp_")
assert changeset.valid?
assert Ecto.Changeset.get_change(changeset, :user_id) == user.id
assert Ecto.Changeset.get_change(changeset, :token_hash) == UserApiToken.hash_token(plaintext)
end
test "name is required", %{user: user} do
assert {:error, changeset} = UserApiToken.build(user, %{})
assert %{name: ["can't be blank"]} = errors_on(changeset)
refute changeset.valid?
assert changeset.action == :insert
end
test "name length is bounded", %{user: user} do
assert {:error, changeset} =
UserApiToken.build(user, %{name: String.duplicate("x", 200)})
assert %{name: ["should be at most 100 character(s)"]} = errors_on(changeset)
end
test "expires_at must be in the future", %{user: user} do
past = DateTime.add(DateTime.utc_now(), -60, :second)
assert {:error, changeset} =
UserApiToken.build(user, %{name: "n", expires_at: past})
assert %{expires_at: ["must be in the future"]} = errors_on(changeset)
end
test "expires_at in the future is accepted", %{user: user} do
future = DateTime.add(DateTime.utc_now(), 3600, :second)
assert {:ok, {_plaintext, changeset}} =
UserApiToken.build(user, %{name: "n", expires_at: future})
assert changeset.valid?
end
end
describe "hash_token/1" do
test "produces a 32-byte sha256 hash" do
assert byte_size(UserApiToken.hash_token("abc")) == 32
end
test "is deterministic" do
assert UserApiToken.hash_token("x") == UserApiToken.hash_token("x")
assert UserApiToken.hash_token("x") != UserApiToken.hash_token("y")
end
end
end