Autenticação

O Argos tem dois mecanismos de autenticação dependendo do cliente:

Canal	Método	Quando usar
Painel (humano)	Bearer token opaco via `POST /api/v1/auth/login`	Integrações diretas à API REST
MCP (agente de IA)	OAuth 2.0 Authorization Code + PKCE (RFC 7636)	Cursor, Claude Code, agentes remotos

Bearer Token (API REST)

1. Obter o token

O endpoint aceita application/x-www-form-urlencoded com os campos username e password (padrão OAuth2 Password Form). JSON body retorna 422.

curl -X POST https://argos.automatizase.com.br/api/v1/auth/login \
  -d 'username=voce@empresa.com&password=SUA_SENHA'

Resposta:

{
  "access_token": "tok_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "token_type": "bearer"
}

2. Usar o token

Passe o token em todas as requisições:

# Listar câmeras
curl https://argos.automatizase.com.br/api/v1/cameras \
  -H "Authorization: Bearer tok_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

// JavaScript / TypeScript
const resp = await fetch('https://argos.automatizase.com.br/api/v1/cameras', {
  headers: { Authorization: `Bearer ${token}` },
});
const cameras = await resp.json();

# Python
import httpx

client = httpx.Client(
    base_url='https://argos.automatizase.com.br',
    headers={'Authorization': f'Bearer {token}'},
)
cameras = client.get('/api/v1/cameras').json()

3. Capacidades por papel

O token carrega o papel do usuário. Todas as operações são escopadas automaticamente:

Administrador da conta: gerencia a organização inteira — câmeras, usuários, gravadores, canais de notificação, calibração e configurações.
Usuário: visualiza apenas câmeras e alertas da própria organização (somente leitura).

4. Logout

curl https://argos.automatizase.com.br/api/v1/auth/logout \
  -H "Authorization: Bearer $TOKEN"

OAuth 2.0 + PKCE (MCP para agentes de IA)

Para agentes de IA (Claude Code, Cursor, n8n) autenticarem via MCP, use o fluxo OAuth 2.0 Authorization Code com PKCE.

Discovery automático

A maioria dos clientes OAuth descobre o servidor automaticamente:

GET https://argos.automatizase.com.br/.well-known/oauth-authorization-server

Fluxo manual (step-by-step)

1. Registrar cliente (DCR)

curl -X POST https://argos.automatizase.com.br/oauth/register \
  -H "Content-Type: application/json" \
  -d '{
    "client_name": "Meu Agente",
    "redirect_uris": ["http://localhost:8080/callback"]
  }'

Resposta: { "client_id": "...", "client_secret": "..." }

2. Gerar PKCE

import secrets, hashlib, base64

code_verifier = secrets.token_urlsafe(64)
code_challenge = base64.urlsafe_b64encode(
    hashlib.sha256(code_verifier.encode()).digest()
).rstrip(b'=').decode()

3. Redirecionar para autorização

GET https://argos.automatizase.com.br/oauth/authorize
  ?response_type=code
  &client_id=CLIENT_ID
  &redirect_uri=http://localhost:8080/callback
  &code_challenge=CODE_CHALLENGE
  &code_challenge_method=S256
  &scope=openid

4. Trocar código por JWT

curl -X POST https://argos.automatizase.com.br/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code&code=CODE&redirect_uri=...&code_verifier=CODE_VERIFIER&client_id=CLIENT_ID"

5. Chamar o MCP

curl https://argos.automatizase.com.br/mcp \
  -H "Authorization: Bearer JWT_TOKEN"

Próximos passos

Quickstart — ver exemplos completos de chamada à API.
Usando com agentes de IA — conectar Claude Code e Cursor via MCP.

Autenticação

On this page