Question 1

How to set up Canary with Phoenix LiveView hooks?

Accepted Answer

First, implement Canada.Can for your user model, then use `mount_canary` in your LiveView module with options like `model` and `only`/`except` to load and authorize resources based on params or events, as detailed in the README examples.

Question 2

Canary vs Bodyguard: which should I use for Elixir authorization?

Accepted Answer

Canary excels for integrated resource loading with Ecto and Phoenix, while Bodyguard is more flexible for policy-based authorization without Ecto dependencies. Choose Canary if you need automatic data fetching; opt for Bodyguard for complex, decoupled permission logic.

Question 3

How to handle nested resources in Canary?

Accepted Answer

Use the `id_name` option to specify a parent ID param (e.g., 'post_id') in plugs or hooks, allowing Canary to load and authorize the parent resource before accessing child actions, with support for custom error handlers if not found.

Question 4

What's new in Canary 2.0 compared to 1.x?

Accepted Answer

Canary 2.0 adds LiveView support with hooks, deprecates features like `:non_id_actions` in favor of `required: false`, and introduces more configuration options. Check the upgrade guide for migration steps from older versions.

Question 5

Does Canary support role-based access control (RBAC)?

Accepted Answer

Yes, but indirectly: you define RBAC logic in your Canada.Can implementation by checking user roles against actions and resources. Canary handles the enforcement, but you must code the role mappings yourself.

Question 6

How to customize unauthorized error responses in Canary?

Accepted Answer

Configure a handler function in `config :canary` or per-plug using `unauthorized_handler`, which receives the Conn and can redirect, halt, or set flash messages, as shown in the README with `Plug.Conn.halt/1`.

canary

What is canary?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions