Polizy Troubleshooting

Debug authorization issues when things don't work as expected.

When to Apply

• User says "permission check not working"
• User says "user can't access X but should"
• Error messages from polizy
• User confused about why authorization behaves a certain way
• check() returns false unexpectedly
• check() throws MaxDepthExceededError
• addMember/setParent throws "multiple group/hierarchy relations"
• A temporary grant seems to have replaced a standing one

First Move: Use explain()

Before tracing tuples by hand, ask the engine. explain() returns the exact path that produced (or failed to produce) the decision: