[ { "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" } ]