App na nuvem Black Duck

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

  1. No Google Admin Console, acesse Menu e depois Apps e depois Apps da Web e para dispositivos móveis.

    Para realizar essa tarefa, você precisa fazer login como superadmin.

  2. Clique em Adicionar app e depois Pesquisar apps.
  3. Em Digitar nome do app, insira Blackduck.

  4. Nos resultados da pesquisa, passe o cursor sobre Blackduck e clique em Selecionar.

  5. Na janela Detalhes do provedor de identidade do Google, faça o download dos metadados do provedor de identidade.

  6. Clique em Continuar.

  7. 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.

  8. Clique em Continuar.

  9. 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
  10. (Opcional) Para incluir outros mapeamentos, clique em Adicionar mapeamento e selecione os campos que precisam ser mapeados.
  11. (Opcional) Para inserir nomes de grupos relevantes para este app:
    1. Em Associação ao grupo (opcional), clique em Pesquisar um grupo, digite uma ou mais letras do nome do grupo e selecione o nome.
    2. Adicione outros grupos conforme necessário (máximo de 75 grupos).
    3. 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.

  12. Clique em Finish.

Etapa 2: configurar o Black Duck como um provedor de serviços SAML 2.0

  1. 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.

  2. Clique em Administração e selecione Integração SAML.

  3. Marque a caixa Ativar SAML.

  4. Em URL da entidade do provedor de serviços, insira a URL do hub.

  5. Em Metadados do provedor de identidade, cole os metadados do provedor de identidade baixados na Etapa 1.

  6. Clique em Salvar.

  7. Conecte-se ao servidor de hub usando o Secure Shell (SSH).

  8. No diretório docker-compose, adicione a seguinte linha ao final do arquivo hub-proxy.env: HUB_SAML_EXTERNAL_URL={url-para-o-hub}.

  9. Substitua {url-to-the-hub} pelo URL da instância em que o Black Duck está instalado.

  10. Reinicie a instância do hub.

Etapa 3: ativar o app para os usuários

Antes de começar: se quiser ativar ou desativar o serviço para determinados usuários, coloque as contas deles em uma unidade organizacional (para controlar o acesso por departamento) ou em um grupo de acesso (para permitir o acesso dos usuários de um ou vários departamentos).
  1. No Google Admin Console, acesse Menu e depois Apps e depois Apps da Web e para dispositivos móveis.

    Para realizar essa tarefa, você precisa fazer login como superadmin.

  2. Clique em Blackduck.

  3. Clique em Acesso do usuário.
  4. 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.

  5. (Opcional) Para ativar ou desativar um serviço em uma unidade organizacional:
    1. Selecione a unidade organizacional à esquerda.
    2. Para mudar o status do serviço, selecione Ativado ou Desativado.
    3. 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.

  6. (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.
  7. 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

  1. No Google Admin Console, acesse Menu e depois Apps e depois Apps da Web e para dispositivos móveis.

    Para realizar essa tarefa, você precisa fazer login como superadmin.

  2. Clique em Blackduck.

  3. 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.