Com o padrão SAML 2.0, é possível configurar o Logon único (SSO) em vários apps na nuvem. Depois que você configurar o SSO, seus usuários poderão usar as credenciais do Google Workspace para fazer login em um app.
Usar SAML para configurar o SSO do Black Duck
Para realizar essa tarefa, você precisa fazer login como superadmin.Antes de começar
É possível usar o Black Duck no Google Compute Engine (GCE), Amazon Web Services (AWS) ou Azure. Para instruções de instalação, consulte a documentação da plataforma na nuvem do Black Duck.
Etapa 1: configurar o Google como um provedor de identidade SAML
-
No Google Admin Console, acesse Menu
Apps
Apps da Web e para dispositivos móveis.
Para realizar essa tarefa, você precisa fazer login como superadmin.
-
Clique em Adicionar app
Pesquisar apps.
-
Em Digitar nome do app, insira Blackduck.
-
Nos resultados da pesquisa, passe o cursor sobre Blackduck e clique em Selecionar.
-
Na janela Detalhes do provedor de identidade do Google, faça o download dos metadados do provedor de identidade.
-
Clique em Continuar.
-
Na página Detalhes do provedor de serviços, em URL do ACS e ID da entidade, substitua {seu-dominio} pelo domínio onde o Black Duck está instalado.
-
Clique em Continuar.
-
Na janela Mapeamento de atributos, clique em Selecionar campo e mapeie os seguintes atributos do diretório do Google para os atributos correspondentes do Black Duck. Os atributos FirstName, LastName, Email e Name são obrigatórios.
Atributo do diretório do Google Atributo do Black Duck Basic Information > First Name FirstName Basic Information > Last Name LastName Basic Information > Primary Email Email Basic Information > Primary Email Nome - (Opcional) Para incluir outros mapeamentos, clique em Adicionar mapeamento e selecione os campos que precisam ser mapeados.
-
(Opcional) Para inserir nomes de grupos relevantes para este app:
- Em Associação ao grupo (opcional), clique em Pesquisar um grupo, digite uma ou mais letras do nome do grupo e selecione o nome.
- Adicione outros grupos conforme necessário (máximo de 75 grupos).
- Em Atributo do app, digite o nome do atributo de grupo correspondente do provedor de serviços.
Independentemente do total de nomes de grupo informados, a resposta SAML inclui apenas grupos de que o usuário faz parte (direta ou indiretamente). Para mais informações, acesse Sobre o mapeamento de associação ao grupo.
-
Clique em Finish.
Etapa 2: configurar o Black Duck como um provedor de serviços SAML 2.0
-
Abra uma janela de navegação anônima, acesse a página de login do Black Duck e faça login com sua conta de administrador do Black Duck.
-
Clique em Administração e selecione Integração SAML.
-
Marque a caixa Ativar SAML.
-
Em URL da entidade do provedor de serviços, insira a URL do hub.
-
Em Metadados do provedor de identidade, cole os metadados do provedor de identidade baixados na Etapa 1.
-
Clique em Salvar.
-
Conecte-se ao servidor de hub usando o Secure Shell (SSH).
-
No diretório docker-compose, adicione a seguinte linha ao final do arquivo hub-proxy.env: HUB_SAML_EXTERNAL_URL={url-para-o-hub}.
-
Substitua {url-to-the-hub} pelo URL da instância em que o Black Duck está instalado.
-
Reinicie a instância do hub.
Etapa 3: ativar o app para os usuários
-
No Google Admin Console, acesse Menu
Apps
Apps da Web e para dispositivos móveis.
Para realizar essa tarefa, você precisa fazer login como superadmin.
-
Clique em Blackduck.
- Clique em Acesso do usuário.
-
Se você quiser ativar ou desativar um serviço para todos na organização, clique em Ativado para todos ou Desativado para todos, depois clique em Salvar.
-
(Opcional) Para ativar ou desativar um serviço em uma unidade organizacional:
- Selecione a unidade organizacional à esquerda.
- Para mudar o status do serviço, selecione Ativado ou Desativado.
- Escolha uma opção:
- Se o status do serviço estiver definido como Herdado e você quiser manter a configuração atualizada, mesmo que a configuração mãe seja alterada, clique em Substituir.
- Caso o status do serviço esteja definido como Substituído, clique em Herdar para reverter e usar a configuração mãe ou clique em Salvar para manter a nova configuração, mesmo que a configuração mãe seja alterada.
Saiba mais sobre estrutura organizacional.
- (Opcional) Se você quiser ativar um serviço para alguns usuários em uma ou várias unidades organizacionais, selecione um grupo de acesso. Saiba mais em Personalizar o acesso ao serviço usando grupos de acesso.
-
Certifique-se de que os domínios de e-mail da sua conta de usuário do Black Duck correspondam ao domínio principal da Conta do Google gerenciada pela sua organização.
Etapa 4: verificar se o SSO está funcionando
O Black Duck suporta SSO apenas se você fizer login pelo Google. Não será possível usar o SSO se você fizer login diretamente no Black Duck.
Verificar o SSO iniciado pelo provedor de identidade
-
No Google Admin Console, acesse Menu
Apps
Apps da Web e para dispositivos móveis.
Para realizar essa tarefa, você precisa fazer login como superadmin.
-
Clique em Blackduck.
-
Na seção Blackduck, clique em Testar login SAML. O app abrirá uma guia separada. Caso contrário, resolva o problema da mensagem de erro e tente novamente. Confira mais detalhes sobre a solução de problemas em Mensagens de erro do app SAML.
Google, Google Workspace e marcas e logotipos relacionados são marcas registradas da Google LLC. Todos os outros nomes de empresas e produtos são marcas registradas das empresas às quais estão associados.