Este guia aborda como configurar o Single Sign-On (SSO) entre o Microsoft Entra ID (antigo Azure AD) e a Udemy Business usando SAML 2.0 ou OIDC.
Observação:
- Se você já tem uma instância do Entra configurada com a Udemy, consulte a seção Configurar instâncias adicionais de Entra ID para Udemy Business neste artigo.
- Se você estiver usando um aplicativo da galeria, ele não é compatível com SCIM. Caso planeje usar SCIM, crie um aplicativo fora da galeria.
- O Single Sign-On e o provisionamento estão disponíveis para clientes com Plano Enterprise da Udemy Business apenas.
- Não ative o Login apenas via provedor de SSO até que a conexão seja testada com sucesso. Se o SSO não estiver configurado corretamente, todos os usuários perderão o acesso à Udemy Business.
Observação: em 25 de março de 2026, lançamos uma nova maneira simplificada de configurar SSO. Essa nova experiência se tornou a experiência padrão de configuração para todas as novas configurações após essa data, e atualmente estamos trabalhando para transitar todas as conexões existentes da experiência legada. Você pode ler sobre a experiência legada aqui.Entre em contato com a equipe de suporte da Udemy Business se você tiver alguma dúvida.
Índice
- Antes de começar
- Configurar o Single Sign-On (SSO) com Entra ID
- Opção B: configurar usando OIDC
- Testar sua conexão SSO
- Configurar instâncias adicionais de Entra ID para Udemy Business
Antes de começar
- Você deve ter acesso de administrador tanto à sua conta da Udemy Business quanto ao seu locatário do Microsoft Entra ID.
- Decida qual protocolo usar: SAML ou OIDC. Se você não tiver certeza, verifique com sua equipe de TI. Ambos contam com suporte total.
Configurar o Single Sign-On (SSO) com Entra ID
Opção A: configurar usando SAML
Etapa 1: configure a Udemy Business como um aplicativo empresarial no Entra ID
- Faça login no portal do Entra e clique em Microsoft Entra ID.
- Selecione Enterprise applications (Aplicativos empresariais).
- Clique em + New application (+ Novo aplicativo) na barra superior.
- Selecione Create your own application (Criar seu aplicativo).
- Insira um nome para o novo aplicativo e clique em Integrate any other application you don't find in the gallery (Non-gallery) [Integrar outros aplicativos não encontrados na galeria (fora da galeria)] no fim da janela.
- Selecione Set up single sign on (Configurar single sign on).
- No modo Single Sign-on, selecione o login com base em SAML.
Você deve ver a tela de configuração abaixo.
Etapa 2: navegue até as configurações de SSO na Udemy Business
- Faça login na sua conta da Udemy Business como administrador.
- Acesse Gerenciar > Configurações > Single Sign-On (SSO).
- Clique em Iniciar configuração e escolha Azure como provedor de identidade.
- Nomeie sua Conexão SSO. O nome que você escolher será exibido como a opção de login SSO na página de login.
- Em Tipo de conexão selecione SAML e copie o ID da entidade do SP.
Etapa 3: configuração básica do SAML no Entra ID
- Volte para o seu portal de configuração do Entra ID e na seção Basic SAML Configuration (Configuração Básica do SAML), clique em Editar e insira o seguinte:
- Identificador (ID da Entidade): obtido na página de configuração do SSO da Udemy no seu portal do administrador da Udemy.
- URL de resposta (URL de asserção do serviço de consumidor): https://sso.udemy.com/api/oauth/saml
- URL de logon: https://{{domain}}.udemy.com/
Etapa 4: atributos e declarações de usuário
Observação: a Udemy ignora a seção de identificador único de usuário nas reivindicações obrigatórias.
- Volte até a guia Single Sign-on na barra lateral e clique em Edit (Editar) na seção Attributes & Claims (Atributos e declarações).
- Na seção Additional Claims (Declarações adicionais), clique no valor user.mail.
- Atualize emailaddress para "email" (use apenas letras minúsculas)
- Exclua o Namespace URI.
- Para atributo de origem, certifique-se de selecionar o valor de e-mail que você deseja transferir do Entra ID para a Udemy (geralmente user.mail ou user.userprincipalname.) Esse será o identificador principal da conta do usuário e deve corresponder ao valor de e-mail na Udemy.
- Adicione nova declaração ou edite uma declaração existente e repita o processo.
- Clique em Save (Salvar).
- Para adicionar mais atributos opcionais, clique em Add new claim (Adicionar nova declaração) e repita o processo. A Udemy Business oferece suporte aos seguintes atributos SAML.
Observação: todos os atributos diferenciam espaços e letras maiúsculas e minúsculas. Copie e cole diretamente da tabela abaixo.
| Atributo SAML | Obrigatório? | Descrição |
| Sim | O e-mail exclusivo do usuário | |
| firstName | Opcional | O nome do usuário |
| middleName | Opcional | O nome do meio (se houver) do usuário |
| lastName | Opcional | O sobrenome do usuário |
| displayName | Opcional | O nome completamente formatado do usuário |
| grupos | Opcional | A lista de grupos aos quais o usuário pertence. Observação: se você não planeja enviar grupos, não envie esse atributo, pois ele substituirá os grupos existentes. |
| externalID | Opcional | Um ID do usuário exclusivo especificado pelo cliente |
| lmsUserID | Opcional | Um ID de usuário exclusivo especificado pelo cliente (uma integração de LMS precisa ser configurada para que esse valor seja enviado) |
| licenseTypes | Opcional | Especifica os tipos de licença da Udemy Business atribuída a um usuário. Valores: Enterprise ou Enterprise Pro. |
| licensePoolName | Opcional | Identifica a qual conjunto de licenças o usuário está associado |
- Depois de adicionar os atributos, clique em Save (Salvar) para concluir a configuração do atributo.
Etapa 5: dê permissão aos usuários para usar o aplicativo da Udemy
- Volte para a tela Set up Single Sign-On with SAML (Configuração de SSO com SAML) e clique em Users and Groups (Usuários e grupos) no painel à esquerda.
- Clique em Add user/group (Adicionar usuário/grupo).
- Em Users (Usuários), clique em None Selected (Nenhum selecionado) e procure o usuário ou grupo ao qual você deseja conceder permissão para acessar o aplicativo.
- Após selecionar os usuários ou grupos que queria adicionar, clique em Select (Selecionar) na parte inferior da tela.
- Clique em Assign (Atribuir). Apenas os usuários ou grupos selecionados têm permissão para fazer login na Udemy com SSO.
Etapa 6: carregue o arquivo de metadados do Entra na Udemy
- Volte para Set up Single Sign-On with SAML (Configurar o Single Sign-On com SAML) no Entra.
- Role para baixo até SAML Certificates (Certificados SAML).
- Procure App Federation Metadata URL (URL de metadados da Federação de aplicativo) e copie o link.
- Após copiar o URL de metadados, volte para a página de configuração de SSO da Udemy Business em Gerenciar > Configurações > Single Sign-On (SSO).
- Em Configurar usando, selecione URL de metadados e cole o URL de metadados que você copiou anteriormente, em seguida clique em Importar metadados.
- Você deve ver os dados de metadados aparecendo. Após confirmar isso, role para baixo até o final da página e clique Salvar.
- Sua conexão com SSO está ativada. Você pode verificar o status na página Single sign-on (SSO), que exibirá o status da conexão, a data de validade do certificado e opções para editar ou pausar a conexão.
- Se receber a mensagem de erro "Erro ao editar e habilitar a conexão SSO", isso provavelmente é causado por um IdP EntityID duplicado. Siga o guia Configurar instâncias adicionais de Entra ID para Udemy Business para resolver este problema.
Opção B: configurar usando OIDC
Etapa 1: registre a Udemy Business como um aplicativo no Entra ID
Para orientações adicionais, consulte a documentação oficial da Microsoft sobre configuração do OIDC SSO para aplicativos personalizados e o protocolo OpenID Connect na plataforma de identidade da Microsoft.
- Faça login no centro de administração do Microsoft Entra e navegue até More Services (Mais serviços), depois procure por App registrations (Registros de aplicativos).
- Clique em New registration (Nova inscrição) e configure o seguinte:
- Nome: Udemy Business (ou um nome de sua escolha)
- Tipos de conta suportados: selecione a opção apropriada para sua organização, geralmente Accounts in this organizational directory only (Contas apenas neste diretório organizacional).
- URI de redirecionamento: selecione Web e insira “https://sso.udemy.com/api/oauth/oidc”.
- Clique Register (Registrar).
- Na página de visão geral do aplicativo, copie o Application (client) ID [ID do Aplicativo (cliente)]. Você precisará disso na Udemy Business.
- Navegue até Certificates & secrets (Certificados e segredos) → Client secrets (Segredos do cliente) → New client secret (Novo segredo do cliente).
- Adicione uma descrição, defina um período de validade e clique Add (Adicionar). Copie o valor secreto imediatamente, pois ele não será mostrado novamente.
Etapa 2: complete a configuração do OIDC na Udemy Business
Retorne à tela de configuração do SSO da Udemy Business.
- No campo Nome, insira um nome para essa conexão.
- Selecione OIDC como o tipo de conexão.
- Insira os seguintes valores:
ID do Cliente: obtido na visão geral do aplicativo no Entra rotulada como Application (client) ID [ID do Aplicativo (cliente)].
Segredo do Cliente: obtido do valor secreto que você copiou anteriormente
URL conhecido:- Obtido acessando a tela de visão geral e clicando em Endpoints. Copie o URL para OpenID Connect metadata document (Documento de metadados OpenID Connect). Deve ser igual a este: https://login.microsoftonline.com/[seu-id-de-locatário]/v2.0/.well-known/openid-configuration
- Clique em Save (Salvar).
Etapa 3: atribua usuários e grupos no Entra ID
Após salvar a conexão, atribua os usuários ou grupos relevantes ao aplicativo da Udemy Business no Entra ID.
- No centro de administração do Entra, acesse seu aplicativo empresarial da Udemy Business.
- Selecione Users and groups (Usuários e grupos), em seguida clique em Add user/group (Adicionar usuário/grupo).
- Selecione os usuários ou grupos que deseja atribuir e clique Assign (Atribuir).
Testar sua conexão SSO
Antes de implementar o SSO na sua organização, recomendamos testar a conexão:
- Abra uma janela de navegador anônima/no modo incógnito.
- Navegue até a sua página de login da Udemy Business.
- Selecione a conexão SSO que você criou e faça login com uma conta de usuário de teste.
- Confirme que o usuário é autenticado e redirecionado com sucesso para a Udemy Business.
Configurar instâncias adicionais de Entra ID para Udemy Business
Se você está configurando uma instância adicional de Entra ID (Azure AD) para integrar com a Udemy Business, siga as etapas abaixo para garantir uma configuração bem-sucedida. Cada conexão de SSO deve usar identificadores exclusivos para evitar conflitos.
Obter um ID de entidade do IdP exclusivo
Para gerar um ID de entidade do IdP exclusivo para cada integração adicional, você precisará ativar o URI de ID do aplicativo nas suas configurações do Entra SAML.
Siga as instruções abaixo para obter um ID de entidade exclusivo do Azure AD (Entra ID) para cada
instância da Udemy.
Etapa 1: ative o ID do aplicativo para o emissor (cliente)
- Navegue até o aplicativo da Udemy no Entra. Nas configurações de SAML, acesse Attributes and Claims (Atributos e declarações).
- Navegue até Advanced Settings (Configurações avançadas).
- Clique em Edit (Editar) em Advanced SAML Claim Options (Opções avançadas de declaração do SAML).
- Selecione o sinalizador Append Application ID to Issuer (Incluir ID do aplicativo ao emissor) e clique em Save (Salvar).
Etapa 2: adicione o ID do aplicativo ao arquivo de metadados (Udemy)
1. Volte até as configurações do SAML e acesse SAML Certificates (Certificados SAML). Copie o URL de metadados da Federação de aplicativo.
2. Cole o URL na janela do navegador e copie o ID do aplicativo.
3. Salve a página como um arquivo XML, ou acesse a página anterior e faça download do XML de metadados da federação.
4. Abra o arquivo de metadados em um documento de texto e inclua o IA do aplicativo ao lado do EntityID. Você pode usar Ctrl+F "entityID" para encontrar a seção.
5. Por exemplo, se o EntityID for: "https://sts.windows.net/728f03be-40cd-47a7-8ff3-58569e27d1c5/”
Atualize para:
"https://sts.windows.net/728f03be-40cd-47a7-8ff3-58569e27d1c5/44234257-31f0-4928-9762-5913dd59dd36"
6. Salve o arquivo de metadados atualizado.
7. Após copiar o URL de metadados, volte para a página de configuração de SSO da Udemy Business em Gerenciar > Configurações > Single Sign-On (SSO).
8. Em Configurar usando, selecione Arquivo de metadados e Selecionar arquivo. Procure o arquivo de metadados que você editou e clique em Importar metadados.
9. Você deve ver os dados de metadados aparecendo. Após confirmar isso, role para baixo até o final da página e clique Salvar.
Sua conexão com SSO está ativada. Você pode verificar o status na página Single sign-on (SSO), que exibirá o status da conexão, a data de validade do certificado e opções para editar ou pausar a conexão.