--- title: "Ativar as ligações Entra ID SSO com a sua conta OVHcloud" description: "Saiba como associar o seu Entra ID (anteriormente Azure Active Directory) à sua conta OVHcloud utilizando SAML 2.0" url: https://docs.ovhcloud.com/pt/guides/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad lang: pt lastUpdated: 2025-05-15 --- # Ativar as ligações Entra ID SSO com a sua conta OVHcloud ## Objetivo Pode utilizar a autenticação **SSO** (_Single Sign-On_) para se ligar à sua conta OVHcloud. Para ativar estas ligações, a sua conta e o seu Entra ID (anteriormente Azure Active Directory) devem ser configurados através do SAML (_Security Assertion Markup Language_). **Saiba como associar a sua conta OVHcloud a um Entra ID externo.** ## Requisitos - Ter acesso às funções de **Administrador de aplicações** e **Administrador de utilizadores** de um serviço Entra ID - Ter uma [conta OVHcloud](/pt/guides/account-and-service-management/account-information/ovhcloud-account-creation.md) *** ### Acesso à Área de Cliente OVHcloud - **Ligação direta:** SAML SSO - **Caminho de navegação:** Identidade, Segurança e Operações > Users > SSO connection *** ## Instruções :::info Para que um prestador de serviços (por exemplo, a sua conta OVHcloud) estabeleça uma ligação SSO com um fornecedor de identidade (por exemplo, o seu Entra ID), deve estabelecer uma relação de confiança mútua ao registar a ligação SSO em ambos os serviços. ::: ### Utilizadores e grupos Entra ID O seu Entra ID atua como fornecedor de identidade. Os pedidos de autenticação da sua conta OVHcloud só serão aceites se o tiver declarado como terceiro de confiança. Concentremo-nos, por um momento, nas identidades do lado do fornecedor de identidade. #### Utilizadores Entra ID Para começar, aceda ao painel de controlo Entra ID. ![Painel de controlo Entra ID](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_dashboard.png) A seguir, clique em `Users ` no menu à esquerda. ![Utilizador do menu Entra ID](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_menu_user.png) Crie tantos utilizadores quantos desejar e/ou verifique os seus utilizadores clicando em cima. Neste exemplo, será utilizado o utilizador **John Smith**. ![Utilizador Entra ID](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_user.png) Quando é efetuada uma autenticação SSO, a identidade de **John Smith** é fornecida pela Entra ID à conta OVHcloud. No entanto, é necessário que essa identidade contenha pelo menos um grupo. Se nenhum grupo existir, veja abaixo como criar um grupo para adicionar **John Smith**. #### Grupos Entra ID Clique em `Groups ` no menu à esquerda. ![Grupos de menus Entra ID](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_menu_groups.png) Clique em `New group ` no menu superior e introduza todas as informações necessárias. Para este exemplo, utilizar-se-á o grupo **manager\@ovhcloudsaml**. ![Entra ID Group etapa 1](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_group_1.png) Clique no botão `Create ` para apresentar todas as informações sobre este grupo. ![Entra ID Group etapa 2](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_group_2.png) Agora, os utilizadores que serão utilizados para a autenticação SSO devem ser adicionados a um grupo. Neste exemplo, associemos o utilizador **John Smith** ao grupo **manager\@ovhcloudsaml**. Na interface do grupo selecionado, clique em `Members ` no menu à esquerda e, a seguir, em `Add members ` no menu superior. ![Entra ID Group User Assignment Passo 1](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_group_user_assignment_1.png) Selecione o utilizador a adicionar neste grupo e clique no botão `Select `. ![Entra ID Group User Assignment Passo 2](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_group_user_assignment_2.png) Agora, o utilizador é atribuído ao grupo. Para efetuar as autenticações SSO, deve ser criada uma aplicação Entra ID. A autenticação única deve ser configurada nesta aplicação. ### Aplicações Entra ID Em primeiro lugar, crie uma aplicação se ela ainda não existir. #### Criar uma aplicação Entra ID Clique em `Enterprise applications ` no menu à esquerda. ![Aplicações de menu Entra ID](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_menu_applications.png) Clique em `New application ` no menu superior. ![Aplicações Entra ID etapa 1](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_applications_1.png) Clique em `Create your own application ` no menu superior. ![Aplicações Entra ID etapa 2](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_applications_2.png) Selecione `Non-Gallery ` no menu à esquerda e clique no botão `Create `. ![Aplicações Entra ID etapa 3](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_applications_3.png) Os detalhes da aplicação serão apresentados. ![Aplicações Entra ID etapa 4](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_applications_4.png) A aplicação Entra ID foi criada. Os utilizadores que pretendam efetuar autenticações SSO através desta aplicação devem agora ser acrescentados. #### Aplicação Entra ID - Afetação de utilizadores :::info Para que um utilizador efetue uma autenticação SSO a partir de uma aplicação Entra ID, deve ser adicionado a esta aplicação. Encontre aqui como adicionar um utilizador a uma aplicação Entra ID. No entanto, é melhor adicionar um grupo de utilizadores do que utilizadores se tiver **Entra ID Premium**. ::: Clique em `Users and groups ` no menu à esquerda e, em seguida, em `Add user/group ` no menu superior. A seguir, clique na secção `Users `, selecione o utilizador a adicionar à aplicação e clique no botão `Select `. ![Entra ID Application User Assignment Passo 1](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_application_user_assignment_1.png) ![Entra ID Application User Assignment Passo 2](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_application_user_assignment_2.png) A aplicação é criada, o utilizador é atribuído, só precisa de configurar o SSO via SAML. #### Entra ID aplicação SSO Consulte o conjunto através do botão `Overview ` no menu à esquerda e clique na secção `Set up single sign on ` on. ![Entra ID SSO etapa 1](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_sso_1.png) Clique na secção `SAML `. ![Entra ID SSO etapa 2](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_sso_2.png) Clique em `Upload metadata file ` no menu superior. ![Entra ID SSO etapa 3](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_sso_3.png) Clique no ícone do botão `Select a file `, selecione o ficheiro de metadados OVHcloud Service Provider e clique no botão `Add `. Pode obter o ficheiro de metadados adequado através das seguintes ligações: - [Metadados da região da UE](https://www.ovh.com/auth/sso/saml/sp/metadata.xml) - [Metadados de região CA](https://ca.ovh.com/auth/sso/saml/sp/metadata.xml) Faça o download do ficheiro de metadados, terá necessidade dele mais tarde. ![Entra ID SSO etapa 5](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_sso_5.png) Aparecerá a configuração SAML. ![Entra ID SSO etapa 6](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_sso_6.png) Na secção `Attributes & Claims `, clique no botão `Edit `. ![Entra ID SSO etapa 9](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_sso_9.png) Adicione o atributo UPN (User Principal Name) às informações SAML para informar a OVHcloud do e-mail do utilizador. Esta etapa é indispensável. Clique em `Add a new claim ` no menu superior. No campo `Name `, introduza o valor `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn` . No campo `Source attribute `, introduza `user.mail `. A sua interface deverá ser bastante semelhante à seguinte captura de ecrã: ![Entra ID SSO entrado UPN](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_sso_9bis.png) Clique em `Save ` Declare o atributo utilizado para o grupo do utilizador. Clique em `Add a group claim ` no menu superior. ![Entra ID SSO etapa 10](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_sso_10.png) Selecione `Security groups ` e **Group ID** na `Source attribute ` e clique no botão `Save `. ![Entra ID SSO etapa 11](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_sso_11.png) A reivindicação de **groups** deve agora constar da lista. Copie e registe o valor do **Claim name** algures (por exemplo, um bloco de notas), necessitará dele mais tarde. ![Entra ID SSO etapa 12](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_sso_12.png) Na secção `SAML certificates `, copie o valor do campo `App Federation Metadata Url `. Utilize esta ligação para descarregar o ficheiro de metadados da aplicação Entra ID para o utilizar mais tarde na conta OVHcloud. ![Entra ID SSO etapa 8](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_sso_8.png) ### Criar a confiança de uma conta OVHcloud e configurar a ligação A adição da sua aplicação Entra ID como fornecedor de identidade aprovado é efetuada na página SAML SSO da sua Área de Cliente OVHcloud, onde poderá fornecer os metadados do fornecedor de identidade. #### Criar confiança na OVHcloud Complete o campo **Nome de Atributo de utilizador** com a aplicação Entra ID **UPN** nome do pedido e no campo **Nome de atributo de grupo** com o valor de nome de pedido **groups** guardado antes. Preencha os metadados XML da sua aplicação Entra ID a partir do ficheiro anteriormente registado. É possível conservar os utilizadores locais marcando a caixa `Manter os utilizadores da OVHcloud ativos`. Clique no botão `Validar `. ![Ovhcloud SSO step 1](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/ovhcloud_sso_1.png) A adição da sua aplicação Entra ID como fornecedor de identidade foi estabelecida, mas deve ainda assim adicionar grupos à sua conta OVHcloud. :::warning Se tentar conectar-se através de SSO, é provável que apareça uma mensagem de erro "`Not in valid groups`". A sua conta OVHcloud verifica se o utilizador autenticado pertence a um grupo existente na conta. ::: Para resolver esta situação, verifique o atributo "Group" devolvido pela sua aplicação Entra ID: o campo **Object Id**. #### Declaração dos grupos OVHcloud ![Entra ID Group etapa 2](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_group_2.png) Para adicionar um grupo, aceda à secção `Identidades ` e aceda ao separador `Grupos de utilizadores `. De seguida, clique no botão `Declarar um grupo ` : ![Grupos de gestão de utilizadores Ovhcloud etapa 1](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/ovhcloud_sso_menu_1.png) Introduza o nome do grupo e selecione o privilégio associado e clique no botão `Validar `. ![Grupos de gestão de utilizadores Ovhcloud etapa 2](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/ovhcloud_sso_menu_2.png) O grupo criado deve constar da lista. ![Grupos de gestão de utilizadores Ovhcloud etapa 3](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/ovhcloud_sso_menu_3.png) Atenção: se conceder o privilégio `Nenhum`, será necessário atribuir permissões a este grupo através das [políticas IAM](/pt/guides/account-and-service-management/account-information/iam-policy-ui.md). ### Ligação via SSO Na página de identificação da OVHcloud , introduza o seu [identificador de cliente](/pt/guides/account-and-service-management/account-information/ovhcloud-account-creation.md#qual-e-o-meu-identificador-de-cliente) seguido de **/idp** sem password e clique no botão `Login `. ![Ovhcloud SSO Login step 1](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/ovhcloud_sso_login_1.png) De seguida, será redirecionado para a página de ligação à sua aplicação Entra ID. Selecione `Use another account `. ![Entra ID Login etapa 1](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_login_1.png) Introduza o e-mail do utilizador da aplicação Entra ID e clique no botão `Next `. ![Entra ID Login etapa 2](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_login_2.png) Introduza a palavra-passe do utilizador da aplicação Entra ID e clique no botão `Sign In `. ![Entra ID Login etapa 3](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/azure_ad_login_3.png) Já está ligado com o mesmo nichandle, mas através do utilizador Ative Diretory e utilizando o seu SSO de aplicação Entra ID. ![Ovhcloud SSO Login step 2](/images/account-and-service-management/account-information/ovhcloud-account-connect-saml-azure-ad/ovhcloud_sso_login_2.png) Se o seu e-mail não aparecer abaixo de `Connected via SSO`, isto significa que não configurou corretamente o atributo **UPN** e que uma parte das funcionalidades não poderá funcionar. ## Quer saber mais? [Criar uma conta OVHcloud](/pt/guides/account-and-service-management/account-information/ovhcloud-account-creation.md) [Proteger a minha conta OVHcloud e gerir as minhas informações pessoais](/pt/guides/account-and-service-management/account-information/all-about-username.md) [Definição e gestão da palavra-passe da sua conta](/pt/guides/account-and-service-management/account-information/manage-ovh-password.md) [Proteger a sua conta OVHcloud com a dupla autenticação](/pt/guides/account-and-service-management/account-information/secure-ovhcloud-account-with-2fa.md) [Como utilizar as políticas IAM a partir do seu Espaço Cliente](/pt/guides/account-and-service-management/account-information/iam-policy-ui.md) Fale com a nossa [comunidade de utilizadores](https://community.ovhcloud.com/).