Se você ou os membros da sua equipe estão com dificuldade para entrar no AI Studios usando SAML SSO, o problema geralmente está relacionado a uma configuração incorreta no seu provedor de identidade (IdP). Este guia apresenta as causas mais comuns e como resolvê-las.
Confirme que você está usando SAML SSO
O AI Studios é compatível com SSO baseado em SAML 2.0. Outros protocolos, como OAuth ou OpenID, não são compatíveis.
Para usar SSO, a sua empresa precisa ter:
Um provedor de identidade compatível com SAML (por exemplo, Okta, Microsoft Entra ID / Azure AD)
Um aplicativo SAML configurado corretamente
Se você não tem certeza de que o seu espaço de trabalho usa SSO, entre em contato com a equipe de TI ou com o administrador do espaço de trabalho.
Problemas comuns e como resolvê-los
1. A conta de login do IdP e o e-mail de login do AI Studios não coincidem exatamente (diferencia maiúsculas e minúsculas)
• Ao fazer login pelo MS Entra ID, um valor de Unique User Identifier é enviado ao AI Studios • Esse valor deve coincidir exatamente (inclusive maiúsculas e minúsculas) com o e-mail de login no AI Studios
Como resolver
Caso 1. Altere o valor especificado em Unique User Identifier
Altere o Unique User Identifier para user.displayname
Defina o Display name de cada usuário para que coincida exatamente (inclusive maiúsculas e minúsculas) com o e-mail de login dele no AI Studios
Guia para alterar o Unique User Identifier no Microsoft Entra ID
Guia para alterar o Unique User Identifier no Microsoft Entra ID
Etapa 1: Acesse Attributes & Claims do seu aplicativo AI Studios no Microsoft Entra ID.
Localize a linha do Unique User Identifier e clique em Edit.
Etapa 2: Na página de edição, localize novamente o campo Unique User Identifier.
Clique no menu de três pontos no lado direito dessa linha.
Etapa 3: No menu Manage Claim, procure a caixa de texto Source attribute.
Provavelmente ela está definida como user.userprincipalname por padrão. Altere esse valor para:
user.displayname
Etapa 5: Clique em Save.
Etapa 6: Certifique-se de que cada usuário tenha o e-mail de login do AI Studios definido como display name.
Caso 2. Configure o envio do Unique User Identifier em letras minúsculas !! Pré-requisito !!
Este método só é possível quando o User principal name coincide exatamente com o e-mail de login do AI Studios, com diferença apenas entre maiúsculas e minúsculas
Defina Transformation como ToLowercase(user.userprincipalname)
Guia para gerenciar a transformação no Microsoft Entra ID
Guia para gerenciar a transformação no Microsoft Entra ID
Etapa 1: Acesse Attributes & Claims do seu aplicativo AI Studios no Microsoft Entra ID.
Localize a linha do Unique User Identifier e clique em Edit.
Etapa 2: Na página de edição, localize novamente o campo Unique User Identifier.
Clique no menu de três pontos no lado direito dessa linha.
Etapa 3: Altere a configuração Source para Transformation. Por padrão, ela está definida como Attribute.
Etapa 4: No menu Manage Transformation, defina a Transformation como ToLowercase() .
Etapa 5: Defina Parameter 1 como attribute. Em seguida, selecione user.userprincipalname no menu Attribute Name.
Etapa 6: Salve e confira se essa transformação foi salva corretamente no Unique User Identifier. Ela deve aparecer como ToLowercase (user.userprincipalname)
2. A configuração do seu espaço de trabalho está incompleta
Se o seu link de login por SSO não funcionar, a configuração de SSO do espaço de trabalho pode estar incompleta ou inativa.
Como resolver
O administrador do espaço de trabalho deve:
Clicar na imagem do perfil, selecionar Setting e depois clicar em SAML SSO no menu à esquerda
Confirmar que todos os campos do IdP estão preenchidos
Verificar se a opção de SSO está ativada
Verificar se a ACS URL e o Entity ID foram copiados corretamente para o IdP
3. Dados do IdP ou certificado incorretos
O SSO pode falhar se algum dos itens a seguir estiver incorreto:
URL de login do SSO
Emissor do IdP (IdP Issuer)
Certificado X.509
Validade do certificado
Como resolver
Compare a configuração do seu provedor de identidade com os campos fornecidos no AI Studios:
ACS URL / Callback URL
Audience URI / SP Entity ID
Certificado X.509
Ainda precisa de ajuda?
Se você verificou todos os itens acima e o SSO ainda não funciona:
Tire uma captura de tela da configuração SAML do seu IdP
Anote o endereço de e-mail usado no login
Entre em contato com o seu gerente de conta dedicado e envie esses detalhes
Vamos ajudar você a resolver o problema a partir daí.