Configuração de SSO SAML do Google Workspace

Este guia demonstra o passo a passo para a criação de uma nova aplicação no Google Workspace, capaz de se comunicar via SAML 2.0 com os serviços da Plataforma Axur. Neste guia, abordaremos todas as configurações necessárias para garantir que o Logon Único (SSO) funcione de maneira correta e esperada.

Em todos os tutoriais de criação de aplicações de SSO da Plataforma Axur, existe o conceito de usuários e grupos. Afinal, o provedor é onde todas as informações dos seus usuários estarão salvas, além dos grupos aos quais eles pertencem (a criação de grupos via provedor é opcional). Nesse sentido, esta seção se dedica a ensinar como criar grupos e usuários no Google Workspace, bem como atribuir usuários a grupos.

Observação: É de extrema importância que os nomes dos grupos obedeçam ao padrão determinado. Mais especificamente, um novo grupo deve conter os valores da tabela como sufixo:

Nesse sentido, valores de grupos como Axur-one-manager e ClienteX-one-expert são válidos, mas Axur-manager e ClienteX-analista não são, pois não incluem os sufixos esperados.

Siga o passo a passo nas imagens para criar um grupo. Você não precisa criar todos os grupos citados acima, apenas os que desejar. Antes das imagens, observe a seguinte tabela para informações sobre os grupos:

Para criar um usuário, siga o passo a passo nas imagens:

Para atribuir um usuário a um grupo que você criou, siga o passo a passo nas imagens:

Use este link para acessar o Google Workspace e faça o login com a sua conta de Administrador. Em seguida, siga o passo a passo nas imagens abaixo para criar a nova aplicação SAML fornecendo dados para a Plataforma Axur:

Como estamos utilizando o Google Workspace como nosso provedor de identidade, é necessário obter algumas informações que possam dizer para a Plataforma Axur com quem ela estará se comunicando e se as informações dela são seguras e confiáveis.

Seguindo o processo de criação da nossa aplicação SAML, temos a seguinte imagem:

Para o nosso tutorial, utilize a primeira opção. Faça o download do arquivo e garanta que você consegue acessá-lo sem problemas. Nós o utilizaremos ao final do tutorial para configurar o SSO na Plataforma Axur.

O Google precisa saber com quem ele estará se comunicando para que o processo de SSO funcione sem problemas. Siga as imagens para inserir os seguintes dados da Plataforma Axur nas configurações do Google Workspace.

Estes são os dados que você precisará (Estes valores são fixos e devem ser inseridos exatamente como mostrado):

Ao utilizar o Google Workspace como nosso provedor, estamos aproveitando as credenciais que já estão salvas e gerenciadas pelo Google, e essas credenciais estão salvas no formato que o provedor definiu. No entanto, para se comunicar com a Plataforma Axur utilizando SAML, é necessário que os dados do usuário sejam enviados de uma forma padronizada. Pense da seguinte forma: precisamos garantir que a Plataforma Axur sempre receba o atributo de e-mail do usuário no mesmo formato, independentemente se esse dado vem do Google ou de qualquer outro provedor. Diferentes provedores salvam seus dados de diferentes formas, e os mapeamentos resolvem esse problema!

Utilize o passo a passo nas imagens para adicionar os mapeamentos de atributos de usuário na sua aplicação do Google Workspace.

Os valores que você precisará preencher estão aqui:

Assim como os atributos de usuário, também temos os grupos, que reúnem os usuários de acordo com algum critério específico. Esses grupos são criados pelo administrador no Google Workspace e, como explicado na seção anterior, é necessário que exista um mapeamento para que esse dado seja transmitido para a Plataforma Axur de forma padronizada, independentemente do provedor.

Nesta seção, o foco é pegar cada um dos grupos que você criou na seção Grupos, usuários e atribuições e dizer para o Google Workspace como esses nomes de grupos devem ser mapeados no momento do envio para a Plataforma Axur.

Siga as imagens para criar os mapeamentos de grupos nas configurações do Google Workspace (utilize o valor que segue para preencher o lado direito):

http://schemas.xmlsoap.org/claims/Group

Você pode adicionar quantos grupos quiser aqui. No exemplo, adicionamos apenas one-viewer, mas você poderia inserir quantos desejar. No final, todos esses grupos estariam sob o mesmo atributo de grupo que definimos!

Ao final do processo de mapeamento de atributos de grupos e usuários, verifique se a sua aplicação está como a da foto abaixo:

Agora só falta atribuir usuários ou grupos à nova aplicação que você criou. Siga o passo a passo nas imagens para fazer isso:

Caso você tenha decidido por criar grupos via provedor, selecione os grupos criados e verifique se eles estão ativos na aplicação. Feito isso, todos os usuários participantes desses grupos terão acesso à aplicação. Caso você tenha decidido por não criar grupos via provedor, você pode habilitar a aplicação para uma Organizational Unit (OU). Isso permite que todos os usuários dentro daquela OU tenham acesso à aplicação, sem a necessidade de criar grupos.
​

O Google Workspace possui uma página de suporte que contém alguns dos erros mais comuns durante a criação de uma aplicação SAML. Você pode acessar essa página clicando aqui. Em geral, em caso de erros, tente sempre verificar:

Isso conclui as configurações necessárias no provedor Google Workspace. Retorne ao guia de configuração na plataforma para finalizar a criação da sua aplicação.