This uses API v3 of the have i been pwned? to check if an email has appeared in a data breach. It returns the total count of appearances.

It also requires a purchased hibp-api-key, and implements a 12-factor methodology by accessing the hibp-api-key from the system's environment variables.

Examples

iex> Pwned.check_email("test123@example.com")

iex Pwned.check_email("Z76okiy2X1m5PFud8iPUQGqusShCJhg@example.com")

Specs

check_password(String.t()) :: {:ok, integer()} | {:ok, false} | :error

It uses have i been pwned? to verify if a password has appeared in a data breach. In order to protect the value of the source password being searched the value is not sended through the network.

Examples

iex> Pwned.check_password("P@ssw0rd")
{:ok, 47205}

iex> Pwned.check_password("Z76okiy2X1m5PFud8iPUQGqusShCJhg")
{:ok, false}