> ## Documentation Index > Fetch the complete documentation index at: https://docs.strattum.ai/llms.txt > Use this file to discover all available pages before exploring further. # Configurar o login único (SSO) e os modelos de IA > Guia de configuração: ativar o login único (SSO) da empresa, convidar o administrador da plataforma e cadastrar os modelos de IA no console. Este guia mostra, tela a tela, como ativar o login único (SSO) da sua empresa e cadastrar os modelos de IA no console da Strattum. Com ele, a pessoa responsável pela infraestrutura conclui a configuração sozinha, sem depender de uma chamada com a nossa equipe. ## O que você vai fazer São duas partes, nesta ordem. A Parte 1 começa com o login inicial. A Parte 2 pode ser feita por qualquer administrador, inclusive a pessoa que você convidar na Parte 1. > **Parte 1 · Acesso e login único (SSO)** > > 1.1 Fazer o primeiro login com o administrador inicial\\ > > 1.2 Configurar o SSO e o auto-cadastro\\ > > 1.3 Convidar o administrador da plataforma > **Parte 2 · Modelos de IA** > > 2.1 Cadastrar a chave do provedor de IA\\ > > 2.2 Escolher o modelo de cada função interna\\ > > 2.3 Montar o catálogo do Strattum Chat (opcional)\\ > > 2.4 Salvar a configuração > [!WARNING] > > **Segurança.** A senha inicial, o Client Secret e as chaves de API são digitados por você, direto no console. Esses valores ficam no ambiente da sua empresa e a equipe da Strattum não precisa deles. Não envie nenhum deles por e-mail, chat ou chamado. ## Antes de começar Separe estes itens antes do primeiro login. A última coluna indica o passo em que cada um é usado. | O que você precisa | Onde conseguir | Passo | | - | - | - | | Endereço da sua instância Strattum, por exemplo `empresa.strattum.ai` | Definido na instalação da plataforma no seu ambiente | 1.1 | | Senha inicial do administrador: o valor da variável `ZITADEL_ADMIN_INICIAL_PASSWORD` | Configuração da instalação no seu ambiente | 1.1 | | Aplicativo de SSO (OAuth/OIDC) criado no seu provedor de identidade, com Client ID e Client Secret | Console de administração do provedor de identidade | 1.2 | | Permissão para editar as URLs de redirecionamento desse aplicativo | Administrador do provedor de identidade | 1.2 | | Nome e e-mail corporativo de quem vai administrar a plataforma | Sua equipe | 1.3 | | Chave de API de pelo menos um provedor de IA, como OpenAI ou Anthropic | Console do provedor de IA, na conta da sua empresa | 2.1 | ## Onde ficam as telas Todas as telas deste guia ficam em **Configurações**, no endereço `/settings` da sua instância. No menu lateral das Configurações, você vai usar três itens: * ① **Login único (SSO)**, na seção Instalação. Usado no passo 1.2. * ② **Usuários**, na seção Workspace. Usado nos passos 1.2 e 1.3. * ③ **Modelos de IA**, na seção Instalação. Usado em toda a Parte 2. ![Menu lateral das Configurações com os itens Usuários, Modelos de IA e Login único (SSO) destacados](https://mintcdn.com/strattumai/09Jh5eSHsK_uEBGp/images/guides/sso-models/01-menu-configuracoes.png?fit=max\&auto=format\&n=09Jh5eSHsK_uEBGp\&q=85\&s=ae3cb4a52d3f22941b2aaa440260a524) Figura 1. Menu de Configurações com os itens usados neste guia. *** ## Parte 1 · Acesso e login único (SSO) Você entra com o administrador inicial, conecta o provedor de identidade da sua empresa e convida quem vai administrar a plataforma. ### 1.1 Faça o primeiro login com o administrador inicial **Onde:** Tela de login da sua instância Use este acesso só no primeiro login. Ele existe para você configurar o SSO e convidar o administrador da sua empresa. | Campo | O que digitar | | - | - | | Login | `zitadel-admin@strattum.auth.` | | Senha | O valor da variável `ZITADEL_ADMIN_INICIAL_PASSWORD` | **Exemplo:** se você acessa a plataforma em `empresa.strattum.ai`, o login é `zitadel-admin@strattum.auth.empresa.strattum.ai`. > [!NOTE] > > Se a tela pedir uma nova senha nesse primeiro acesso, crie uma senha forte e guarde no cofre de senhas da sua empresa. ### 1.2 Configure o login único (SSO) **Onde:** Configurações › Instalação › Login único (SSO) Tenha em mãos o aplicativo de SSO criado no seu provedor de identidade. 1. Selecione o provedor de identidade da sua empresa. 2. Preencha o ID do cliente (**Client ID**) e o segredo (**Client Secret**) do aplicativo criado no provedor. 3. Copie a **URL de callback** mostrada na tela e cadastre essa URL no aplicativo do provedor, no campo de URLs de redirecionamento (redirect URIs). 4. Valide a configuração na própria tela. > [!WARNING] > > A URL de callback precisa ser idêntica no console e no provedor. Um caractere diferente, como uma barra a mais no fim, faz o login pelo SSO falhar. #### Auto-cadastro via SSO (opcional) Com o SSO validado, abra **Configurações › Workspace › Usuários** e decida a posição da chave **Permitir auto-cadastro via SSO** ①. | Chave | O que acontece | | - | - | | Desligada | Só entram as pessoas cujo e-mail um administrador cadastrou na plataforma. | | Ligada | O primeiro login de uma pessoa pelo SSO cria a conta dela, com a função **consumer** e sem time. Um administrador ajusta a função e o time depois. | Se você prefere liberar cada acesso por convite, deixe a chave desligada. ![Página Meus Usuários com a chave Permitir auto-cadastro via SSO e o botão Convidar Usuário destacados](https://mintcdn.com/strattumai/09Jh5eSHsK_uEBGp/images/guides/sso-models/02-usuarios.png?fit=max\&auto=format\&n=09Jh5eSHsK_uEBGp\&q=85\&s=c68c47f37f001b85667bd8b8e56169cf) Figura 2. Página Usuários: chave Permitir auto-cadastro via SSO ① e botão Convidar Usuário ②. ### 1.3 Convide o administrador da plataforma **Onde:** Configurações › Workspace › Usuários 1. Clique em **Convidar Usuário** ②, no canto superior direito da página (Figura 2). 2. Na janela **Adicionar Usuário**, preencha os campos (Figura 3): | Campo | Preenchimento | O que informar | | - | - | - | | Nome | Obrigatório | Nome completo da pessoa. | | E-mail | Obrigatório | E-mail corporativo, o mesmo que ela usa no provedor de SSO. | | Função | Obrigatório | **Administrador** ① | 3. Clique em **Adicionar** ②. ![Janela Adicionar Usuário com os campos Nome, E-mail e Função, e o botão Adicionar](https://mintcdn.com/strattumai/09Jh5eSHsK_uEBGp/images/guides/sso-models/03-adicionar-usuario.png?fit=max\&auto=format\&n=09Jh5eSHsK_uEBGp\&q=85\&s=6ad2009c6a037020ac437d5a10e68cd2) Figura 3. Janela Adicionar Usuário: campo Função com Administrador selecionado ① e botão Adicionar ②. > [!TIP] > > **Parte 1 concluída.** O SSO está ativo e o administrador da sua empresa já tem a função atribuída. A partir de agora, essa pessoa entra pelo SSO, e o login inicial do passo 1.1 deixa de ser usado no dia a dia. *** ## Parte 2 · Modelos de IA A plataforma usa os modelos de IA do provedor que a sua empresa escolher. As chaves são da sua empresa, e o consumo é faturado direto na sua conta com o provedor. **Onde:** Configurações › Instalação › Modelos de IA ### 2.1 Cadastre a chave do provedor de IA 1. Em **Provedores**, localize o provedor da sua chave. Se ele não estiver na lista, clique em **Adicionar outro provedor** ① e escolha o provedor. 2. Cole a chave no campo **API Key** ②. 3. Clique em **Testar credencial** ③. Para usar mais de um provedor, repita os passos para cada um. Você pode combinar provedores, por exemplo Anthropic para o chat e OpenAI para os embeddings. ![Bloco Provedores com o provedor OpenAI, o campo API Key, o botão Testar credencial e o botão Adicionar outro provedor](https://mintcdn.com/strattumai/09Jh5eSHsK_uEBGp/images/guides/sso-models/04-provedores.png?fit=max\&auto=format\&n=09Jh5eSHsK_uEBGp\&q=85\&s=ee01c92fca92fa78de76038f7af6cfaf) Figura 4. Bloco Provedores: Adicionar outro provedor ①, campo API Key ② e Testar credencial ③. > [!NOTE] > > Depois de salva, a chave não aparece mais na tela: o campo mostra **Chave salva**. Para trocar, digite a nova chave no mesmo campo. Até lá, a chave salva continua valendo. ### 2.2 Escolha o modelo de cada função interna Em **Modelos da plataforma**, o console lista sete funções internas. Cada uma traz uma descrição e a linha **Usado por**, com os serviços que dependem dela. 1. Escolha o modelo no seletor da função ①. O prefixo do nome indica o provedor e a chave usados: `openai/gpt-4o-mini` usa a chave da OpenAI. 2. Clique em **Validar com uma chamada mínima** ②. Na função de embeddings, o botão se chama **Validar embedding**. 3. Repita nas sete funções. ![Bloco Modelos da plataforma com as funções Generativo e Extração de entidades, o seletor de modelo e o botão Validar com uma chamada mínima](https://mintcdn.com/strattumai/09Jh5eSHsK_uEBGp/images/guides/sso-models/05-modelos-plataforma.png?fit=max\&auto=format\&n=09Jh5eSHsK_uEBGp\&q=85\&s=281e480e791cdd26edc65e95b90fe40f) Figura 5. Modelos da plataforma: seletor de modelo ① e validação ②. #### Funções que pedem atenção | Função | Tipo | O que considerar | | - | - | - | | Generativo | Chat | É o modelo principal: sugere e corrige transformações (inclusive SQL que falhou), enriquece dados nos pipelines, planeja o contexto do Memory e responde no chat de Skills. Use o modelo mais capaz que você tiver. | | Agente de clean | Chat | Conduz o Assistente IA do editor de clean, que lê o catálogo, consulta as tabelas e propõe o SQL da transformação. Precisa usar ferramentas e escrever SQL, então escolha um modelo capaz. Além da validação, essa função tem o botão **Testar com o agente**. | | Extração de entidades (NER) | Chat | Reservada. Nenhum serviço usa esta função hoje, então o modelo escolhido não tem efeito. | | Embeddings · Knowledge (RAG) | Embedding | Transforma documentos e perguntas em vetores para a busca do Knowledge. Trocar este modelo depois exige reindexar todo o conteúdo do Knowledge. | > [!WARNING] > > Escolha o modelo de embedding antes de indexar documentos no Knowledge. Cada troca posterior exige reindexar todo o conteúdo. ![Função Embeddings Knowledge RAG com o seletor de modelo, o botão Validar embedding e a opção do Memory Graph](https://mintcdn.com/strattumai/09Jh5eSHsK_uEBGp/images/guides/sso-models/06-embeddings.png?fit=max\&auto=format\&n=09Jh5eSHsK_uEBGp\&q=85\&s=b5c50c73a72c1530e26d8ff50c797068) Figura 6. Função de embeddings: seletor ①, Validar embedding ② e, logo abaixo, a opção do Memory Graph. Na maioria dos casos, deixe desmarcada a opção **Usar um modelo de embedding diferente para o Memory Graph**. Por padrão, o Memory usa o mesmo modelo do Knowledge. Separar os dois é raro, e cada troca exige reindexar as entidades. ### 2.3 Monte o catálogo do Strattum Chat (opcional) O catálogo define os modelos que os usuários podem escolher no seletor do Strattum Chat. Ele é independente dos modelos da plataforma e pode misturar provedores. 1. Em **Adicionar modelos ao catálogo**, busque o modelo e adicione ①. 2. Preencha o **Nome de exibição** ②, que é como o modelo aparece no seletor (obrigatório, até 40 caracteres). A **Descrição** é opcional (até 100 caracteres) e aparece numa linha abaixo do nome. 3. Clique em **Testar o catálogo** ③. O console envia uma chamada mínima para cada modelo e confere nomes e funções. 4. Em **Modelo padrão** ④, escolha o modelo que já vem selecionado em toda conversa nova. O usuário pode trocar no seletor quando quiser. 5. Em **Modelo que gera títulos** ⑤, escolha o modelo que escreve o título de cada conversa no histórico. Um modelo rápido e barato basta. ![Bloco Modelos do Strattum Chat com a busca de modelos, o nome de exibição, o botão Testar o catálogo, o modelo padrão e o modelo que gera títulos](https://mintcdn.com/strattumai/09Jh5eSHsK_uEBGp/images/guides/sso-models/07-strattum-chat.png?fit=max\&auto=format\&n=09Jh5eSHsK_uEBGp\&q=85\&s=97e60aaa208285144cb5a504cd21602a) Figura 7. Modelos do Strattum Chat: busca ①, nome de exibição ②, teste do catálogo ③, modelo padrão ④ e modelo que gera títulos ⑤. ### 2.4 Salve a configuração 1. Clique em **Salvar configuração** ①, no canto superior direito da página. ![Cabeçalho da página Modelos de IA com o selo Configurado e os botões Salvar configuração e Remover configuração](https://mintcdn.com/strattumai/09Jh5eSHsK_uEBGp/images/guides/sso-models/08-salvar.png?fit=max\&auto=format\&n=09Jh5eSHsK_uEBGp\&q=85\&s=7e10d1d941472a6d5f09b39868eb468b) Figura 8. Cabeçalho da página Modelos de IA: Salvar configuração ① e, em vermelho, Remover configuração. > [!WARNING] > > Cuidado com o botão vermelho **Remover configuração**, ao lado de Salvar: ele remove a configuração desta página. *** ## Como confirmar que deu certo * A pessoa convidada entra no console pelo SSO, com o e-mail corporativo dela. * Em **Usuários**, ela aparece com a função **Administrador**. * **Testar credencial**, a validação de cada função e **Testar o catálogo** terminam sem erro. * A página **Modelos de IA** mostra o selo **Configurado** ao lado do título (Figura 8). * No menu de Configurações, **Modelos de IA** e **Login único (SSO)** aparecem com o ponto verde (Figura 1). ## Se algo não funcionar | Sintoma | O que conferir | | - | - | | O login inicial não é aceito | O domínio depois de `strattum.auth.` precisa ser o mesmo endereço da sua instância. Confira também se a senha é o valor atual da variável `ZITADEL_ADMIN_INICIAL_PASSWORD`. | | O login pelo SSO volta com erro do provedor | A URL de callback cadastrada no provedor precisa ser idêntica à mostrada no console. Confira também o Client ID e o Client Secret. | | A pessoa convidada não consegue entrar | O e-mail do convite precisa ser o mesmo que ela usa no provedor de SSO. | | Testar credencial falha | Confira se a chave foi colada inteira e se a conta da sua empresa no provedor de IA tem faturamento ativo. | | A busca do Knowledge não acha documentos depois de trocar o modelo de embedding | Reindexe o conteúdo do Knowledge. A troca de modelo de embedding exige reindexação antes de a busca voltar a funcionar. | > [!NOTE] > > Se o problema continuar, fale com o FDE da Strattum que acompanha a sua implantação e envie um print da tela com o erro. Antes de enviar, confira que nenhuma senha ou chave aparece no print. ## Próximo passo Com o acesso e os modelos configurados, conecte as fontes de dados da sua empresa em [Conectores](https://docs.strattum.ai/getting-started/connect-and-catalog.md), no menu principal do console. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.