Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Unclear sentences in documentation about ACLs #1841

Open
dariusarnold opened this issue Mar 20, 2024 · 1 comment
Open

Unclear sentences in documentation about ACLs #1841

dariusarnold opened this issue Mar 20, 2024 · 1 comment
Labels
bug Something isn't working documentation Improvements or additions to documentation policy 📝

Comments

@dariusarnold
Copy link

Bug description

The following document contains the sentence

For instance, instead of referring to users when defining groups you must use users (which are the equivalent to user/logins in Tailscale.com).

The sentence is confusing and probably one of the mentions of user is wrong. I think what is meant that instead of defining groups made of users and using the groups for ACL, the users are used directly on the ACL.

When using ACL's the User borders are no longer applied. All machines whichever the User have the ability to communicate with other hosts as long as the ACL's permits this exchange.

Borders are only used once here and not explained. I am having issues understanding what the sentence is supposed to mean. The official Tailscale doc about ACLs doesn't mention borders, but I am not overly familiar with tailscale/headscale, so it might be a common term. I understand this to mean using ACLs allows communication between machines despite them not belonging to the same user account. Is that not possible when ACLs are not in use?

Environment

On the headscale main branch, file was last changed with commit a6bc792.

@dariusarnold dariusarnold added the bug Something isn't working label Mar 20, 2024
@dariusarnold dariusarnold changed the title Strange sentence in documentation about ACLs Unclear sentences in documentation about ACLs Mar 20, 2024
@allamedo
Copy link

allamedo commented Apr 6, 2024

In the ACLs documentation there is also a reference to the ./tests/acls/ directory that doesn't seem to exist anymore.

@kradalby kradalby added documentation Improvements or additions to documentation policy 📝 labels May 8, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working documentation Improvements or additions to documentation policy 📝
Projects
None yet
Development

No branches or pull requests

3 participants