duksis/cloudflare_access

Elixir Plug for verifying Cloudflare Access headers

CloudflareAccess

Plug for verifying Cloudflare Access headers inside your Plug application.

Installation

If available in Hex, the package can be installed by adding cloudflare_access to your list of dependencies in mix.exs:

def deps do
  [
    {:cloudflare_access, "~> 0.1.0"}
  ]
end

Usage

Adding header check to your router:

defmodule YourAppRouter do
  use Plug.Router

  plug(Plug.CloudflareAccess)

  ...

end

Configuring domain name for Cloudflare Access public key retrieval.

# in your config/config.exs

config :cloudflare_access, domain: "exapmle.com"

For loading Cloudflare public key for your domain on application boot

defmodel YourApplication do
  use Application
  ...
  def start(_type, _args) do
    ...
    # Retrieve CF access certificate from CF and save in ETS
    CloudflareAccess.cache()
    ...
  end
  ...
end

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/cloudflare_access.

License

cloudflare_access is released under the MIT License.