sync-guy/puter
Watch
1
0
Fork
You've already forked puter
 0
mirror of https://github.com/HeyPuter/puter.git synced 2026-11-01 23:06:52 +01:00
Code Issues Projects Releases Packages Wiki Activity
Page: src backend lists_of_things list_of_permissions
Pages
AI Home README api README api concepts share_link api drivers api group api notifications api share api type_tagged api types app_share api types file_share backend Kernel backend README backend contributors boot_sequence backend contributors modules backend contributors structure backend features protected_apps backend features service_scripts backend howto_make_driver backend lists_of_things list_of_permissions backend lists_of_things list_of_tto_types backend modules puterai requests backend modules test_drivers requests backend notes 2024_10_03_email_in_use_checks contributors comment_prefixes contributors email_testing contributors extensions README contributors extensions definitions contributors extensions events contributors extensions contributors structure contributors vscode devmeta track_comments docmeta gui webpack_attempts phoenix missing_posix phoenix parser planning alternatives_to_$ planning micro_modules prod scratch self_hosters config self_hosters config_values self_hosters credit_context self_hosters domains self_hosters first_run_issues self_hosters instructions self_hosters support src backend A&A auth src backend A&A permission src backend A_and_A auth src backend A_and_A permission src backend Kernel src backend README src backend contributors boot_sequence src backend contributors coding_style src backend contributors modules src backend contributors structure src backend features batch_and_symlinks src backend features metered_services src backend features protected_apps src backend features service_scripts src backend howto_make_driver src backend lists_of_things list_of_permissions src backend lists_of_things list_of_tto_types src backend modules puterai README src backend notes 2024_10_03_email_in_use_checks src backend services config src backend services log src backend src modules puterai README src backend src modules puterai ai_services_config src backend src modules puterai api_examples src backend src modules puterai config src backend src modules puterai contributors ai_usage_testing src backend src modules puterai requests src backend src modules test_drivers requests src gui el() src gui webpack_attempts src phoenix missing_posix src phoenix parser testing_with_email tools api_tester cartesian uncategorized README uncategorized es6_note uncategorized puter_mods
1 src backend lists_of_things list_of_permissions
KernelDeimos edited this page 2025-02-25 15:04:16 -05:00
Table of contents

Permissions

Filesystem Permissions

fs:<PATH-OR-UUID>:<ACCESS-LEVEL>

  • <PATH-OR-UUID> specifies the file that this permission is associated with. The ACL service (which checks filesystem permissions) knows if the value is a path or UUID based on the presence of a leading slash; if it starts with "/" it's a path.
  • <ACCESS-LEVEL> specifies one of: write, read, list, see; where each item in that list implies all the access levels which follow.
  • A permission that grants access to a directory, such as /user/shared, implies access of the same access level to all child file or directory nodes under that location, recursively; fs:/user/shared:read implies fs:/user/shared/nested/file.txt:read
  • The "real" permission is fs:<UUID>:<ACCESS-LEVEL>; whenever path is specified the permission is rewritten. note: future support for other filesystems could make this rewrite rule conditional.

App and Subdomain permissions

site:<NAME-OF-SITE>:access

  • <NAME-OF-SITE> specifies the subdomain that this permission is associated with. Here, "subdomain" means the "name of the subdomain", which means a site accessed via my-name.example.site will be specified here with my-name.
  • This permission is always rewritten as the permission described below (backend does this automatically).

site:uid#<UUID-OF-SITE>:access

  • If the subdomain is not protected, this permission is ignored by the system.
  • If the subdomain is protected, this permission will allow access to the site via a Puter app iframe with a token for the entity to which permission was granted

app:<NAME-OF-APP>:access

  • <NAME-OF-APP> specifies the app that this permission is associated with.
  • This permission is always rewritten as the permission described below (backend does this automatically).

app:uid#<UUID-OF-APP>:access

  • If the app is not protected, this permission is ignored by the system.
  • If the app is protected, this permission will allow reading the app's metadata and seeing that the app exists.

General

API

Concepts

Types

For Contributors

Extensions

Devmeta

Planning

  • Micro Modules
  • [planning alternatives_to_](planning-alternatives_to_)

Self_hosters

Src

Backend

A_and_A

For Contributors

Features

Lists_of_things

Modules

Puterai

Notes

Services

Src

Modules
Puterai

####### For Contributors

Test_drivers

Gui

Phoenix

Tools

Api_tester

Uncategorized

This wiki is generated from the repository. Do not edit files the wiki.

You are reading documentation for Puter, an open-source high-level operating system.

Getting started with Puter on localhost is as simple as:

git clone https://github.com/HeyPuter/puter.git
npm install
npm run start