Configuração do SSO da Microsoft Azure

​

Configurar o SSO através do Azure

• Privilégios de Administrador numa conta CloudTalk
• Privilégios de Administrador numa conta Microsoft Azure

​

Passos no Dashboard da CloudTalk

1. As definições do SSO têm de ser ajustadas por um administrador através do Dashboard. Na barra lateral esquerda, clique em Conta -> Definições. Ao escolher o cabeçalho Início de sessão único, poderá ver as opções de SSO disponíveis sob a forma de botões de alternância.
   
2. Os administradores podem alternar entre Ligado/Desligado para ativar ou impor:
   • Google SSO
   • Azure SSO
   • Okta SSO
   • Keycloak SSO
   • Onelogin SSO
   
   Clique no botão de alternância para Ativar SSO Azure.
3. Assim que o SSO Azure estiver ativado, será pedido ao administrador que preencha os seguintes valores:
   • ID do Cliente
   • Segredo do consumidor
   • URL de Descoberta (por vezes designado «Resource/Issuer URL»)
     For Azure, the Discovery URL format will be: 
     
     https://login.microsoftonline.com/{tenant}/v2.0
     
     Where {tenant} is to be replaced with the admin user's actual tenant ID, which can be found via the Azure Portal
     
   • Método (GET ou POST)
   
4. Além disso, será necessário introduzir um «redirect URI» num campo adequado da interface do respetivo fornecedor de identidade — neste caso, o Azure. Nos passos seguintes, os utilizadores terão de iniciar sessão no seu Azure Portal a partir de um separador diferente, para obter os valores indicados acima e introduzir o redirect URI, necessário para que a autorização funcione corretamente.
   For all identity providers, including Azure, the redirect URIs will be the following:
   
   https://authsso.cloudtalk.io/oauth2/idpresponse
   
   https://cloudtalk-prod.auth.eu-central-1.amazoncognito.com/oauth2/idpresponse
   

​

Passos no Azure Portal

1. Como primeiro passo, inicie sessão na sua conta Microsoft Azure e certifique-se de que começa no Azure Portal, alojado em portal.azure.com. Na página inicial verá uma lista de ícones sob o cabeçalho Azure services. Clique no ícone em forma de pirâmide com o nome Azure Active Directory.
   
2. Entre os separadores listados à esquerda, selecione App registrations. Se ainda não o tiver feito, terá de clicar em + New Registration para adicionar a CloudTalk como novo registo de aplicação.
   
3. Introduza um nome para a aplicação (CloudTalk) e selecione uma opção em Who can use this application or access this API.
   
   Introduza os Redirect URIs da CloudTalk:
   https://authsso.cloudtalk.io/oauth2/idpresponse
   
   https://cloudtalk-prod.auth.eu-central-1.amazoncognito.com/oauth2/idpresponse
   
   
   *Importante*: Altere a opção da lista pendente à esquerda de Public client/native (apresentada) para Web. Clique no botão azul Register para registar a CloudTalk como aplicação.
4. Caso precise de adicionar ou alterar o Redirect URI depois de a aplicação CloudTalk já estar registada, pode fazê-lo clicando no texto azul junto a Redirect URIs, no separador Overview do diretório da aplicação registada da CloudTalk.
   
5. Assim que a CloudTalk estiver registada e o Redirect URI adicionado, podemos obter os restantes valores que terão de ser introduzidos durante a configuração no Dashboard da CloudTalk. Guarde estes valores num local seguro ou mantenha a CloudTalk aberta noutro separador para os copiar e colar diretamente.
6. O ID do Cliente refere-se, neste caso, ao Application Client ID, visível no separador App Registrations, mesmo ao lado do Display name do registo da CloudTalk.
   
   Também pode ser encontrado depois de clicar no diretório da aplicação registada da CloudTalk, no separador Overview.
   
7. Terá de ser criado um novo Segredo do consumidor, caso ainda não o tenha feito. No separador App Registrations do Azure, clique no registo da CloudTalk, que deverá estar realçado a azul, como uma ligação. Na página de descrição geral do Azure relativa ao diretório da aplicação da CloudTalk, pode clicar na opção Add a certificate or secret, junto ao descritor Client Credentials .
   
   Outra opção é ir aos separadores do lado esquerdo e selecionar Certificates & secrets. Ambos os caminhos conduzem à mesma página, onde serão apresentados os certificados que já tenhamos gerado.
   
   Para gerar um novo segredo do consumidor, certifique-se de que se encontra sob o cabeçalho Client secrets e clique no ícone + New Client Secret.
8. Introduza uma Description e uma data de validade para o código de autenticação.
   
   Clique em Adicionar.
   
9. Tenha em atenção que a parte do Segredo do consumidor que precisa de copiar é o código da coluna Value, como se mostra abaixo.
   
10. Por último, mas não menos importante, precisamos de obter o URI de Descoberta, que não deve ser confundido com o redirect URI que utilizámos anteriormente. No caso do Azure, o URI de descoberta deve ter o seguinte formato:
    https://login.microsoftonline.com/{tenant}/v2.0
    
    Há algumas formas de construir este URI com o ID de tenant correto. O método preferido, por ser mais rigoroso, é utilizar exatamente o formato acima e substituir {tenant} pelo ID de tenant real, que pode ser encontrado fora do diretório da aplicação CloudTalk, nos separadores Overview ou Properties, ou dentro do diretório da aplicação CloudTalk, no separador Overview.
    
    Vista do diretório predefinido
    
    No diretório da aplicação registada da CloudTalk

​

Passo adicional na CloudTalk.io

1. Um último valor que teremos de introduzir nos campos **Dashboard->Conta->Definições->Início de sessão único relativos ao Azure é o Método. POST é a opção aconselhada entre GET e POST, embora, no caso do Azure, o método seja normalmente indiferente — se a configuração com POST não funcionar, experimente GET.