Configuração de SAML SSO

Você configurará duas App Integrations no Okta para cada organização do ClickHouse: um app SAML e um bookmark para o seu link direto.

Crie um grupo para gerenciar o acesso

1. Faça login na sua instância do Okta como Administrator.
2. Selecione Groups à esquerda.
3. Clique em Add group.
4. Insira um nome e uma descrição para o grupo. Esse grupo será usado para manter os usuários sincronizados entre o app SAML e o app de bookmark relacionado.
5. Clique em Save.
6. Clique no nome do grupo que você criou.
7. Clique em Assign people para atribuir os usuários que você deseja que tenham acesso a esta organização do ClickHouse.

Crie um app de bookmark para permitir que os usuários façam login de forma transparente

1. Selecione Applications à esquerda e, em seguida, selecione o subtítulo Applications.
2. Clique em Browse App Catalog.
3. Pesquise por Bookmark App e selecione-o.
4. Clique em Add integration.
5. Escolha um rótulo para o app.
6. Insira a URL como https://console.clickhouse.cloud/?connection={organizationid}
7. Vá para a aba Assignments e adicione o grupo que você criou acima.

Crie um app SAML para habilitar a conexão

1. Selecione Applications à esquerda e, em seguida, selecione o subtítulo Applications.

2. Clique em Create App Integration.

3. Selecione SAML 2.0 e clique em Next.

4. Insira um nome para seu aplicativo, marque a caixa ao lado de Don't display application icon to users e clique em Next.

5. Use os valores a seguir para preencher a tela de configurações de SAML.

   Campo	Valor
   Single Sign On URL	Copie a Single Sign-On URL do console
   Audience URI (SP Entity ID)	Copie o Service Provider Entity ID do console
   Default RelayState	Deixe em branco
   Name ID format	Unspecified
   Application username	Email
   Update application username on	Create and update

6. Insira a seguinte Attribute Statement.

   Name	Name format	Value
   email	Basic	user.email

7. Clique em Next.

8. Insira as informações solicitadas na tela Feedback e clique em Finish.

9. Vá para a aba Assignments e adicione o grupo que você criou acima.

10. Na aba Sign On do seu novo app, clique no botão Copy metadata URL.

11. Retorne para Add the metadata URL to your SAML configuration para continuar o processo.

Você configurará um app SAML no Google para cada organização e deverá fornecer aos usuários o link direto (https://console.clickhouse.cloud/?connection={organizationId}) para que o adicionem aos favoritos ao usar multi-org SSO.

Criar um app da web do Google

1. Acesse o console do Google Admin (admin.google.com).

   

2. Clique em Apps e, em seguida, em Web and mobile apps à esquerda.

3. Clique em Add app no menu superior e selecione Add custom SAML app.

4. Insira um nome para o app e clique em Continue.

5. Copie a URL de metadados e salve-a em algum lugar.

6. Insira a ACS URL e o Entity ID abaixo.

   Campo	Valor
   ACS URL	Copie a Single Sign-On URL do console
   Entity ID	Copie o Service Provider Entity ID do console

7. Marque a caixa Signed response.

8. Selecione EMAIL para o formato de Name ID e deixe o Name ID como Basic Information > Primary email.

9. Clique em Continue.

10. Insira o seguinte mapeamento de atributos:

    Campo	Valor
    Informações básicas	Email principal
    Atributos do app	email

11. Clique em Finish.

12. Para habilitar o app, clique em OFF para todos e altere a configuração para ON para todos. O acesso também pode ser limitado a grupos ou unidades organizacionais selecionando opções no lado esquerdo da tela.

13. Volte para Adicionar a URL de metadados à sua configuração de SAML para continuar o processo.

O SAML do Azure (Microsoft) também pode ser chamado de Azure Active Directory (AD) ou Microsoft Entra.

Crie uma aplicação empresarial do Azure

Você configurará uma integração de aplicação com uma URL de login separada para cada organização.

1. Entre no centro de administração do Microsoft Entra.

2. Navegue até Applications > Enterprise applications no menu à esquerda.

3. Clique em New application no menu superior.

4. Clique em Create your own application no menu superior.

5. Insira um nome e selecione Integrate any other application you don't find in the gallery (Non-gallery); em seguida, clique em Create.

   

6. Clique em Users and groups à esquerda e atribua os usuários.

7. Clique em Single sign-on à esquerda.

8. Clique em SAML.

9. Use as configurações a seguir para preencher a tela Basic SAML Configuration.

   Field	Value
   Identifier (Entity ID)	Copie o Service Provider Entity ID do console
   Reply URL (Assertion Consumer Service URL)	Copie a Single Sign-On URL do console
   Sign on URL	https://console.clickhouse.cloud/?connection={organizationid}
   Relay State	Em branco
   Logout URL	Em branco

10. Adicione (A) ou atualize (U) o seguinte em Attributes & Claims:

    Claim name	Format	Source attribute
    (U) Unique User Identifier (Name ID)	Email address	user.mail
    (A) email	Basic	user.mail
    (U) /identity/claims/name	Omitted	user.mail

    

11. Copie a metadata URL e volte para Adicionar a metadata URL à sua configuração SAML para continuar o processo.

Crie um provedor de serviço SAML genérico para o Duo

1. Siga as instruções em Duo Single Sign-On for Generic SAML Service Providers.

2. Use o seguinte mapeamento de atributos do Bridge:

   Bridge Attribute	ClickHouse Attribute
   Endereço de email	email

3. Use os seguintes valores para atualizar seu Cloud Application no Duo:

   Field	Value
   ID da entidade	Copie o Service Provider Entity ID do console
   URL do Assertion Consumer Service (ACS)	Copie a Single Sign-On URL do console
   URL de login do provedor de serviço	https://console.clickhouse.cloud/?connection={organizationid}

4. Copie a metadata URL e volte para Adicionar a metadata URL à sua configuração de SAML para continuar o processo.