Tailscale user
tailscale.user MQL resource for querying Tailscale infrastructure with cnquery and cnspec.
Tailscale
Tailscale user
Use MQL in cnspec shell or policy:
tailscale.userMin version: 9.0.0Defaults:
id displayName typeRelationships
2 resources · 2 relationships·Click to select, expand fields to see properties.
Fields (11)
| Field | Type | Description |
|---|---|---|
createdAtrequired | time | Time the user joined the tailnet |
deviceCountrequired | int | Number of devices the user owns |
displayNamerequired | string | Name of the user |
idrequired | string | Unique identifier for the user |
lastSeenAtrequired | time | Either: |
loginNamerequired | string | Email-like login name of the user |
profilePicUrlrequired | string | Profile picture URL for the user |
rolerequired | string | Role of the user (owner, member, admin, etc.) |
statusrequired | string | Status of the user |
tailnetIdrequired | string | Tailnet that owns the user |
typerequired | string | Type of relation this user has to the tailnet (member or shared) |
Field Details
lastSeenAttime
a) The last time any of the user's nodes were connected to the network or b) The last time the user authenticated to any Tailscale service, including the admin panel
statusstring
'active' - Last seen within 28 days 'idle' - Last seen more than 28 days ago 'suspended' - Suspended from accessing the tailnet 'needs-approval' - Unable to join tailnet until approved 'over-billing-limit' - Unable to join tailnet until billing count increased