Pular para o conteúdo
⚙️ HOW-TO

SAML e SCIM (add-on)

O login corporativo por SAML 2.0 e o cadastro automático por SCIM não fazem parte dos planos do SuperDB. São um add-on opcional, sob consulta, contratado à parte e implantado junto com o TI da sua empresa, e ainda não está ligado em nenhum projeto. Esta página explica quando SAML faz sentido e o que preparar no seu provedor de identidade.

⚠️

A ativação é feita pela equipe, depois da contratação. A configuração não é self-serve: os metadados do seu IdP vão para a equipe, que habilita a conexão no seu projeto. O passo a passo abaixo descreve o que preparar do lado do seu provedor de identidade.

SAML vs OAuth — quando usar cada

OAuth/OIDC (Google, GitHub, Apple) é ideal para aplicações consumer e B2C onde usuários têm contas pessoais em provedores públicos. É mais simples de configurar e funciona em qualquer plano.

SAML 2.0 é o padrão corporativo. Use quando o cliente:

  • Usa um Identity Provider (IdP) corporativo como Okta, Azure AD, OneLogin ou ADFS.
  • Exige que todos os funcionários autentiquem via o diretório da empresa.
  • Precisa de provisionamento automático de usuários (SCIM 2.0).
⚠️

Add-on sob consulta. SAML e SCIM não estão em nenhum plano (Grátis, Site, Pro e Escala) e ainda não está ligado em nenhum projeto. Prazo e preço da implantação se combinam direto com a equipe. Se a sua organização precisa, fale com a gente.

Metadados do SP (Service Provider)

O SuperDB atua como o SP (Service Provider) na relação SAML. Você precisará fornecer estes dados ao seu IdP:

Dados do SP SuperDB
Entity ID (Issuer):
  https://auth.superdb.com.br/saml/sp

ACS URL (Assertion Consumer Service):
  https://auth.superdb.com.br/saml/acs

Metadata XML URL:
  https://auth.superdb.com.br/saml/metadata.xml

Binding:  HTTP-POST
NameID Format:  urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress

Passo a passo com Okta

  1. No painel Okta, acesse Applications → Create App Integration → SAML 2.0.
  2. Nome do app: ex. "SuperDB Prod".
  3. Em SAML Settings:
    • Single sign-on URL: https://auth.superdb.com.br/saml/acs
    • Audience URI (SP Entity ID): https://auth.superdb.com.br/saml/sp
    • Name ID format: EmailAddress
    • Attribute statements: adicione email → user.email e name → user.displayName
  4. Finalize e abra o app criado. Acesse Sign On → View SAML setup instructions.
  5. Copie o Identity Provider Issuer, o Single Sign-On URL e o X.509 Certificate.
  6. Envie ao suporte os dados do IdP (Entity ID, SSO URL e certificado X.509) — a equipe cria a conexão no seu projeto.
  7. Clique em Testar conexão antes de ativar em produção.

Troubleshooting

Certificado expirado

O certificado X.509 do IdP tem validade. Quando expirar, o login SAML retorna signature_invalid. Envie o novo certificado ao suporte antes do vencimento — a troca é feita sem derrubar as sessões ativas.

Atributos não mapeados

Se o email do usuário não chega no atributo correto, verifique os Attribute Statements no Okta. O SuperDB espera o email em email ou NameID.

InResponseTo mismatch

Ocorre quando o IdP responde a um request que já expirou ou foi processado. Garanta que o relógio do servidor esteja sincronizado (máximo 5 minutos de diferença).

Essa página ajudou?