Logon único (SSO)

1º Passo: Crie um subdomínio no Clockify #

Para obter mais informações, consulte a seção Configurando um subdomínio personalizado.

2º Passo: Crie o aplicativo no Okta #

1. Vá para Aplicativos na barra lateral
2. Clique no botão Criar integração do aplicativo
3. Choose SAML 2.0 in modal
4. Clique em Avançar

Criar integração SAML 2.0 #

No formato de Configurações gerais insira as seguintes informações e clique em Avançar:

• Nome do aplicativo: ex.: Clockify
• Logo: por exemplo baixe o logotipo do Clockify

Em Configurar SAML insira as seguintes informações:

• URL de logon único (ou ACS) – URL específica para qual as asserções SAML do Okta devem ser enviadas (ex.: https://global.api.clockify.me/auth/saml2)
• Audiência URI (ID da entidade no seu aplicativo): Identificador exclusivo do seu app personalizado; o mesmo que o ID da entidade no campo de autenticação SAML (ex.: https://yoursubdomainname.clockify.me)
• Estado de Retransmissão Pré Definido: autenticação iniciada por IdP para que os usuários possam fazer login no Clockify diretamente do painel Okta

Exemplo de Estado de Retransmissão Pré Definido:

{"location":"https://yourcompanysubdomain.clockify.me", "organizationName":"yourcompanysubdomain"}

Certifique-se de colocar aspas retas em vez de curvilíneas, ou não funcionará.

Deixe tudo como está e clique em Avançar.

Em Feedback, marque Sou um cliente da Okta e estou adicionando um aplicativo interno e clique em Concluir.

Você deve ver uma tela assim:

Como etapa final nesta seção, clique no botão Exibir instruções de configuração exibido na captura de tela acima.

Em Como configurar SAML 2.0 para o aplicativo Clockify, você obterá uma lista de dados necessários para configurar seu aplicativo Clockify.

3º Passo: Adicione configuração de SSO ao Clockify #

Agora, no Clockify, na tela Autenticação:

1. Clique em Adicionar configuração SSO na parte inferior da tela
2. Escolha SAML2 como tipo de autenticação
3. Escolha Okta como modelo de IdP

O formulário de autenticação SAML2 é exibido:

Digite os seguintes dados:

• ID da entidade (URI de audiência no Okta): ex.: https://yourcompanysubdomain.clockify.me
• URL de Metadados:
  • Voltar para Okta
  • Copie o link metadados do provedor de identidade da seção Configurações no Okta
  • Salvar como um arquivo .xml e carregue-o no Clockify
• URL de SSO SAML: copie/cole o URL de logon único do provedor de identidade do artigo Como configurar o SAML 2.0 para o aplicativo Clockify do Okta.

Por exemplo:

https://okta.ops.clockify.me/app/dev05335506_clockifytempsaml2_1/exk4erumfseHaalgs5d7/sso/saml

• Avançado: Copie/cole o Certificado X.509 do Okta

Finalmente, sua tela no Clockify deve se parecer com isto:

e

Depois de inserir todos os dados necessários, você pode optar por verificar sua configuração clicando no botão Testar configuração. Esta ação garante a veracidade das informações fornecidas. Se tudo estiver correto, o botão Testar configuração será substituído pelo botão Concluir configuração.

Clique em Concluir configuração para concluir o processo e ativar Fazer login com SAML2. Opcionalmente, desative Fazer login com e-mail e senha.

4º Passo: Atribuir o aplicativo no Okta #

Em Okta

1. Navegue até Aplicativos
2. Escolha Clockify
3. Na aba Atribuições clique em Atribuir
4. Escolha Atribuir a Pessoas/Grupos dependendo de quem em sua conta Okta você gostaria de permitir o acesso ao Clockify

E é isso! Agora você e os usuários do seu espaço de trabalho podem entrar nele com SAML2.

1º Passo: Crie um subdomínio no Clockify #

Para obter mais informações, consulte a seção Configurando um subdomínio personalizado.

2º Passo: Crie o aplicativo no OneLogin #

1. Navegue até Aplicativos
2. Clique em Adicionar aplicativo
3. Pesquise e escolha Conector personalizado SAML (avançado)
4. Informação:
   • Nome de exibição: Clockify
   • Logo: por exemplo carregar o logotipo do Clockify

Clique em Salvar e preencha a Configuração:

• Público-alvo: Clockify
• Destinatário: https://global.api.clockify.me/auth/saml2
• Validador de URL ACS (consumidor)**: ^https:\/\/global.api.clockify\.me\/auth\/saml2\/$
• URL ACS (Consumidor)**: https://global.api.clockify.me/auth/saml2
• URL de login: https://yourcompanysubdomain.clockify.me/
• Iniciador SAML: provedor de serviços
• Clique em Salvar para concluir o processo

3º Passo: Adicione configuração de SSO ao Clockify #

1. Clique em Adicionar configuração de SSO
2. Escolha SAML2 como tipo de autenticação
3. Selecione OneLogin como Modelo de IdP e preencha os seguintes campos
   • Público (ID da entidade): Clockify
   • URL de metadados: Vá para OneLogin > SSO e copie a URL do emissor e cole-a na URL de metadados no Clockify
   • URL de login: Copie/cole o ponto de extremidade SAML 2.0 (HTTP) da seção SSO no OneLogin

Em Avançado digite:

• Certificado: copie/cole o Certificado X.509 de Ver detalhes, SSO no OneLogin

4º Passo: Atribua o aplicativo no OneLogin #

Em OneLogin:

1. Vá para Usuários (é aqui que você escolhe quais usuários da sua conta OneLogin poderão acessar o Clockify).
2. Clique em um usuário específico
3. Em Aplicativos, clique no sinal + para adicionar um aplicativo
4. Escolha Clockify
5. Clique em Continuar e Salvar

No Clockify, após inserir todos os dados necessários, você pode optar por verificar sua configuração clicando no botão Testar configuração. Esta ação garante a veracidade das informações fornecidas. Se tudo estiver correto, o botão Testar configuração será substituído pelo botão Concluir configuração.

Clique em Concluir configuração para concluir o processo e ativar o Login com SAML 2.0. Opcionalmente, você pode desativar Fazer login com e-mail e senha.

E é isso! Agora você e os usuários do seu espaço de trabalho podem fazer login com o SAML 2.0.

Depois de mudar para o subdomínio, o login padrão do Google deixará de funcionar e você precisará configurá-lo manualmente para continuar a usá-lo.

Configurar o login do Google é rápido e fácil.

Você deve ter uma conta G Suite ou Cloud Identity para fazer isso.

Você precisará Configurar o OAuth 2.0 m sua conta do Google, criar um projeto e obter o ID do cliente OAuth 2.0 para um aplicativo da web.

No Google Cloud Platform navegue até API e serviços e escolha Credenciais. Abra o projeto/aplicativo que você criou e cole https://yoursubdomain.clockify.me/login em URIs de redirecionamento autorizados.

Você também deve adicionar os seguintes URIs para que o login OAuth funcione nos aplicativos móveis Clockify:

• https://app.clockify.me/login
• https://app.clockify.me/login/android/oauth2
• https://app.clockify.me/login/ios/oauth2

Redirecionamento regional #

Se você estiver usando servidores regionais para hospedagem, estes são os URLs disponíveis para redirecionamento regional:

Estados Unidos (EUA)

• Android: https://use2.clockify.me/en/login/android/oauth2 
• iOS: https://use2.clockify.me/en/login/ios/oauth2

Austrália (UA)

• Android: https://apse2.clockify.me/en/login/android/oauth2
• iOS: https://apse2.clockify.me/en/login/ios/oauth2

Europa (UE)

• Android: https://euc1.clockify.me/en/login/android/oauth2
• iOS: https://euc1.clockify.me/en/login/ios/oauth2 

Reino Unido (Reino Unido)

• Android: https://euw2.clockify.me/en/login/android/oauth2
• iOS: https://euw2.clockify.me/en/login/ios/oauth2

1. No Clockify, vá para a guia Autenticação
2. Clique em Configuração de SSO do anúncio
3. Escolha o tipo de autenticação OAuth2 
4. Escolha Google no modal Modelos de IdP
5. Clique em Avançar
6. Copie/cole o ID do cliente e o Segredo do cliente do seu Google app, conforme mostrado no exemplo abaixo (campos na seção Avançado >seção será pré-preenchida)

A tela do Clockify deve se parecer com isto:

e

Depois de inserir todos os dados necessários, você pode optar por verificar sua configuração clicando no botão Testar configuração. Esta ação garante a veracidade das informações fornecidas. Se tudo estiver correto, o botão Testar configuração será substituído pelo botão Concluir configuração.

Clique em Concluir configuração para concluir o processo. Marque a caixa de seleção Fazer login com OAuth para começar a usar o login do Google. Opcionalmente, você pode forçar todos a usarem a identidade Google da sua empresa para fazer login, desativando Fazer login com e-mail e senha.

Você pode conectar o Azure ao Clockify configurando o OAuth.

1º Passo: Crie um subdomínio no Clockify #

Para obter mais informações, consulte a seção Configurando um subdomínio personalizado.

2º Passo: Adicionar configurações de SSO no Clockify #

1. Clique em Adicionar configuração de SSO
2. Escolha OAuth2 como tipo de autenticação
3. Escolha Azure no modal Modelos IdP
4. Copiar URL de redirecionamento

3º Passo: Registrar o aplicativo no AzureAD #

1. Navegue até Registros de aplicativos
2. Clique em Novo registro
3. Digite as seguintes informações:
   • Informação:
     • Nome: Clockify
     • Tipos de conta com suporte- Selecione o que você prefere; no nosso caso, são Contas apenas neste diretório da organização (Somente Diretório Padrão - locatário)
     • URI de redirecionamento: cole o URL de redirecionamento que você copiou no 2º Passo; https://yourcompanysubdomain.clockify.me/login (também pode ser: https://app.clockify.me/login/ios /oauth2 ou https://app.clockify.me/ login/android/oauth2) e clique em Registrar para continuar

Ou, se estiver usando um dos servidores regionais, você deve adicionar um dos URLs regionais.

4º Passo: Configurar (Clockify e Azure) #

Configure AzureAD:  #

• Certificados e Segredos:
  • Escolha Novo segredo do cliente
    • Descrição: Clockify
    • Expira: Nunca
  • Clique em Adicionar
• Segredo do cliente: Copie/cole o valor do segredo deste cliente
• Permissões de API:
  • Adicionar uma permissão
    • Microsoft Graph
    • Verifique o openid em Permissões delegadas
    • Adicionar permissões (você pode verificar outras permissões como e-mail e perfil)
• Recarregue a página
• Volte para a Visão geral

Configure Clockify: #

• Autenticação OAuth2:
  • ID do cliente: Vá para Azure – Resumo – ID do aplicativo (cliente): copie o valor e cole-o no Clockify
  • Segredo do cliente: já deve estar colado dos passos anteriores (Certificados e Segredos)
  • ID do diretório (locatário): Vá para Azure -- Resumo -- ID do diretório -- Copie o valor e cole-o novamente no Clockify

Os campos na seção Avançado serão preenchidos previamente.

A tela do Clockify deve se parecer com isto:

e

Depois de inserir todos os dados necessários, você pode optar por verificar sua configuração clicando no botão Testar configuração. Esta ação garante a veracidade das informações fornecidas. Se tudo estiver correto, o botão Testar configuração será substituído pelo botão Concluir configuração.

Clique em Concluir configuração para terminar o processo. Marque a caixa Entrar com OAuth (e opcionalmente, desmarque Entrar com e-mail e senha).

Como alternativa, você pode se conectar ao Azure usando o protocolo de autenticação SAML2, primeiro adicionando um aplicativo não listado (não-galeria) à sua organização do Azure AD e em seguida configurando o logon único baseado em SAML para esse aplicativo não-galeria.

1º Passo: Crie um subdomínio no Clockify #

Para obter mais informações, consulte a seção Configurando um subdomínio personalizado.

2º Passo: Adicionar um aplicativo no Azur #

1. Navegue até Aplicativos Corporativos
2. Novo aplicativo (certifique-se de estar na nova visualização da galeria)
3. Escolha Criar seu próprio aplicativo
4. Digite os seguintes dados:
   • Nome: Clockify
   • Integrar qualquer outro aplicativo que não encontre na galeria

Clique em Criar e navegue até Propriedades e preencha os campos:

• Logo: por exemplo carregar o logotipo do Clockify
• Opcionalmente, altere a atribuição obrigatória do usuário e Visível para os usuários se necessário

Clique em Salvar para concluir o processo.

3º Passo: Clockify #

1. Clique em Adicionar configuração de SSO
2. Escolha SAML2 como tipo de autenticação
3. Clique em Avançar

Depois de obter o modelo de O formulário de autenticação SAML2 volte para o Azure.

4º Passo: Configurar Azure SSO #

1. Vá para Logon único na barra lateral
2. Escolha SAML
3. Configuração básica do SAML (clique no lápis para editar):
   • Identificador (ID da entidade): Aqui é onde você coloca o endereço do seu subdomínio, ex.: https://subdomainofyourcompany.clockify.me/
   • URL de resposta (URL de serviço do consumidor de asserção): volte para Clockify e copie o URL de resposta pré-gerado, por exemplo. https://global.api.clockify.me/auth/saml2

Clique em Salvar e continue com Certificado SAML: (clique no lápis para editar):

• Novo certificado

Salve as alterações e clique nos 3 pontos no certificado Inativo, escolha Tornar certificado ativo e clique em Sim.

Agora atualize a página para ver as alterações.

5º Passo: Clockify #

1. ID da entidade: (é aqui que você coloca o endereço do seu subdomínio, no nosso caso é https://subdomainofyourcompany.clockify.me/)
2. Metadados da Federação: navegue até o Azure, em Certificados SAML copie/cole Url de metadados da federação do aplicativo no Clockify

URL de login: navegue até o Azure, em Configurar Clockify encontre URL de login e copie/cole-o no Clockify

Sua tela deverá ficar assim:

e assim:

Depois de inserir todos os dados necessários, você pode optar por verificar sua configuração clicando no botão Testar configuração. Esta ação garante a veracidade das informações fornecidas. Se tudo estiver correto, o botão Testar configuração será substituído pelo botão Concluir configuração.

Clique em Concluir configuração e ative Fazer login com SAML2 (e opcionalmente desative Fazer login com e-mail e senha).

6º Passo: Atribuir o aplicativo no Azure #

1. Vá para Usuários e grupos na barra lateral (onde você pode escolher quais usuários da sua conta do Azure poderão acessar o Clockify)
2. Clique em Adicionar usuário/grupo
3. Em Usuários e grupos selecione os usuários que deseja
4. Clique em Selecionar e Atribuir

1º Passo: Crie um subdomínio no Clockify #

Para obter mais informações, consulte a seção Configurando um subdomínio personalizado.

2º Passo: Crie o aplicativo no Okta #

1. Vá para Aplicativos na barra lateral
2. Clique no botão Criar integração do aplicativo
3. Selecione OIDC – OpenID Connect na na seção Método de login
4. Selecione Aplicativo da Web na seção Tipo de aplicativo
5. Clique em Avançar

Crie a integração OIDC #

No formulário Nova integração de aplicativos da Web, Configurações gerais, insira as seguintes informações e clique em Salvar.

1. Nome da integração do aplicativo ex.: Clockify
2. Logo: por exemplo carregar o logotipo do Clockify
3. URIs de redirecionamento de login: Copie/cole o URL do URL de redirecionamento seção (Avançado) nas configurações de SSO do Clockify

Você também deve adicionar os seguintes URIs para que o login do OAuth 2.0 (OIDC) funcione em aplicativos móveis Clockify:

• https://app.clockify.me/login
• https://app.clockify.me/login/android/oauth2
• https://app.clockify.me/login/ios/oauth2

ou, se estiver usando um dos servidores regionais, você deve adicionar um dos URLs regionais.

Então, role para baixo e na seção Atribuições marque Permitir o acesso de todos os integrantes da sua organização. Clique em Salvar para concluir a ação.

Você deve ver uma tela assim:

3º Passo: Adicione configuração de SSO ao Clockify #

Agora, no Clockify, na tela Autenticação onde você criou seu subdomínio:

1. Clique em Adicionar configuração SSO na parte inferior da tela
2. Escolha OAuth2 como tipo de autenticação
3. Escolha Okta como modelo de IdP
4. Clique em Avançar

No formulário de autenticação OAuth 2.0 (OIDC), insira as seguintes informações:

• ID do Cliente: Gerado no Okta na etapa anterior; copie-o da seção de Credenciais do cliente .
• Segredo do cliente: Igual ao ID do cliente; copie-o da seção de Credenciais do cliente .
• Domínio Okta: copie-o do campo Okta, Configurações gerais, Domínio Okta (Observação: o domínio Okta requer apenas um nome de domínio, por exemplo: doamin_name.okta.com em vez de: https://domain_name.okta.com)
• A seção Avançado é pré-preenchida (gerada automaticamente)

A tela deve ser semelhante a esta:

e

4º Passo: Atribuir o aplicativo no Okta #

Em Okta

1. Navegue até Aplicativos
2. Escolha Clockify
3. Na aba Atribuições clique em Atribuir
4. Escolha Atribuir a Pessoas/Grupos dependendo de quem em sua conta Okta você gostaria de permitir o acesso ao Clockify

Depois de inserir todos os dados necessários, no lado do Clockify, você pode optar por verificar sua configuração clicando no botão Testar configuração. Esta ação garante a veracidade das informações fornecidas. Se tudo estiver correto, o botão Testar configuração será substituído pelo botão Concluir configuração.

Clique em Concluir configuração para concluir o processo e ativar o Login com OAuth. Opcionalmente, você pode desativar Fazer login com e-mail e senha.

Finalmente, sua tela no Clockify deve se parecer com isto:

E é isso! Agora você e os usuários do seu espaço de trabalho podem fazer login no seu espaço de trabalho com o OAuth 2.0 (OIDC).