Este guia orienta os administradores enterprise a ativar o Single Sign-On (SSO) via SAML para uma autenticação de usuários segura e centralizada no AI Studios.
Etapa 1: Configure o SSO no painel do AI Studios
Entre na sua conta do AI Studios.
Clique na sua imagem de perfil (canto superior direito).
No menu suspenso, clique em Setting.
No menu à esquerda, selecione SAML SSO.
Etapa 2: Configure seu provedor de identidade (IdP)
Antes de conectar o AI Studios ao seu IdP, crie um SAML 2.0 Application no portal do seu IdP. O AI Studios funciona com o Okta e o Microsoft Entra ID (antigo Azure AD).
Como configurar o SAML no Okta
Como configurar o SAML no Okta
Etapa 1: Crie uma nova integração de aplicativo
Acesse o Okta Admin Console e clique em Admin no canto superior direito.
Vá para Applications > Applications.
Clique em Create App Integration.
Selecione SAML 2.0 e clique em Next.
Etapa 2: Configure a integração SAML
Dê ao aplicativo o nome AI Studios e clique em Next.
Em SAML Settings, insira os valores fornecidos quando você configurou o SSO no AI Studios.
Single sign-on URL
Audience URL (SP Entity ID)
Defina Name ID format como email.
Defina Name ID para usar o atributo de e-mail do usuário.
Etapa 3: Conclua a configuração do aplicativo
Selecione I’m an Okta customer adding an internal app.
Selecione This is an internal app that we have created.
Clique em Finish para concluir a configuração.
Etapa 4: Integre o aplicativo ao AI Studios
Acesse a aba Sign On do aplicativo.
Role para baixo e clique em View SAML setup instructions.
Copie os três parâmetros a seguir e cole-os na plataforma do AI Studios:
Identity Provider Single Sign-On URL
Identity Provider Issuer (Entity ID)
X.509 Certificate
Etapa 5: Atribua outros usuários ao aplicativo
Abra a aba People em Directory.
Clique no botão 'Add Person'
Preencha as informações, garantindo que o nome de usuário corresponda ao endereço de e-mail que a pessoa usa para entrar no AI Studios
Como configurar o SAML no Microsoft Entra ID (antigo Azure AD)
Como configurar o SAML no Microsoft Entra ID (antigo Azure AD)
Etapa 1: Crie um novo aplicativo
No Microsoft Entra admin center, acesse Microsoft Entra ID
Clique em Enterprise Applications
Selecione All Applications e clique em + New Application
Escolha Create your own application
Digite AI Studios como nome do aplicativo e clique em Create
Etapa 2: Configure o Single Sign-On (SAML)
Depois de criar o aplicativo, vá para Set up single sign-on
Na seção Basic SAML Configuration, insira o seguinte:
Identifier (Entity ID)
Reply URL (Assertion Consumer Service URL)
Clique em Save
Etapa 3: Atribua atributos e declarações
Clique em Edit na seção Attributes and Claims
Encontre a declaração chamada Unique User Identifier (Name ID)
Altere o Source attribute para
user.displayname, para que o NameID enviado ao AI Studios corresponda ao formato do endereço de e-mail do usuário
Etapa 4: Copie os parâmetros de configuração do SAML
Na seção Single sign-on, role até as seções SAML Certificates e Set up AI Studios
Copie os seguintes valores:
Identity Provider Single Sign-On URL (Login URL)
Identity Provider Issuer (Microsoft Entra Identifier)
X.509 Certificate (baixe o Certificate (Base64))
Abra as configurações de SSO na plataforma do AI Studios
Cole os três valores nos campos correspondentes
Clique em Salvar para concluir a integração
Etapa 5: Atribua usuários e grupos
Acesse Users and groups nas configurações do aplicativo
Clique em + Add user/group
Ao adicionar um novo usuário, defina o Display Name igual ao endereço de e-mail do AI Studios do usuário
Configurações SAML a usar
Configuração | Valor |
Single Sign-On URL (ACS / Callback URL) | |
Audience URL (SP Entity ID) |
Declarações obrigatórias (sem namespace!)
Inclua as seguintes declarações (claims) na configuração SAML do seu IdP. Todos os valores devem estar em letras minúsculas e não podem incluir namespace.
Nome da declaração | Descrição | Observações |
| Endereço de e-mail do usuário | Deve estar em minúsculas e se chamar exatamente |
⚠️ Declarações como emailaddress ou email_address não serão aceitas. O nome deve ser exatamente email.
Etapa 3: Compartilhe os metadados com o AI STUDIOS
Será solicitado que você informe o seguinte:
Campo | Descrição |
Idp Single Sign-On URL (Login URL) | O endpoint de login do seu IdP |
Idp Issuer (Identifier) | Identificador exclusivo do seu IdP |
Certificate | Seu certificado de assinatura SAML |
Como obter esses valores de parâmetro no Okta
Como obter esses valores de parâmetro no Okta
Acesse Application > Applications e selecione o aplicativo AI Studios.
Acesse a aba Sign On no menu do aplicativo.
Role para baixo e clique em View SAML setup instructions.
Copie os três parâmetros a seguir e cole-os na plataforma do AI Studios:
Identity Provider Single Sign-On URL
Identity Provider Issuer (Entity ID)
X.509 Certificate
Como obter esses valores de parâmetro no Microsoft Entra ID/Azure AD
Como obter esses valores de parâmetro no Microsoft Entra ID/Azure AD
Acesse Enterprise applications > Enterprise Applications | All applications > AI Studios
Na seção Single sign-on, role até as seções SAML Certificates e Set up AI Studios
Copie os seguintes valores:
Identity Provider Single Sign-On URL (Login URL)
Identity Provider Issuer (Microsoft Entra Identifier)
X.509 Certificate (baixe o Certificate (Base64))
Abra as configurações de SSO na plataforma do AI Studios e cole esses valores nos campos correspondentes.
Depois do envio, um link exclusivo de configuração de SSO será gerado e vinculado à sua conta.
Etapa 4: Ative ou desative o SSO
Você verá um botão de alternância para ativar ou desativar o SSO.
Ativado (padrão):
Permite o login via SSO tanto para administradores quanto para membros da equipe
Desativado:
Apenas administradores podem entrar com SSO
Os membros da equipe não podem acessar o workspace