Acesso, SSO e API

Métodos de autenticação do laboratório, SSO corporativo e gestão de chaves de API.

As configurações de autenticação ficam em Configurações → Autenticação (/dashboard/settings/authentication).

Métodos de Autenticação

O CalibraFácil mantém áreas de autenticação separadas para:

dashboard do laboratório;
portal do cliente.

No dashboard do laboratório, cada usuário pode acompanhar:

status da senha;
verificação de email;
configuração de autenticação corporativa da organização;
chaves da API pública.

SSO Corporativo

O SSO corporativo centraliza o login do dashboard do laboratório no provedor de identidade da organização. É indicado para times que precisam unificar identidade, MFA e revogação de acesso.

O que o SSO cobre

login no dashboard do laboratório;
autenticação via provedor OIDC;
verificação de domínio antes da ativação;
configuração de issuer, endpoints, escopos e estratégia de autenticação no token endpoint.

Fluxo recomendado

Cadastrar o provedor OIDC.
Publicar o registro TXT de verificação do domínio.
Confirmar a verificação do domínio.
Testar o login SSO com usuário corporativo.
Só então adotar o fluxo como padrão operacional.

O SSO não substitui o portal do cliente. Ele é voltado ao acesso corporativo do dashboard do laboratório.

As chaves de API ficam disponíveis a partir do painel de Configurações para Administradores e Proprietários. Cada chave possui escopos restritos e pode ser rotacionada ou revogada a qualquer momento.

Escopos disponíveis

customers:read, customers:write
assets:read, assets:write
requests:read, requests:write
jobs:read, jobs:write
services:read
units:read
reports:read
certificates:read
webhooks:manage

Boas práticas

criar uma chave por integração ou contexto operacional;
restringir os escopos ao mínimo necessário;
rotacionar chaves periodicamente;
guardar o segredo apenas no sistema cliente — ele é exibido integralmente uma única vez;
revogar imediatamente chaves obsoletas ou suspeitas.

Referência da API Pública

O contrato OpenAPI e a referência interativa ficam disponíveis para Administradores e Proprietários na área autenticada do produto. A API pública usa autenticação por chave e modelo resource-first, cobrindo clientes, ativos, solicitações, ordens, serviços, unidades, relatórios, certificados e webhooks.