Skip to content

Commit 12b0cf1

Browse files
committed
Clarify named permission sets in configuration.md
1 parent cf3dd87 commit 12b0cf1

File tree

1 file changed

+15
-3
lines changed

1 file changed

+15
-3
lines changed

runtime/fundamentals/configuration.md

Lines changed: 15 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -527,11 +527,22 @@ import * as module_2 from "@example/my-package/module2";
527527

528528
## Permissions
529529

530-
Deno 2.5+ supports storing permission sets in the config file.
530+
Deno 2.5+ supports storing
531+
[permission](/runtime/fundamentals/security/#permissions) sets in the config
532+
file.
531533

532534
### Named permissions
533535

534-
Permissions can be defined in key value pairs under the `"permissions"` key:
536+
Permissions can be defined as key-value pairs under arbitrarily-named permission
537+
sets under the `"permissions"` key. Within each set,
538+
539+
- the key is the name of a
540+
[permission](/runtime/fundamentals/security/#permissions) that would follow
541+
`--allow-` or `--deny-` in the CLI invocation (i.e. `read`, `write`, `net`,
542+
`env`, `sys`, `run`, `ffi`, `import`)
543+
- the value is a boolean (`true` / `false` correspond to allow / deny), an array
544+
of strings representing paths, domains etc., or an object with `allow`,
545+
`deny`, and/or `ignore` boolean key-value pairs.
535546

536547
```jsonc
537548
{
@@ -547,7 +558,8 @@ Permissions can be defined in key value pairs under the `"permissions"` key:
547558
}
548559
```
549560

550-
Then used by specifying the `--permission-set=<name>` or `-P=<name>` flag:
561+
Permission sets can be used by specifying the `--permission-set=<name>` or
562+
`-P=<name>` flag:
551563

552564
```sh
553565
$ deno run -P=read-data main.ts

0 commit comments

Comments
 (0)