Compartilhar via

Integração do SSO do Microsoft Entra ao Docker

  • Artigo

Neste tutorial, você aprenderá a integrar o Docker ao Microsoft Entra ID. Ao integrar o Docker ao Microsoft Entra ID, você poderá:

  • Controlar no Microsoft Entra ID quem tem acesso ao Docker.
  • Permitir que os usuários entrem automaticamente no Docker com as respectivas contas do Microsoft Entra.
  • Gerencie suas contas em um local central.

Pré-requisitos

Para integrar o Microsoft Entra ID no Docker, você precisará de:

  • Uma assinatura do Microsoft Entra. Caso você não tenha uma assinatura, obtenha uma conta gratuita.
  • Uma assinatura do Docker Business.

Descrição do cenário

Neste tutorial, você vai configurar e testar o SSO do Microsoft Entra em um ambiente de teste.

  • O Docker só dá suporte ao SSO iniciado por SP.
  • Ele também dá suporte ao provisionamento de usuário just-in-time.

Para configurar a integração do Docker ao Microsoft Entra ID, é necessário adicionar o Docker, por meio da galeria, à lista de aplicativos SaaS gerenciados.

  1. Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
  2. Navegue até Identidade>Aplicativos>Aplicativos empresariais>Novo aplicativo.
  3. Na seção Adicionar por meio da galeria, digite Docker na caixa de pesquisa.
  4. Selecione Docker no painel de resultados e adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.

Opcionalmente, você também pode usar o Assistente de Configuração de Aplicativos do Enterprise. Neste assistente, você poderá adicionar um aplicativo ao locatário, adicionar usuários/grupos ao aplicativo, atribuir funções e também percorrer a configuração de SSO. Saiba mais sobre os assistentes do Microsoft 365.

Configurar e testar o SSO do Microsoft Entra para o Docker

Configure e teste o SSO do Microsoft Entra com Docker usando um usuário de teste chamado B.Fernandes. Para que o SSO funcione, é necessário estabelecer uma relação de vínculo entre um usuário do Microsoft Entra e o usuário relacionado do Docker.

Para configurar e testar o SSO do Microsoft Entra com o Docker, realize as seguintes etapas:

  1. Configurar o SSO do Microsoft Entra – para permitir que os usuários usem esse recurso.
    1. Crie um usuário de teste do Microsoft Entra para testar o logon único do Microsoft Entra com B.Silva.
    2. Atribuir o usuário de teste do Microsoft Entra – para permitir que B.Fernandes use o logon único do Microsoft Entra.
  2. Configurar o SSO do Docker – Para definir as configurações de logon único no lado do aplicativo.
    1. Criar um usuário de teste do Docker – Para ter um equivalente de B.Fernandes no Docker que esteja vinculado à representação de usuário do Microsoft Entra ID.
  3. Testar o SSO – para verificar se a configuração funciona.

Configurar o SSO do Microsoft Entra

Siga estas etapas para habilitar SSO do Microsoft Entra no Centro de administração do Microsoft Entra.

  1. Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.

  2. Navegue até Identidade>Aplicativos>Aplicativos empresariais>Docker>Logon único.

  3. Na página Selecionar um método de logon único, escolha SAML.

  4. Na página Configurar o logon único com o SAML, clique no ícone de caneta da Configuração Básica do SAML para editar as configurações.

    Captura de tela que mostra como editar a Configuração Básica do SAML.

  5. Na seção Configuração básica de SAML, realize as seguintes etapas:

    a. Na caixa de texto Identificador (ID da Entidade) , digite um valor usando o seguinte padrão: urn:auth0:docker-prod:<Docker_SsoID>

    b. No URL de resposta caixa de texto, digite uma URL usando o seguinte padrão: https://login.docker.com/login/callback?connection=<Docker_SsoID>

    c. Na caixa de texto URL de Logon, digite uma URL usando o seguinte padrão: https://hub.docker.com/auth/start?connection=<Docker_SsoID>

    Observação

    Esses valores não são reais. Atualize esses valores com o Identificador, a URL de Resposta e a URL de Logon reais. Você obterá esses valores ao configurar o SSO do Docker. Consulte também os padrões mostrados na seção Configuração Básica do SAML no Centro de administração do Microsoft Entra.

  6. O aplicativo Docker espera que o Identificador de Usuário Exclusivo seja mapeado para um endereço de email (user.mail) em vez de user.userprincipalname. Além disso, ele dá suporte ao nome e ao sobrenome para sincronizar o nome completo dos usuários no aplicativo do Docker. A captura de tela a seguir mostra a lista de atributos padrão.

    Captura de tela que mostra a imagem dos atributos.

    Observação

    Exclua o nome e o endereço de email manualmente dos atributos padrão acima no centro de administração do Microsoft Entra, de acordo com os requisitos do aplicativo.

  7. Além do indicado acima, o aplicativo do Docker dá suporte à transmissão de atributos opcionais novamente à resposta do SAML, os quais são mostrados abaixo. Esses atributos podem ser adicionados para gerenciar o provisionamento de usuários em equipes específicas e as respectivas funções dentro da Organização do Docker. Para saber mais sobre todos os atributos aos quais o SSO do Docker dá suporte, veja o documento SSO do Docker.

    Nome da declaração Namespace Atributo de Origem
    dockerOrg <empty> Nome da Organização do Docker
    dockerTeam <empty> Nome da Equipe do Docker
    dockerRole <empty> Função de usuário na Organização. Valores permitidos: “proprietário”, “editor” e “membro”.

    Observação

    Se a organização precisar gerenciar usuários em várias equipes, as declarações de grupo também poderão ser habilitadas. Para saber mais sobre o Gerenciamento de Grupo de SSO do Docker, clique aqui.

  8. Na página Configurar Logon Único com SAML, na seção Certificado de Autenticação SAML, localize Certificado (Base64) e escolha Baixar para baixar o certificado e salvá-lo no computador.

    Captura de tela que mostra o link de download do Certificado.

  9. Na seção Configurar o Docker, copie as URLs apropriadas de acordo com as suas necessidades.

    Captura de tela que mostra como copiar as URLs de configuração.

Criar um usuário de teste do Microsoft Entra

Nesta seção, você criará um usuário de teste chamado B.Fernandes no Centro de administração do Microsoft Entra.

  1. Entre no centro de administração do Microsoft Entra como, no mínimo, Administrador de Usuários.
  2. Navegue até Identidade>Usuários>Todos os usuários.
  3. Na parte superior da tela, selecione Novo usuário>Criar novo usuário.
  4. Nas propriedades do Usuário, siga estas etapas:
    1. No campo Nome de exibição, insira B.Simon.
    2. No campo Nome principal do usuário, insira o username@companydomain.extension. Por exemplo, B.Simon@contoso.com.
    3. Marque a caixa de seleção Mostrar senha e, em seguida, anote o valor exibido na caixa Senha.
    4. Selecione Examinar + criar.
  5. Selecione Criar.

Atribuir o usuário de teste do Microsoft Entra

Nesta seção, você habilitará B.Fernandes a usar o logon único do Microsoft Entra, permitindo acesso ao Docker.

  1. Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
  2. Navegue até Identidade>Aplicativos>Aplicativos empresariais>Docker.
  3. Na página de visão geral do aplicativo, selecione Usuários e grupos.
  4. Selecione Adicionar usuário/grupo e, em seguida, Usuários e grupos na caixa de diálogo Adicionar atribuição.
    1. Na caixa de diálogo Usuários e grupos, selecione B.Fernandes na lista Usuários e clique no botão Selecionar na parte inferior da tela.
    2. Se você estiver esperando que uma função seja atribuída aos usuários, escolha-a na lista suspensa Selecionar uma função. Se nenhuma função tiver sido configurada para esse aplicativo, você verá a função "Acesso Padrão" selecionada.
    3. Na caixa de diálogo Adicionar atribuição, clique no botão Atribuir.

Configurar o SSO do Docker

  1. Faça logon no site da empresa do Docker como administrador.

  2. Selecione sua organização ou empresa no menu suspenso à esquerda e clique em SSO e SCIM.

  3. Na tabela de conexões SSO, selecione Criar Conexão e crie um nome para a conexão.

    Observação

    Você precisa verificar, pelo menos, um domínio antes de criar as conexões.

  4. Escolha SAML como um método de autenticação e realize as seguintes etapas:

    Captura de tela que mostra a Configuração.

    1. Copie o valor de ID da Entidade e cole-o na caixa de texto Identificador (ID da Entidade) na seção Configuração Básica do SAML no centro de administração do Microsoft Entra.

    2. Copie o valor do URL do ACS e cole esse valor na caixa de texto URL de Resposta na seção Configuração Básica do SAML no centro de administração do Microsoft Entra.

    3. No campo URL de Logon Único do SAML, cole o valor da URL de Logon que você copiou do centro de administração do Microsoft Entra.

    4. Abra o Certificado (Base64) baixado no Bloco de notas e cole o conteúdo na caixa de texto Certificado x509 da Chave.

    5. Clique em Avançar e Salvar Conexão.

Criar um usuário de teste do Docker

Nesta seção, um usuário chamado Brenda Fernandes será criado no Docker. O Docker dá suporte ao provisionamento de usuário just-in-time, que está habilitado por padrão. Não há itens de ação para você nesta seção. Se ainda não houver nenhum usuário no Docker, ele será criado após a autenticação.

Testar o SSO

Nesta seção, você vai testar a configuração de logon único do Microsoft Entra com as opções a seguir.

  • Clique em Testar este aplicativo no Centro de administração do Microsoft Entra. Isso redirecionará você para a URL de Entrada do Docker, por meio da qual você poderá iniciar o fluxo de logon.

  • Acesse diretamente a URL de Logon do Docker e inicie o fluxo de logon por meio dela.

  • Você pode usar os Meus Aplicativos da Microsoft. Ao clicar no bloco do Docker em Meus Aplicativos, você será redirecionado para a URL de Logon do Docker. Para obter mais informações sobre os Meus Aplicativos, confira Introdução aos Meus Aplicativos.

Próximas etapas

Após configurar o Docker, você poderá impor o controle de sessão, que fornece proteção em tempo real contra exfiltração e infiltração dos dados confidenciais da sua organização. O controle da sessão é estendido do acesso condicional. Saiba como impor o controle de sessão com o Microsoft Defender for Cloud Apps.