O Mintlify oferece tanto Autenticação quanto Personalização. Na maior parte, a Autenticação é apenas Personalização + privacidade. No entanto, existem algumas diferenças importantes que são importantes de se ter em mente, da mais importante para a menos importante:

​
Garantias de Segurança

A Autenticação é uma solução de documentação privada completa. Todos os aspectos dos seus documentos, incluindo conteúdo da página, imagens, resultados de pesquisa e recursos de assistente de IA, são completamente inacessíveis para usuários não autenticados.

A Personalização, por outro lado, não oferece garantias de segurança para o conteúdo da sua documentação. Todo o conteúdo da página, imagens, resultados de pesquisa e recursos de assistente de IA podem ser acessados pelo público. Mesmo se você estiver usando o recurso de páginas ocultas da Personalização, um atacante motivado ainda seria capaz de acessar o conteúdo de uma página oculta.

​
Métodos de Handshake

Devido à diferença nos requisitos de segurança para Autenticação e Personalização, diferentes métodos de handshake estão disponíveis para cada. Ambos os métodos oferecem um Handshake JWT e OAuth, embora os passos de configuração sejam ligeiramente diferentes.

A Autenticação oferece dois métodos de Handshake adicionais:

  • Handshake de Senha, que protege seu site com uma única senha global configurável.

  • Mintlify Auth Handshake, que permitirá que os usuários visualizem sua documentação apenas se eles tiverem acesso ao seu painel.

A Personalização oferece um método de Handshake adicional:

  • Handshake de Sessão Compartilhada, um método super simples que requer apenas a configuração de um único endpoint que retorna dados para usuários já autenticados.