Tailscale

Visão geral

Tailscale é uma mesh VPN zero-config baseada em WireGuard que facilita conectar dispositivos, serviços e usuários em qualquer rede. O bloco Tailscale permite automatizar tarefas de gerenciamento de rede como provisionamento de dispositivos, controle de acesso, gerenciamento de rotas e configuração de DNS diretamente a partir dos seus fluxos de trabalho no Zoen.

Autenticação

O bloco Tailscale usa autenticação por API key. Para obter uma API key:

1. Acesse o console de admin do Tailscale
2. Vá em Settings > Keys
3. Clique em Generate API key
4. Defina uma validade (1–90 dias) e copie a chave (começa com tskey-api-)

É necessário ter o papel de Owner, Admin, IT admin ou Network admin para gerar API keys.

Identificador do Tailnet

Toda operação exige um parâmetro tailnet. Em geral, é o domínio da sua organização (ex.: example.com). Você também pode usar "-" para se referir ao seu tailnet padrão.

Casos de uso comuns

• Inventário de dispositivos: Listar e monitorar todos os dispositivos conectados à sua rede
• Provisionamento automatizado: Criar e gerenciar auth keys para pré-autorizar novos dispositivos
• Controle de acesso: Autorizar ou desautorizar dispositivos e gerenciar tags de dispositivo para políticas ACL
• Gerenciamento de rotas: Ver e habilitar rotas de subnet para dispositivos que atuam como subnet routers
• Gerenciamento de DNS: Configurar nameservers, MagicDNS e search paths
• Ciclo de vida de chaves: Criar, listar, inspecionar e revogar auth keys
• Auditoria de usuários: Listar todos os usuários no tailnet e seus papéis
• Revisão de política: Recuperar a política ACL atual para inspeção ou backup

Usage Instructions

Interact with the Tailscale API to manage devices, DNS, ACLs, auth keys, users, and routes across your tailnet.

Actions

tailscale_list_devices

List all devices in the tailnet

Input

Output

tailscale_get_device

Get details of a specific device by ID

Input

Output

tailscale_delete_device

Remove a device from the tailnet

Input

Output

tailscale_authorize_device

Authorize or deauthorize a device on the tailnet

Input

Output

tailscale_set_device_tags

Set tags on a device in the tailnet

Input

Output

tailscale_get_device_routes

Get the subnet routes for a device

Input

Output

tailscale_set_device_routes

Set the enabled subnet routes for a device

Input

Output

tailscale_update_device_key

Enable or disable key expiry on a device

Input

Output

tailscale_expire_device_key

Immediately expire a device's node key, requiring it to re-authenticate before it can reconnect to the tailnet

Input

Output

tailscale_list_dns_nameservers

Get the DNS nameservers configured for the tailnet

Input

Output

tailscale_set_dns_nameservers

Set the DNS nameservers for the tailnet

Input

Output

tailscale_get_dns_preferences

Get the DNS preferences for the tailnet including MagicDNS status

Input

Output

tailscale_set_dns_preferences

Set DNS preferences for the tailnet (enable/disable MagicDNS)

Input

Output

tailscale_get_dns_searchpaths

Get the DNS search paths configured for the tailnet

Input

Output

tailscale_set_dns_searchpaths

Set the DNS search paths for the tailnet

Input

Output

tailscale_list_users

List all users in the tailnet

Input

Output

tailscale_suspend_user

Suspend a user's access to the tailnet

Input

Output

tailscale_delete_user

Delete a user from the tailnet

Input

Output

tailscale_create_auth_key

Create a new auth key for the tailnet to pre-authorize devices

Input

Output

tailscale_list_auth_keys

List all auth keys in the tailnet

Input

Output

tailscale_get_auth_key

Get details of a specific auth key

Input

Output

tailscale_delete_auth_key

Revoke and delete an auth key

Input

Output

tailscale_get_acl

Get the current ACL policy for the tailnet

Input

Output

tailscale_set_acl

Replace the ACL policy file for the tailnet

Input

Output