Functional Weave
Code in Rust

auth.rbac@1.0.0

vectors.json

42,103 bytes · view raw

[
 {
  "fn": "resolveRoles",
  "name": "an editor inherits author and viewer, and every grant of the three, sorted",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "editor"
   ]
  ],
  "expect": {
   "roles": [
    "author",
    "editor",
    "viewer"
   ],
   "permissions": [
    "comments:*:own",
    "comments:read",
    "posts:create",
    "posts:delete:own",
    "posts:publish",
    "posts:read",
    "posts:update",
    "posts:update:own"
   ]
  }
 },
 {
  "fn": "resolveRoles",
  "name": "no roles, nothing granted",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   []
  ],
  "expect": {
   "roles": [],
   "permissions": []
  }
 },
 {
  "fn": "resolveRoles",
  "name": "a role given twice counts once",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "viewer",
    "viewer"
   ]
  ],
  "expect": {
   "roles": [
    "viewer"
   ],
   "permissions": [
    "comments:read",
    "posts:read"
   ]
  }
 },
 {
  "fn": "resolveRoles",
  "name": "the * grant sorts first",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "viewer",
    "admin"
   ]
  ],
  "expect": {
   "roles": [
    "admin",
    "viewer"
   ],
   "permissions": [
    "*",
    "comments:read",
    "posts:read"
   ]
  }
 },
 {
  "fn": "resolveRoles",
  "name": "a diamond inherits the shared role once",
  "args": [
   {
    "roles": [
     {
      "name": "a",
      "inherits": [
       "b",
       "c"
      ],
      "permissions": []
     },
     {
      "name": "b",
      "inherits": [
       "d"
      ],
      "permissions": [
       "x:write"
      ]
     },
     {
      "name": "c",
      "inherits": [
       "d"
      ],
      "permissions": []
     },
     {
      "name": "d",
      "inherits": [],
      "permissions": [
       "x:read",
       "x:write"
      ]
     }
    ],
    "permissions": []
   },
   [
    "a"
   ]
  ],
  "expect": {
   "roles": [
    "a",
    "b",
    "c",
    "d"
   ],
   "permissions": [
    "x:read",
    "x:write"
   ]
  }
 },
 {
  "fn": "resolveRoles",
  "name": "a three-role cycle is reported with its path",
  "args": [
   {
    "roles": [
     {
      "name": "a",
      "inherits": [
       "b"
      ],
      "permissions": []
     },
     {
      "name": "b",
      "inherits": [
       "c"
      ],
      "permissions": []
     },
     {
      "name": "c",
      "inherits": [
       "a"
      ],
      "permissions": []
     }
    ],
    "permissions": []
   },
   []
  ],
  "expectError": "role inheritance cycle: a -> b -> c -> a"
 },
 {
  "fn": "resolveRoles",
  "name": "a cycle the given roles never reach is still refused",
  "args": [
   {
    "roles": [
     {
      "name": "x",
      "inherits": [],
      "permissions": [
       "x:read"
      ]
     },
     {
      "name": "p",
      "inherits": [
       "q"
      ],
      "permissions": []
     },
     {
      "name": "q",
      "inherits": [
       "p"
      ],
      "permissions": []
     }
    ],
    "permissions": []
   },
   [
    "x"
   ]
  ],
  "expectError": "role inheritance cycle: p -> q -> p"
 },
 {
  "fn": "resolveRoles",
  "name": "the cycle is reported from the first role in policy order",
  "args": [
   {
    "roles": [
     {
      "name": "b",
      "inherits": [
       "a"
      ],
      "permissions": []
     },
     {
      "name": "a",
      "inherits": [
       "b"
      ],
      "permissions": []
     }
    ],
    "permissions": []
   },
   []
  ],
  "expectError": "role inheritance cycle: b -> a -> b"
 },
 {
  "fn": "resolveRoles",
  "name": "a role inheriting itself",
  "args": [
   {
    "roles": [
     {
      "name": "r",
      "inherits": [
       "r"
      ],
      "permissions": []
     }
    ],
    "permissions": []
   },
   []
  ],
  "expectError": "role inheritance cycle: r -> r"
 },
 {
  "fn": "resolveRoles",
  "name": "an unknown role given",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "owner"
   ]
  ],
  "expectError": "unknown role owner"
 },
 {
  "fn": "resolveRoles",
  "name": "an unknown role inherited",
  "args": [
   {
    "roles": [
     {
      "name": "a",
      "inherits": [
       "ghost"
      ],
      "permissions": []
     }
    ],
    "permissions": []
   },
   []
  ],
  "expectError": "unknown role ghost"
 },
 {
  "fn": "resolveRoles",
  "name": "two roles with one name",
  "args": [
   {
    "roles": [
     {
      "name": "a",
      "inherits": [],
      "permissions": []
     },
     {
      "name": "a",
      "inherits": [],
      "permissions": [
       "x:read"
      ]
     }
    ],
    "permissions": []
   },
   []
  ],
  "expectError": "duplicate role a"
 },
 {
  "fn": "resolveRoles",
  "name": "a third segment other than own",
  "args": [
   {
    "roles": [
     {
      "name": "a",
      "inherits": [],
      "permissions": [
       "posts:read:mine"
      ]
     }
    ],
    "permissions": []
   },
   []
  ],
  "expectError": "invalid grant posts:read:mine"
 },
 {
  "fn": "resolveRoles",
  "name": "upper case in a grant",
  "args": [
   {
    "roles": [
     {
      "name": "a",
      "inherits": [],
      "permissions": [
       "Posts:read"
      ]
     }
    ],
    "permissions": []
   },
   []
  ],
  "expectError": "invalid grant Posts:read"
 },
 {
  "fn": "resolveRoles",
  "name": "a trailing newline in a grant",
  "args": [
   {
    "roles": [
     {
      "name": "a",
      "inherits": [],
      "permissions": [
       "posts:read\n"
      ]
     }
    ],
    "permissions": []
   },
   []
  ],
  "expectError": "invalid grant posts:read"
 },
 {
  "fn": "resolveRoles",
  "name": "a wildcard in the policy's concrete permissions",
  "args": [
   {
    "roles": [
     {
      "name": "a",
      "inherits": [],
      "permissions": []
     }
    ],
    "permissions": [
     "posts:*"
    ]
   },
   []
  ],
  "expectError": "invalid permission posts:*"
 },
 {
  "fn": "hasPermission",
  "name": "a viewer may read posts",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "viewer"
   ],
   "posts:read"
  ],
  "expect": true
 },
 {
  "fn": "hasPermission",
  "name": "a viewer may not update posts",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "viewer"
   ],
   "posts:update"
  ],
  "expect": false
 },
 {
  "fn": "hasPermission",
  "name": "an author may not update every post: their grant is :own",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "author"
   ],
   "posts:update"
  ],
  "expect": false
 },
 {
  "fn": "hasPermission",
  "name": "an author may update their own posts",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "author"
   ],
   "posts:update:own"
  ],
  "expect": true
 },
 {
  "fn": "hasPermission",
  "name": "an editor may update every post",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "editor"
   ],
   "posts:update"
  ],
  "expect": true
 },
 {
  "fn": "hasPermission",
  "name": "an unrestricted grant covers the user's own too",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "viewer"
   ],
   "posts:read:own"
  ],
  "expect": true
 },
 {
  "fn": "hasPermission",
  "name": "* grants a permission nobody listed",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "admin"
   ],
   "billing:refund"
  ],
  "expect": true
 },
 {
  "fn": "hasPermission",
  "name": "an action wildcard with :own",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "author"
   ],
   "comments:delete:own"
  ],
  "expect": true
 },
 {
  "fn": "hasPermission",
  "name": "an action wildcard with :own does not grant every comment",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "author"
   ],
   "comments:delete"
  ],
  "expect": false
 },
 {
  "fn": "hasPermission",
  "name": "a resource wildcard grants the action on any resource",
  "args": [
   {
    "roles": [
     {
      "name": "auditor",
      "inherits": [],
      "permissions": [
       "*:read"
      ]
     }
    ],
    "permissions": []
   },
   [
    "auditor"
   ],
   "invoices:read"
  ],
  "expect": true
 },
 {
  "fn": "hasPermission",
  "name": "a resource wildcard grants no other action",
  "args": [
   {
    "roles": [
     {
      "name": "auditor",
      "inherits": [],
      "permissions": [
       "*:read"
      ]
     }
    ],
    "permissions": []
   },
   [
    "auditor"
   ],
   "invoices:void"
  ],
  "expect": false
 },
 {
  "fn": "hasPermission",
  "name": "no roles, no permission",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [],
   "posts:read"
  ],
  "expect": false
 },
 {
  "fn": "hasPermission",
  "name": "a wildcard is not a permission to ask about",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "viewer"
   ],
   "posts:*"
  ],
  "expectError": "invalid permission posts:*"
 },
 {
  "fn": "hasPermission",
  "name": "one segment is not a permission",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "viewer"
   ],
   "posts"
  ],
  "expectError": "invalid permission posts"
 },
 {
  "fn": "hasPermission",
  "name": "an unknown role",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   [
    "nobody"
   ],
   "posts:read"
  ],
  "expectError": "unknown role nobody"
 },
 {
  "fn": "checkAccess",
  "name": "an editor updates someone else's post",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   {
    "id": "u1",
    "roles": [
     "editor"
    ]
   },
   "update",
   {
    "resourceType": "posts",
    "id": "p1",
    "ownerId": "u2"
   }
  ],
  "expect": {
   "allowed": true,
   "reason": "granted",
   "grant": "posts:update"
  }
 },
 {
  "fn": "checkAccess",
  "name": "an author updates their own post",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   {
    "id": "u1",
    "roles": [
     "author"
    ]
   },
   "update",
   {
    "resourceType": "posts",
    "id": "p1",
    "ownerId": "u1"
   }
  ],
  "expect": {
   "allowed": true,
   "reason": "granted_own",
   "grant": "posts:update:own"
  }
 },
 {
  "fn": "checkAccess",
  "name": "an author may not update someone else's post",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   {
    "id": "u1",
    "roles": [
     "author"
    ]
   },
   "update",
   {
    "resourceType": "posts",
    "id": "p1",
    "ownerId": "u2"
   }
  ],
  "expect": {
   "allowed": false,
   "reason": "not_owner",
   "grant": null
  }
 },
 {
  "fn": "checkAccess",
  "name": "a post with no owner is nobody's own",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   {
    "id": "u1",
    "roles": [
     "author"
    ]
   },
   "update",
   {
    "resourceType": "posts",
    "id": "p1",
    "ownerId": null
   }
  ],
  "expect": {
   "allowed": false,
   "reason": "not_owner",
   "grant": null
  }
 },
 {
  "fn": "checkAccess",
  "name": "a viewer may not delete posts at all",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   {
    "id": "u1",
    "roles": [
     "viewer"
    ]
   },
   "delete",
   {
    "resourceType": "posts",
    "id": "p1",
    "ownerId": "u1"
   }
  ],
  "expect": {
   "allowed": false,
   "reason": "denied",
   "grant": null
  }
 },
 {
  "fn": "checkAccess",
  "name": "an admin's * grant",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   {
    "id": "u1",
    "roles": [
     "admin"
    ]
   },
   "delete",
   {
    "resourceType": "posts",
    "id": "p1",
    "ownerId": null
   }
  ],
  "expect": {
   "allowed": true,
   "reason": "granted",
   "grant": "*"
  }
 },
 {
  "fn": "checkAccess",
  "name": "an author deletes their own comment through comments:*:own",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   {
    "id": "u1",
    "roles": [
     "author"
    ]
   },
   "delete",
   {
    "resourceType": "comments",
    "id": "p1",
    "ownerId": "u1"
   }
  ],
  "expect": {
   "allowed": true,
   "reason": "granted_own",
   "grant": "comments:*:own"
  }
 },
 {
  "fn": "checkAccess",
  "name": "the first grant in sorted order is named",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   {
    "id": "u1",
    "roles": [
     "editor",
     "admin"
    ]
   },
   "update",
   {
    "resourceType": "posts",
    "id": "p1",
    "ownerId": "u2"
   }
  ],
  "expect": {
   "allowed": true,
   "reason": "granted",
   "grant": "*"
  }
 },
 {
  "fn": "checkAccess",
  "name": "an editor reads posts through the inherited viewer grant",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   {
    "id": "u1",
    "roles": [
     "editor"
    ]
   },
   "read",
   {
    "resourceType": "posts",
    "id": "p1",
    "ownerId": null
   }
  ],
  "expect": {
   "allowed": true,
   "reason": "granted",
   "grant": "posts:read"
  }
 },
 {
  "fn": "checkAccess",
  "name": "an empty subject id",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   {
    "id": "",
    "roles": [
     "author"
    ]
   },
   "update",
   {
    "resourceType": "posts",
    "id": "p1",
    "ownerId": ""
   }
  ],
  "expectError": "subject.id must be a non-empty string"
 },
 {
  "fn": "checkAccess",
  "name": "an action with a colon",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   {
    "id": "u1",
    "roles": [
     "author"
    ]
   },
   "update:own",
   {
    "resourceType": "posts",
    "id": "p1",
    "ownerId": "u1"
   }
  ],
  "expectError": "invalid permission posts:update:own"
 },
 {
  "fn": "checkAccess",
  "name": "an upper-case resource type",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   {
    "id": "u1",
    "roles": [
     "author"
    ]
   },
   "update",
   {
    "resourceType": "Posts",
    "id": "p1",
    "ownerId": "u1"
   }
  ],
  "expectError": "invalid permission Posts:update"
 },
 {
  "fn": "checkAccess",
  "name": "an unknown role",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read",
       "comments:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:create",
       "posts:update:own",
       "posts:delete:own",
       "comments:*:own"
      ]
     },
     {
      "name": "editor",
      "inherits": [
       "author"
      ],
      "permissions": [
       "posts:update",
       "posts:publish"
      ]
     },
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update",
     "posts:delete",
     "comments:delete"
    ]
   },
   {
    "id": "u1",
    "roles": [
     "owner"
    ]
   },
   "update",
   {
    "resourceType": "posts",
    "id": "p1",
    "ownerId": "u1"
   }
  ],
  "expectError": "unknown role owner"
 },
 {
  "fn": "accessMatrix",
  "name": "viewer and author over reading and updating posts",
  "args": [
   {
    "roles": [
     {
      "name": "viewer",
      "inherits": [],
      "permissions": [
       "posts:read"
      ]
     },
     {
      "name": "author",
      "inherits": [
       "viewer"
      ],
      "permissions": [
       "posts:update:own"
      ]
     }
    ],
    "permissions": [
     "posts:read",
     "posts:update"
    ]
   }
  ],
  "expect": [
   {
    "name": "viewer may read any posts",
    "role": "viewer",
    "resourceType": "posts",
    "action": "read",
    "own": false,
    "allowed": true
   },
   {
    "name": "viewer may read posts they own",
    "role": "viewer",
    "resourceType": "posts",
    "action": "read",
    "own": true,
    "allowed": true
   },
   {
    "name": "viewer may not update any posts",
    "role": "viewer",
    "resourceType": "posts",
    "action": "update",
    "own": false,
    "allowed": false
   },
   {
    "name": "viewer may not update posts they own",
    "role": "viewer",
    "resourceType": "posts",
    "action": "update",
    "own": true,
    "allowed": false
   },
   {
    "name": "author may read any posts",
    "role": "author",
    "resourceType": "posts",
    "action": "read",
    "own": false,
    "allowed": true
   },
   {
    "name": "author may read posts they own",
    "role": "author",
    "resourceType": "posts",
    "action": "read",
    "own": true,
    "allowed": true
   },
   {
    "name": "author may not update any posts",
    "role": "author",
    "resourceType": "posts",
    "action": "update",
    "own": false,
    "allowed": false
   },
   {
    "name": "author may update posts they own",
    "role": "author",
    "resourceType": "posts",
    "action": "update",
    "own": true,
    "allowed": true
   }
  ]
 },
 {
  "fn": "accessMatrix",
  "name": "an empty policy has no cases",
  "args": [
   {
    "roles": [],
    "permissions": []
   }
  ],
  "expect": []
 },
 {
  "fn": "accessMatrix",
  "name": "roles without permissions have no cases",
  "args": [
   {
    "roles": [
     {
      "name": "a",
      "inherits": [],
      "permissions": [
       "x:read"
      ]
     }
    ],
    "permissions": []
   }
  ],
  "expect": []
 },
 {
  "fn": "accessMatrix",
  "name": "permissions without roles have no cases",
  "args": [
   {
    "roles": [],
    "permissions": [
     "x:read"
    ]
   }
  ],
  "expect": []
 },
 {
  "fn": "accessMatrix",
  "name": "an admin's * allows both",
  "args": [
   {
    "roles": [
     {
      "name": "admin",
      "inherits": [],
      "permissions": [
       "*"
      ]
     }
    ],
    "permissions": [
     "invoices:void"
    ]
   }
  ],
  "expect": [
   {
    "name": "admin may void any invoices",
    "role": "admin",
    "resourceType": "invoices",
    "action": "void",
    "own": false,
    "allowed": true
   },
   {
    "name": "admin may void invoices they own",
    "role": "admin",
    "resourceType": "invoices",
    "action": "void",
    "own": true,
    "allowed": true
   }
  ]
 },
 {
  "fn": "accessMatrix",
  "name": "a role with no grants is denied both",
  "args": [
   {
    "roles": [
     {
      "name": "guest",
      "inherits": [],
      "permissions": []
     }
    ],
    "permissions": [
     "posts:read"
    ]
   }
  ],
  "expect": [
   {
    "name": "guest may not read any posts",
    "role": "guest",
    "resourceType": "posts",
    "action": "read",
    "own": false,
    "allowed": false
   },
   {
    "name": "guest may not read posts they own",
    "role": "guest",
    "resourceType": "posts",
    "action": "read",
    "own": true,
    "allowed": false
   }
  ]
 },
 {
  "fn": "accessMatrix",
  "name": "an :own wildcard allows only the owned case",
  "args": [
   {
    "roles": [
     {
      "name": "member",
      "inherits": [],
      "permissions": [
       "comments:*:own"
      ]
     }
    ],
    "permissions": [
     "comments:delete"
    ]
   }
  ],
  "expect": [
   {
    "name": "member may not delete any comments",
    "role": "member",
    "resourceType": "comments",
    "action": "delete",
    "own": false,
    "allowed": false
   },
   {
    "name": "member may delete comments they own",
    "role": "member",
    "resourceType": "comments",
    "action": "delete",
    "own": true,
    "allowed": true
   }
  ]
 },
 {
  "fn": "accessMatrix",
  "name": "roles come in policy order, not sorted",
  "args": [
   {
    "roles": [
     {
      "name": "b",
      "inherits": [],
      "permissions": [
       "x:a"
      ]
     },
     {
      "name": "a",
      "inherits": [],
      "permissions": []
     }
    ],
    "permissions": [
     "x:a"
    ]
   }
  ],
  "expect": [
   {
    "name": "b may a any x",
    "role": "b",
    "resourceType": "x",
    "action": "a",
    "own": false,
    "allowed": true
   },
   {
    "name": "b may a x they own",
    "role": "b",
    "resourceType": "x",
    "action": "a",
    "own": true,
    "allowed": true
   },
   {
    "name": "a may not a any x",
    "role": "a",
    "resourceType": "x",
    "action": "a",
    "own": false,
    "allowed": false
   },
   {
    "name": "a may not a x they own",
    "role": "a",
    "resourceType": "x",
    "action": "a",
    "own": true,
    "allowed": false
   }
  ]
 },
 {
  "fn": "accessMatrix",
  "name": "a cycle is refused before any case",
  "args": [
   {
    "roles": [
     {
      "name": "a",
      "inherits": [
       "b"
      ],
      "permissions": []
     },
     {
      "name": "b",
      "inherits": [
       "a"
      ],
      "permissions": []
     }
    ],
    "permissions": [
     "x:read"
    ]
   }
  ],
  "expectError": "role inheritance cycle: a -> b -> a"
 },
 {
  "fn": "accessMatrix",
  "name": "an :own permission in the policy's list is refused",
  "args": [
   {
    "roles": [
     {
      "name": "a",
      "inherits": [],
      "permissions": []
     }
    ],
    "permissions": [
     "posts:read:own"
    ]
   }
  ],
  "expectError": "invalid permission posts:read:own"
 }
]