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