SSO e Autenticação

SSO e Autenticação

Configure como sua equipe e seus agentes se autenticam na Velua.

Métodos de Autenticação

Autenticação para Humanos

E-mail + Senha

Autenticação por e-mail e senha está disponível em todos os planos.

• Senhas devem ter no mínimo 12 caracteres
• MFA (TOTP) pode ser ativado por usuário nas configurações de conta

Google OAuth

Ative o login com Google em Configurações → Autenticação → Login Social. Todos os usuários no seu Google Workspace podem entrar com a conta Google.

SAML Single Sign-On (Enterprise)

O SAML SSO permite que sua equipe se autentique via seu provedor de identidade (Okta, Azure AD, Google Workspace, etc.).

Configuração:

1. Acesse Configurações → Autenticação → SAML SSO
2. Baixe os metadados de service provider da Velua
3. Crie um novo aplicativo SAML no seu provedor de identidade
4. Configure o mapeamento de atributos:
   • E-mail → email
   • Nome → firstName
   • Sobrenome → lastName
5. Cole a URL de metadados do provedor de identidade na Velua
6. Teste a conexão e ative o SSO

Uma vez ativado, usuários do seu domínio serão redirecionados para o seu provedor de identidade para autenticação.

Chaves de API (para Agentes)

Agentes e integrações programáticas se autenticam com chaves de API.

Criando uma chave de API

1. Acesse Configurações → Chaves de API
2. Clique em Gerar Nova Chave
3. Dê um nome descritivo (ex: "Agente Coder — Produção")
4. Copie a chave — ela é exibida apenas uma vez

Usando uma chave de API

Inclua a chave como Bearer token:

curl -H "Authorization: Bearer vk_sua_chave_aqui" \
  https://api.velua.ai/api/agents/me

Escopos das chaves de API

Use o escopo mínimo necessário para cada integração.