diff --git a/website/content/docs/commands/roles/add-grant-scopes.mdx b/website/content/docs/commands/roles/add-grant-scopes.mdx index 7c1a4142b..347a0a5db 100644 --- a/website/content/docs/commands/roles/add-grant-scopes.mdx +++ b/website/content/docs/commands/roles/add-grant-scopes.mdx @@ -33,10 +33,14 @@ $ boundary roles add-grant-scopes [options] [args] ### Command options - `-grant-scope-id=` - The scope IDs that inherit grants set on the role. -You can specify the following values: + You can specify the following values: - `this` - Applies to the current scope. - `children` - Applies to all direct children of the scope and can only be used with global and org scopes. - `descendants` - Applies to all descendants of the scope and can only be used with the global scope. + + Boundary does not allow you to create redudnant grant scopes. + For example, if an org scope inherits a grant from the global scope, you cannot apply the same grant directly to the org scope. + - `-id=` - The ID of the role you want to add grant scopes to. - `-version=` The version of the role to add grant scopes to. If you do not specify a version, the command performs a check-and-set automatically. diff --git a/website/content/docs/commands/roles/remove-grant-scopes.mdx b/website/content/docs/commands/roles/remove-grant-scopes.mdx index c37201c76..c78a8ba13 100644 --- a/website/content/docs/commands/roles/remove-grant-scopes.mdx +++ b/website/content/docs/commands/roles/remove-grant-scopes.mdx @@ -34,10 +34,14 @@ $ boundary roles remove-grant-scopes [options] [args] ### Command options - `-grant-scope-id=` - The scope IDs that inherit grants removed from the role. -You can specify the following values: + You can specify the following values: - `this` - Applies to the current scope. - `children` - Applies to all direct children of the scope and can only be used with global and org scopes. - `descendants` - Applies to all descendants of the scope and can only be used with the global scope. + + Boundary does not allow you to create redudnant grant scopes. + For example, if an org scope inherits a grant from the global scope, you cannot apply the same grant directly to the org scope. + - `-id=` - The ID of the role you want to remove grant scopes from. - `-version=` The version of the role to remove grant scopes from. If you do not specify a version, the command performs a check-and-set automatically. diff --git a/website/content/docs/commands/roles/set-grant-scopes.mdx b/website/content/docs/commands/roles/set-grant-scopes.mdx index 0e3c77f79..51042419c 100644 --- a/website/content/docs/commands/roles/set-grant-scopes.mdx +++ b/website/content/docs/commands/roles/set-grant-scopes.mdx @@ -33,10 +33,14 @@ $ boundary roles set-grant-scopes [options] [args] ### Command options - `-grant-scope-id=` - The scope IDs that inherit grants set on the role. -You can specify the following values: + You can specify the following values: - `this` - Applies to the current scope. - `children` - Applies to all direct children of the scope and can only be used with global and org scopes. - `descendants` - Applies to all descendants of the scope and can only be used with the global scope. + + Boundary does not allow you to create redudnant grant scopes. + For example, if an org scope inherits a grant from the global scope, you cannot apply the same grant directly to the org scope. + - `-id=` - The ID of the role you want to set grant scopes on. - `-version=` The version of the role to set grant scopes on. If you do not specify a version, the command performs a check-and-set automatically. diff --git a/website/content/docs/concepts/domain-model/scopes.mdx b/website/content/docs/concepts/domain-model/scopes.mdx index 92fbd3991..3018f3043 100644 --- a/website/content/docs/concepts/domain-model/scopes.mdx +++ b/website/content/docs/concepts/domain-model/scopes.mdx @@ -24,6 +24,33 @@ Within the software itself and elsewhere in the documentation, Boundary reliably You can only associate certain resources with specific levels of scopes. For example, while you can create users at the global or org level, you can only create targets within a project. +Refer to the table below for a list of resources and their valid scope types: + +| Resource | Valid scope types | +| -------------------- | -------------------- | +| Accounts | Global, org | +| Aliases | Global | +| Auth methods | Global, org | +| Auth tokens | Global, org | +| Billing | Global | +| Credential libraries | Project | +| Credentials | Project | +| Credential stores | Project | +| Groups | Global, org, project | +| Host catalogs | Project | +| Host sets | Project | +| Hosts | Project | +| Managed groups | Global, org | +| Storage policies | Global, org | +| Roles | Global, org, project | +| Scopes | Global, org, project | +| Session recordings | Global, org | +| Sessions | Project | +| Storage buckets | Global, org | +| Targets | Project | +| Users | Global, org | +| Workers | Global | + You can nest projects within orgs to configure access to resources. For example, you may create an org scope called `IT-Support` that contains the users or groups that make up your IT department.