mirror of
https://github.com/coder/coder.git
synced 2025-07-08 11:39:50 +00:00
This PR adds an RBAC package for managing using permissions: - The top-level `authz.Authorize` function is the main user-facing entrypoint to the package. - Actual permission evaluation is handled in `policy.rego`. - Unit tests for `authz.Authorize` are in `authz_test.go` - Documentation for the package is in `README.md`. Co-authored-by: Cian Johnston <cian@coder.com>
55 lines
1.8 KiB
Go
55 lines
1.8 KiB
Go
package rbac_test
|
|
|
|
import (
|
|
"context"
|
|
"testing"
|
|
|
|
"github.com/stretchr/testify/require"
|
|
|
|
"github.com/coder/coder/coderd/rbac"
|
|
)
|
|
|
|
// TestExample gives some examples on how to use the authz library.
|
|
// This serves to test syntax more than functionality.
|
|
func TestExample(t *testing.T) {
|
|
t.Parallel()
|
|
ctx := context.Background()
|
|
authorizer, err := rbac.NewAuthorizer()
|
|
require.NoError(t, err)
|
|
|
|
// user will become an authn object, and can even be a database.User if it
|
|
// fulfills the interface. Until then, use a placeholder.
|
|
user := subject{
|
|
UserID: "alice",
|
|
Roles: []rbac.Role{
|
|
rbac.RoleOrgAdmin("default"),
|
|
rbac.RoleMember,
|
|
},
|
|
}
|
|
|
|
//nolint:paralleltest
|
|
t.Run("ReadAllWorkspaces", func(t *testing.T) {
|
|
// To read all workspaces on the site
|
|
err := authorizer.Authorize(ctx, user.UserID, user.Roles, rbac.ActionRead, rbac.ResourceWorkspace.All())
|
|
var _ = err
|
|
require.Error(t, err, "this user cannot read all workspaces")
|
|
})
|
|
|
|
//nolint:paralleltest
|
|
t.Run("ReadOrgWorkspaces", func(t *testing.T) {
|
|
// To read all workspaces on the org 'default'
|
|
err := authorizer.Authorize(ctx, user.UserID, user.Roles, rbac.ActionRead, rbac.ResourceWorkspace.InOrg("default"))
|
|
require.NoError(t, err, "this user can read all org workspaces in 'default'")
|
|
})
|
|
|
|
//nolint:paralleltest
|
|
t.Run("ReadMyWorkspace", func(t *testing.T) {
|
|
// Note 'database.Workspace' could fulfill the object interface and be passed in directly
|
|
err := authorizer.Authorize(ctx, user.UserID, user.Roles, rbac.ActionRead, rbac.ResourceWorkspace.InOrg("default").WithOwner(user.UserID))
|
|
require.NoError(t, err, "this user can their workspace")
|
|
|
|
err = authorizer.Authorize(ctx, user.UserID, user.Roles, rbac.ActionRead, rbac.ResourceWorkspace.InOrg("default").WithOwner(user.UserID).WithID("1234"))
|
|
require.NoError(t, err, "this user can read workspace '1234'")
|
|
})
|
|
}
|