starred/headscale
1
0
Fork 0
mirror of https://github.com/juanfont/headscale.git synced 2026-01-12 04:10:32 +01:00
Code Issues 98 Packages Projects Releases 10 Wiki Activity

[Bug] Preauthkey always requires a user #1177

New Issue
Open
opened 2025-12-29 02:28:44 +01:00 by adam · 1 comment
adam commented 2025-12-29 02:28:44 +01:00
Owner
Copy Link

Originally created by @nblock on GitHub (Dec 20, 2025).

Is this a support request?

  • This is not a support request

Is there an existing issue for this?

  • I have searched the existing issues

Current Behavior

Creating a preauthkey with tags fails as it currently always requires a user:

$ headscale preauthkeys create --tags tag:foo,tag:bar
Error: required flag(s) "user" not set

In SaaS, one can create an auth key with tags defined. It seems to be sufficient to have those tags defined in the policy in the tagOwners section (note that no owner is defined on those tags):

{
	"tagOwners": {
		"tag:bar": [],
		"tag:foo": [],
	},
	"acls": [
		{
			"action": "accept",
			"src":    ["*"],
			"dst":    ["*:*"],
		}
}

In Headscale, if the preauthkey is assigned to a user:

 headscale preauthkeys list -u 1
ID | Key/Prefix                  | Reusable | Ephemeral | Used  | Expiration          | Created             | Tags   
1  | hskey-auth-CsLiZAFSkM2z-*** | false    | false     | false | 2025-12-20 17:01:54 | 2025-12-20 16:01:54 | tag:bar
   |                             |          |           |       |                     |                     | tag:foo

… it can't be used for non-interactive authentication:

$ tailscale up --login-server https://headscale.example.com --auth-key hskey-auth-CsLiZA... --advertise-tags=tag:bar,tag:foo
backend error: handling register with auth key: creating new node: requested tags [tag:bar tag:foo] are invalid or not permitted

It works with interactive auth (remove the --auth-key argument) or when no tags are advertised by the node (remove the --advertise-tags) argument.

Expected Behavior

Be able to create preauthkeys that are either assigned to a user or have tags. All other headscale preauthkeys subcommands such as list also require to pass a user.

Steps To Reproduce

Try to create a preauthkey with tag but without a user

Environment

- OS: Debian 13
- Headscale version: 0.28.0-beta.1
- Tailscale version: 1.92.3

Runtime environment

  • Headscale is behind a (reverse) proxy
  • Headscale runs in a container

Debug information

none

Originally created by @nblock on GitHub (Dec 20, 2025). ### Is this a support request? - [x] This is not a support request ### Is there an existing issue for this? - [x] I have searched the existing issues ### Current Behavior Creating a preauthkey with tags fails as it currently always requires a user: ```bash $ headscale preauthkeys create --tags tag:foo,tag:bar Error: required flag(s) "user" not set ``` In SaaS, one can create an auth key with tags defined. It seems to be sufficient to have those tags defined in the policy in the `tagOwners` section (note that *no owner* is defined on those tags): ```json5 { "tagOwners": { "tag:bar": [], "tag:foo": [], }, "acls": [ { "action": "accept", "src": ["*"], "dst": ["*:*"], } } ``` In Headscale, if the preauthkey is assigned to a user: ```bash headscale preauthkeys list -u 1 ID | Key/Prefix | Reusable | Ephemeral | Used | Expiration | Created | Tags 1 | hskey-auth-CsLiZAFSkM2z-*** | false | false | false | 2025-12-20 17:01:54 | 2025-12-20 16:01:54 | tag:bar | | | | | | | tag:foo ``` … it can't be used for non-interactive authentication: ```bash $ tailscale up --login-server https://headscale.example.com --auth-key hskey-auth-CsLiZA... --advertise-tags=tag:bar,tag:foo backend error: handling register with auth key: creating new node: requested tags [tag:bar tag:foo] are invalid or not permitted ``` It works with interactive auth (remove the `--auth-key` argument) or when no tags are advertised by the node (remove the `--advertise-tags`) argument. ### Expected Behavior Be able to create preauthkeys that are either assigned to a user or have tags. All other `headscale preauthkeys` subcommands such as list also require to pass a user. ### Steps To Reproduce Try to create a preauthkey with tag but without a user ### Environment ```markdown - OS: Debian 13 - Headscale version: 0.28.0-beta.1 - Tailscale version: 1.92.3 ``` ### Runtime environment - [ ] Headscale is behind a (reverse) proxy - [ ] Headscale runs in a container ### Debug information none
adam added the bugtailscale-feature-gapno-stale-bottags labels 2025-12-29 02:28:44 +01:00
adam commented 2025-12-29 02:28:44 +01:00
Author
Owner
Copy Link

@nblock commented on GitHub (Dec 20, 2025):

Node registration fails when tags are passed during client registration:

$ tailscale up --login-server https://headscale.example.com --auth-key hskey-auth-CsLiZA... --advertise-tags=tag:bar,tag:foo
backend error: handling register with auth key: creating new node: requested tags [tag:bar tag:foo] are invalid or not permitted

But it works when no tags are sent:

tailscale up --login-server https://headscale.example.com --auth-key hskey-auth-CsLiZA...

SaaS seems to ignore tags in that case and registration with both above invocations.

@nblock commented on GitHub (Dec 20, 2025): Node registration fails when tags are passed during client registration: ``` bash $ tailscale up --login-server https://headscale.example.com --auth-key hskey-auth-CsLiZA... --advertise-tags=tag:bar,tag:foo backend error: handling register with auth key: creating new node: requested tags [tag:bar tag:foo] are invalid or not permitted ``` But it works when no tags are sent: ```bash tailscale up --login-server https://headscale.example.com --auth-key hskey-auth-CsLiZA... ``` SaaS seems to ignore tags in that case and registration with both above invocations.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
CLI
DERP
DNS
Nix
OIDC
SSH
bug
database
documentation
duplicate
enhancement
faq
good first issue
grants
help wanted
might-come
needs design doc
needs investigation
no-stale-bot
out of scope
performance
policy 📝
pull-request
Mirrored from GitHub Pull Request
 question
regression
routes
stale
tags
tailscale-feature-gap
well described ❤️
wontfix
No Label bug no-stale-bot tags tailscale-feature-gap
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
adam
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/headscale#1177
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?