Extras

Clockify centre d’aide Extras Authentification unique (SSO)

Authentification unique (SSO)

La fonctionnalité d'authentification unique (ci-après SSO) offre une sécurité à grande échelle en éliminant les mots de passe es utilisateurs, en contrôlant l'accès et en gérant les informations de connexion en utilisant l'IdP de votre entreprise via SAML et OAuth (Office 365, Okta, Azure, Active Directory, Google, OneLogin...).

Il s'agit d'une fonctionnalité supplémentaire, que vous pouvez activer en mettant à niveau votre espace de travail vers le plan Entreprise.

En fonction du type d'hébergement, il y a différentes façons de la configurer dans Clockify :

Auto-hébergement #

Si vous hébergez Clockify vous-même, vous configurez le SSO dans votre panneau d'administration. Il est activé dans tous les espaces de travail.

Hébergement Cloud #

Afin d'utiliser le SSO, vous devez d'abord déplacer votre espace de travail vers un sous-domaine. Après cela, vous pouvez ajouter la configuration SSO et désactiver les autres formes de connexion.

Mise en place d'un sous-domaine personnalisé #

Déplacement vers un sous-domaine #

Avant de pouvoir configurer et commencer à utiliser le SSO pour l'autorisation, vous devez déplacer votre domaine Clockify appli vers un sous-domaine personnalisé.

Lorsque vous passez votre abonnement Clockify au plan Entreprise, vous obtenez un onglet Authentication dans les Paramètres de l'espace de travail. Vous pourrez y entrer le sous-domaine que vous souhaitez utiliser et y déplacer votre espace de travail.

Pour configurer un sous-domaine :

  1. Accédez à l'onglet Authentication dans les Paramètres de l'espace de travail
  2. Saisissez votre sous-domaine personnalisé dans le champ prévu à cet effet
  3. Cliquez sur Créer un sous-domaine et Créer pour confirmer l'action

Après avoir créé votre sous-domaine et y avoir déplacé votre espace de travail, la connexion Google ne fonctionnera plus pour vous et vos utilisateurs.

Si vous souhaitez toutefois utiliser la connexion Google, vous devez la mettre en place manuellement en configurant OAuth2 pour le SSO.

Pour plus d'informations à ce sujet, consultez la section Configuration de la connexion Google ci-dessous.

Vos utilisateurs peuvent configurer leur mot de passe en demandant la réinitialisation du mot de passe à partir de Mot de passe oublié.

Accéder à Clockify depuis un sous-domaine #

Après avoir créé votre sous-domaine, vous serez automatiquement déconnecté de toutes les applications auxquelles vous étiez connecté avec votre compte Clockify. Vous n'y aurez accès qu'à travers le sous-domaine que vous avez créé (p. ex. https://yourcompanysubdomain.clockify.me/login).

Espaces de travail sur le sous-domaine #

Le sous-domaine est lié à un seul espace de travail. Les utilisateurs d'un sous-domaine ne peuvent pas avoir plusieurs espaces de travail : ils n'ont pas de sélecteur d'espace de travail, n'ont pas d'espace de travail dans la barre latérale, et ne peuvent pas accéder à l'espace de travail du sous-domaine depuis le domaine principal.

Si vous avez plusieurs espaces de travail, vous devez vous connecter au domaine principal de Clockify afin d'y accéder.

Changement de sous-domaine #

Vous pouvez changer l'URL du sous-domaine à tout moment.

Lorsque vous modifiez une URL, tout le monde sera déconnecté et devra utiliser l'espace de travail via la nouvelle URL.

Si vous annulez l'abonnement au plan Entreprise :

  • vous serez replacé sur le domaine principal à l'expiration de l'abonnement
  • votre sous-domaine deviendra disponible pour d'autres personnes
  • vos utilisateurs devront se connecter avec leur adresse email et leur mot de passe

Clés API sur les sous-domaines #

Pour des raisons de sécurité, chaque utilisateur d'un sous-domaine reçoit une clé API distincte qui ne fonctionne que pour cet espace de travail. En d'autres termes, personne ne peut accéder à vos données sur le sous-domaine à moins de disposer de l'autorisation appropriée.

Si, par exemple, vous avez un utilisateur avec deux espaces de travail Entreprise distincts, les propriétaires de ces espaces de travail ne peuvent pas voir ou obtenir les données de leurs comptes respectifs.

Inviter de nouveaux utilisateurs #

Une fois que vous êtes dans l'espace de travail du sous-domaine, vous pouvez inviter les utilisateurs un par un en utilisant l'email (comme auparavant), ou laisser n'importe qui se joindre sans avoir à les inviter manuellement.

Pour permettre à quiconque de se joindre à vous, cochez la case Les utilisateurs peuvent se joindre sans invitation.

Si vous utilisez le SSO et qu'une personne sans compte se connecte, un compte sera automatiquement créé pour elle et elle sera connectée.

Si vous autorisez l’option Se connecter avec l'adresse email et le mot de passe, les utilisateurs pourront créer un compte et rejoindre automatiquement votre espace de travail.

Configuration du SSO #

L'application Android a été migrée du domaine clockify.me vers le sous-domaine app.clockify.me. Par conséquent, toutes les configurations SSO supportées par Clockify, doivent également contenir des liens vers app.clockify.me. Par exemple, dans la section URL de redirection ajoutez le lien https://app.clockify.me/login/android/oauth2 de fin https://clockify.me/login/android/oauth2 .

Clockify supporte tous les principaux fournisseurs d'identité SSO :

Seul le propriétaire de l'espace de travail peut voir l'ongle Autorisation , gérer le sous-domaine, configurer le SSO et activer/désactiver le SSO.

Si vous souhaitez obliger tout le monde à se connecter avec le SSO, décochez la case Se connecter avec l'adresse email et le mot de passe. Une fois cette modification enregistrée, tous les mots de passe associés aux comptes de vos membres ne fonctionneront plus et il leur sera demandé d'utiliser le SSO.

Vous pouvez toujours modifier les informations ou supprimer la configuration (dans ce cas, les personnes devront se connecter à l'aide de l'email et du mot de passe).

Le propriétaire peut toujours se connecter en utilisant l'email et le mot de passe d'origine à l'adresse https://mysubdomain.clockify.me/login-owner

Pour ajouter l'État de relais par défaut, utilisez les paramètres ci-dessous.

Veillez à utiliser des guillemets droits au lieu des crochets, sinon cela ne fonctionnera pas.

Exemple d'état de relais par défaut :

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

SAML2 with Okta #

L'interface utilisateur présentée dans cette vidéo peut ne pas correspondre à la dernière version de l'appli.

Étape 1 : Création d'un sous-domaine dans Clockify #

Pour plus d'informations à ce sujet, consultez la section Mise en place d'un sous-domaine personnalisé.

Étape 2 : Créer une application dans Okta #

  1. Naviguez vers Applications dans la barre latérale
  2. Cliquez sur le bouton Créer une intégration d'application
  3. Choisissez SAML 2.0 dans la modale
  4. Cliquez sur Suivant

Créer l'intégration SAML #

Dans le formulaire Paramètres généraux , entrez les informations suivantes et cliquez sur Suivant

  • Nom de l'appli: ex. Clockify
  • Logo: p. ex. télécharger le logo Clockify

Dans Configurer SAML , entrez les informations suivantes :

  • URL d'authentification unique (ou ACS) : URL spécifique à laquelle les assertions SAML d'Okta doivent être envoyées (p. ex. https://global.api.clockify.me/auth/saml2)
  • URI de l'audience (ID de l'entité dans votre application) : Identificateur unique de votre application personnalisée ; identique à l'ID de l'entité dans le champ d'authentification SAML (p. ex. https://yourcompanysubdomain.clockify.me)
  • l'État de relais par défaut: Authentification initiée par l'IDP afin que les utilisateurs puissent se connecter à Clockify directement depuis le tableau de bord Okta

Exemple d'État de relais par défaut :

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

Veillez à mettre des guillemets droits au lieu des crochets, sinon cela ne fonctionnera pas.

Laissez tout le reste tel quel et cliquez sur Suivant.

Dans Feedback, cochez Je suis un client Okta qui ajoute une application interne et cliquez sur Terminer.

Vous devriez obtenir un écran qui ressemble à ceci :

Comme dernière étape de cette section, cliquez sur le bouton Afficher les instructions d’installation (voir la capture d'écran ci-dessus).

Dans Comment configurer SAML 2.0 pour l'application Clockify, vous obtiendrez la liste des données dont vous avez besoin pour configurer votre application Clockify.

Étape 3 : Ajouter la configuration SSO dans Clockify #

Maintenant, dans Clockify, dans l'écran Authentification où vous avez créé votre sous-domaine :

  1. Cliquez sur Configurer le SSO en bas de l'écran
  2. Choisissez SAML2 comme type d'authentification
  3. Choisissez Okta comme modèle IdP

Le formulaire d'authentication SAML2 apparaît :

Saisissez les éléments suivants :

  • Id d’entité (URI d'audience dans Okta) : p. ex. https://yourcompanysubdomain.clockify.me
  • Url de métadonnées:
    • Retournez sur Okta
    • Copiez le lien du fournisseur d'identité des métadonnées depuis la section Paramètres dans Okta
    • Sauvegardez-le en tant que fichier .xml et téléchargez-le sur Clockify
  • SAML SSO URL : Copier/coller l'URL de l'authentification unique du fournisseur d'identité depuis Okta intitulé Comment configurer SAML 2.0 pour l'application Clockify

Par exemple :

https://okta.ops.clockify.me/app/dev05335506_clockifytempsaml2_1/exk4erumfseHaalgs5d7/sso/saml
  • Avancé : Copier/coller le certificat X.509 depuis Okta

Enfin, votre écran dans Clockify devrait ressembler à quelque chose comme ceci :

et

Cliquez sur Terminer la configuration pour terminer le processus et activer la Connexion avec SAML2. En option, désactivez l'option Se connecter avec l'adresse email et le mot de passe.

Étape 4 : Attribuer l'application dans Okta #

Dans Okta :

  1. Naviguez vers Applications
  2. Choisissez Clockify
  3. Dans l'onglet Tâches, cliquez sur Attribuer
  4. Choisissez Attribuer à des personnes/groupes en fonction des personnes de votre compte Okta à qui vous souhaitez donner accès à Clockify

Et c'est tout ! Vous et les utilisateurs de votre espace de travail pouvez maintenant vous connecter à votre espace de travail avec SAML2.

SAML2 avec OneLogin #

L'interface utilisateur présentée dans cette vidéo peut ne pas correspondre à la dernière version de l'appli.

Étape 1 : Création d'un sous-domaine dans Clockify #

Pour plus d'informations à ce sujet, consultez la section Mise en place d'un sous-domaine personnalisé.

Étape 2 : Créer l'application dans OneLogin #

  1. Naviguez vers Applications
  2. Cliquez sur Ajouter l’appli
  3. Recherchez et choisissez SAML Connecteur personnalisé (Avancé)
  4. Info:
    • Nom d'affichage: Clockify
    • Logo: p. ex. télécharger le logo Clockify

Cliquez sur Enregistrer et remplissez la Configuration :

  • Audience: Clockify
  • Destinataire: https://global.api.clockify.me/auth/saml2
  • Valideur d'URL ACS (consommateur)*: ^https:\/\/global.api.clockify\.me\/auth\/saml2\/$
  • URL de l'ACS (consommateur)*: https://global.api.clockify.me/auth/saml2
  • URL de connexion: https://yourcompanysubdomain.clockify.me/
  • Initiateur SAML: Prestataire de services
  • Cliquez sur Enregistrer pour terminer le processus

Étape 3 : Ajouter la configuration SSO dans Clockify #

  1. Cliquez sur Configurer SSO
  2. Choisissez SAML2 comme type d'authentification
  3. Choisissez OneLogin comme modèle IdP et remplissez les champs suivants
    • Audience ( Id de l'entité) : Clockify
    • Url de métadonnées : Allez dans OneLogin > SSO et copier l'URL de l'émetteur puis collez-la dans l'Url des métadonnées de Clockify
    • Url de connexion: Copier/coller SAML 2.0 Endpoint (HTTP) de la section SSO dans OneLogin

Dans Avancé entrez :

  • Certificate : Copier/coller le certificat X.509 de la section Afficher les détails, SSO dans OneLogin.

Étape 4 : Attribuer l'application dans OneLogin #

Dans OneLogin :

  1. Naviguez vers Utilisateurs (c'est ici que vous choisissez quels utilisateurs de votre compte OneLogin pourront accéder à Clockify)
  2. Cliquez sur l'utilisateur spécifique
  3. Dans Applications, cliquez sur le signe + pour ajouter une application
  4. Choisissez Clockify
  5. Cliquez sur Continuer et Enregistrer

Dans Clockify, cliquez sur Terminer la configuration pour terminer le processus et activer la Connexion avec SAML 2.0. En option, vous pouvez désactiver l’option Se connecter avec l'adresse email et le mot de passe.

Et c'est tout ! Vous et les utilisateurs de votre espace de travail pouvez maintenant vous connecter à votre espace de travail avec SAML 2.0.

SAML2 with Google #

Étape 1 : Création d'un sous-domaine dans Clockify

Pour plus d'informations, voir comment définir le sous-domaine.

Clockify : 

  1. Navigate to the Authentication tab 
  2. Choisissez Ajouter une configuration SSO
  3. Choisissez SAML2 comme fournisseur d'identité dans la fenêtre Type d'authentification
  4. Cliquez sur Suivant 
  5. Choisissez Google comme modèle IdP

Step 2: Create application in Google  #

Google:

  1. Create Google account and go to the Admin page 
  2. Choose Add custom SAML app in Add app
  3. Insert the following
    – Nom de l'appli: par ex. https://yourcompanysubdomain.clockify.me/
    – Description: e.g. Clockify SAML2 demo app
    – App icon: optionally add icon
  4. Cliquez sur Continuer 
  5. You’ll proceed to the Google Identity Provider details screen
    Google side:
  6. Download IdP metadata URL and upload it to Clockify/IdP Metadata URL field
  7. Copy SSO URL and paste it to Login URL field in Clockify
    Clockify side:
  8. Cliquez sur Continuer
  9. You’ll proceed to Service provider details
  10. Insert the following:
    – ACS URL: Copy/paste URL de réponse from Clockify, e.g. https://global.api.clockify.me/auth/saml2
    – Entity ID: Unique identifier of your custom application, e.g. Clockify
    – Start URL: Copy/paste l'État de relais par défaut de Clockify, par ex. 

{“location”:”https://yourcompanysubdomain.clockify.me”,”organizationName”:”yourcompanysubdomain”, “appName”: “WEB”}


  1.  Cliquez sur Continuer
  2. You’ll proceed to the Attribute mapping screen
  3. Cliquez sur Terminer pour terminer le processus

Now that you’ve completed all the steps and created the app, open the app’s settings and in Service status enable the app for everyone.

The app you created will appear in the Google workspace for all the users of that workspace.   

SAML2 avec Rippling #

Étape 1 : Création d'un sous-domaine dans Clockify #

Pour plus d'informations à ce sujet, consultez la Configurer un sous-domaine personnalisé.

Étape 2 : Créer une application dans Rippling #

  1. Connectez-vous à Rippling en tant qu'administrateur
  2. Sélectionnez Gestion informatique
  3. Sélectionnez Application personnalisée
  4. Donnez un nom descriptif à l'application, sélectionnez une catégorie et importez un logo
  5. Vérifiez L'authentification unique (SAML) 
  6. Cliquez sur Continuer
  7. Confirmez que vous êtes l'administrateur de l'application

Une nouvelle page contenant des instructions SSO s'ouvre et vous pouvez passer à l'étape suivante. La page contient des Instructions de configuration SSO qui incluent le fichier XML de métadonnées IdP.

Téléchargez les métadonnées IDP de Rippling.

Étape 3 : Ajouter la configuration SSO dans Clockify #

Dans la section Authentification dans laquelle vous avez créé votre sous-domaine :

  1. Cliquez sur Ajouter une configuration SSO
  2. Choisissez SAML2 comme type d'authentification et cliquez sur Suivant
  3. Choisissez Rippling comme modèle IdP

Dans le formulaire d'authentification SAML2 qui s'affiche, saisissez les informations suivantes :

  • l'ID de l'entité (ID d'entité du fournisseur de services dans Rippling): par ex. https://yourcompanysubdomain.clockify.me
  • Url de métadonnées: importez le fichier XML des métadonnées IdP téléchargé à l'étape 2
  • Url de connexion : Copiez/collez l'URL dess métadonnées de l'IdP à partir de Rippling

Cliquez sur Terminer la configuration pour terminer le processus et activer la Connexion avec SAML2. En option, désactivez l'option Se connecter avec l'adresse email et le mot de passe.

Étape 4 : Attribuer une application dans Rippling #

Retournez sur Rippling :

Sur la page des instructions SSO, faites défiler vers le bas et entrez ce qui suit : 

  • URL ACS : Copiez/collez l'URL de réponse de Clockify
  • ID de l'entité du prestataire de services : Copiez/collez l'ID de l'entité à partir de Clockify 
  1. Cliquez sur Passer à l'étape suivante 
  2. Choisissez les Règles d'accès souhaitées
  3. Choisissez l'Heure de mise à disposition souhaitée
  4. Configurez le SSO pour les administrateurs si nécessaire 
  5. Configurez les attributs de groupe si nécessaire
  6. Cliquez sur Se connecter via Rippling si vous souhaitez vérifier la connexion entre les applis ou simplement sur Continuer

Et c'est tout ! Vous avez installé avec succès votre application dans rippling et vous et vos utilisateurs êtes maintenant en mesure de vous connecter à votre espace de travail avec SAML 2.0.

SAML2 avec JumpCloud #

Étape 1 : Création d'un sous-domaine dans Clockify #

Pour plus d'informations à ce sujet, consultez la Configurer un sous-domaine personnalisé.

Étape 2 : Ajouter la configuration SSO dans Clockify  #

Dans la section Authentification dans laquelle vous avez créé votre sous-domaine :

  1. Cliquez sur Ajouter une configuration SSO
  2. Choisissez SAML2 comme type d'authentification et cliquez sur Suivant
  3. Choisissez JumpCloud comme modèle IdP

Étape 3 : Créer une application dans JumpCloud #

  1. Naviguez vers Authentification unique (SSO) dans la barre latérale à gauche
  2. Cliquez sur + pour ajouter une nouvelle application
  3. Choisissez Application SAML personnalisée
  4. Dans Information sur l'application entrez ce qui suit :
  • Libellé d'affichage: Nom de l'application, par ex. Clockify
  • Logo: p. ex. télécharger le logo Clockify

Dans l'onglet SSO, vous pouvez passer à l'étape suivante. La page contient les Instructions de configuration SSO qui incluent le fichier XML des métadonnées IdP. Téléchargez les métadonnées IDP de JumpCloud et sauvegardez-les pour plus tard.

Continuez en remplissant les champs suivants.

Exemple d'état de relais par défaut :

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

Veillez à mettre des guillemets droits plutôt que des guillemets frisés, sinon cela ne fonctionnera pas.

  1. Dans Mappage des attributs utilisateur ajoutez le mappage d'attributs Nom d'attribut du fournisseur de services vers Nom d'attribut de JumpCloud 
  2. Cliquez sur Activer
  3. Ouvrez l'application que vous avez créée
  4. Cliquez sur l'onglet Certificat IDP Valide à gauche et téléchargez le certificat
  5. Cliquez sur Enregistrer

Vous avez réussi à créer votre application dans JumpCloud. Vous pouvez maintenant décider quels utilisateurs de votre compte JumpCloud pourront accéder à Clockify et terminer la configuration dans Clockify.

Étape 4 : Terminez la configuration du SSO dans Clockify #

  1. Retournez sur Clockify
  2. Dans Le formulaire d'authentification SAML2 entrez les informations suivantes :
  • ID de l'entité IdP: par ex. https://yourcompanysubdomain.clockify.me
  • Url de métadonnées: importez le fichier XML des métadonnées IdP téléchargé à l'étape 3
  • IdP Url: Copiez/collez l'URL de l'IDP depuis JumpCloud
  • Avancé: Copiez/collez le certificat IDP de JumpCloud

Cliquez sur Terminer la configuration pour terminer le processus et activer la Connexion avec SAML2. En option, désactivez l'option Se connecter avec l'adresse email et le mot de passe.

Connexion Google #

Lorsque vous passez à un sous-domaine, la connexion Google par défaut cesse de fonctionner et vous devez la configurer manuellement pour continuer à l'utiliser.

La configuration de l'identifiant Google est simple et rapide.

Pour y arriver, vous devez disposer d'un compte G Suite ou Cloud Identity .

Vous devez configurer OAuth 2.0 dans votre compte Google, créer un projet et obtenir l'ID client OAuth 2.0 pour une application Web.

Dans Google Cloud Platform naviguez vers API & Services et choisissez Identifiants. Ouvrez le projet/l'application que vous avez créé et collez https://yoursubdomain.clockify.me/login sous URI de redirection autorisées.

Vous devez également ajouter les URIs suivants pour que la connexion OAuth fonctionne sur les applications mobiles Clockify :

Redirection régionale #

If you’re using regional servers for hosting, these are the URLs available for regional redirection:

États-Unis (US)

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

Australie (AU)

Europe (EU)

Royaume-Uni (UK)

  1. Dans Clockify, allez dans l'onglet Authentication et cliquez sur Configurer le SSO
  2. Choisissez le type d'authentification OAuth2
  3. Choisissez Google dans la fenêtre modale Modèles IdP Templates
  4. Cliquez sur Suivant
  5. Copiez/collez Client ID et Client Secret depuis votre Appli Google comme indiqué dans l'exemple ci-dessous (les champs de la section Avancé sont préremplis).

Votre écran dans Clockify devrait ressembler à ceci :

et

Cliquez sur Terminer la configuration pour achever le processus. Cochez la case Se connecter avec OAuth pour commencer à utiliser la connexion Google. Vous pouvez également obliger tout le monde à utiliser l'identité Google de votre entreprise pour se connecter en désactivant l'option Se connecter avec l'adresse email et le mot de passe.

OAuth avec Microsoft Azure #

L'interface utilisateur présentée dans cette vidéo peut ne pas correspondre à la dernière version de l'appli.

Vous pouvez connecter Azure à Clockify en configurant OAuth.

Étape 1 : Création d'un sous-domaine dans Clockify #

Pour plus d'informations à ce sujet, consultez la section Mise en place d'un sous-domaine personnalisé.

Étape 2 : Ajouter la configuration SSO dans Clockify #

  1. Cliquez sur Configurer SSO
  2. Choisissez OAuth2 comme type d'authentification
  3. Choisissez Azure dans la fenêtre modale Modèles IdP
  4. Copiez l'URL de redirection

Étape 3 : Enregistrer l'application dans AzureAD #

  1. Naviguez vers les Enregistrements d'applications
  2. Cliquez sur Nouvelle inscription
  3. Entrez les informations suivantes :
    • Info:
      • Nom: Clockify
      • Types de comptes supportésChoisissez ce que vous préférez ; dans notre cas, il s’agit de Comptes dans cet annuaire organisationnel uniquement (Annuaire par défaut seulement - monolocataire)
      • Rediriger l'URI: Collez ce que vous avez copié à l'étape 2 ; https://yourcompanysubdomain.clockify.me/login (cela peut aussi être : https://app.clockify.me/login/ios/oauth2 ou https://app.clockify.me/login/android/oauth2) et cliquez sur Enregistrer pour continuer

Vous devez également ajouter les URIs suivants pour que la connexion OAuth fonctionne sur les applications mobiles Clockify : https://app.clockify.me/login/ios/oauth2 et https://app.clockify.me/login/android/oauth2 

ou, si vous utilisez l'un des serveurs régionaux, vous devez ajouter l'une des URL régionales.

Étape 4 : Configuration (Clockify & Azure) #

Configurer AzureAD :  #

  • Certificats et Secrets:
    • Choisissez Nouveau client secret
      • Description : Clockify
      • Expire : Jamais
    • Cliquez sur Ajouter
  • Clé secrète client: Copiez/collez la valeur du client secret
  • Autorisations API:
    • Ajouter une autorisation
      • Microsoft Graph
      • Vérifier l'openid dans les Autorisations déléguées
      • Ajouter des autorisations (vous pouvez également vérifier d'autres autorisations telles que l'email et le profil)
  • Rafraîchissez la page
  • Retournez à l'aperçu

Configurer Clockify : #

  • Authentification OAuth2:
    • Client Id: Allez dans Azure - Aperçu - Application (client) ID : copiez la valeur et collez-la dans Clockify
    • Clé secrète client: il devrait déjà être collé depuis les étapes précédentes (Certificats et Secrets)
    • ID de l’annuaire (locataire): Allez dans Azure - Aperçu - ID de l'annuaire (locataire) copiez la valeur et collez-la dans Clockify

Les champs de la section Avancé seront pré-remplis.

Votre écran dans Clockify devrait ressembler à ceci :

et

Cliquez sur Terminer la configuration pour terminer le processus. Cochez la case Se connecter avec OAuth (et désactivez éventuellement Se connecter avec l'adresse email et le mot de passe).

Vous pouvez également vous connecter à Azure à l'aide du protocole d'authentification SAML2, d'abord en ajoutant une application non répertoriée (sans galerie) à votre organisation Azure AD, puis en configurant une authentification unique basée sur SAML pour cette application sans galerie.

SAML2 avec Microsoft Azure #

L'interface utilisateur présentée dans cette vidéo peut ne pas correspondre à la dernière version de l'appli.

Étape 1 : Création d'un sous-domaine dans Clockify #

Pour plus d'informations à ce sujet, consultez la section Mise en place d'un sous-domaine personnalisé.

Étape 2 : Ajouter une application dans Azure #

  1. Naviguer vers les Applications d'entreprise
  2. Nouvelle application (puis assurez-vous que vous êtes sur le nouvel affichage de la galerie)
  3. Choisissez Créez votre propre application
  4. Saisissez les éléments suivants :
    • Nom : Clockify
    • Intégrez toute autre application que vous ne trouvez pas dans la galerie

Cliquez sur Créer et naviguez vers Propriétés puis remplissez les champs :

  • Logo: p. ex. télécharger le logo Clockify
  • Si nécessaire, modifiez les champs Affectation de l'utilisateur requise et Visible par les utilisateurs

Cliquez sur Enregistrer pour terminer le processus.

Étape 3 : Clockify #

  1. Cliquez sur Configurer SSO
  2. Choisissez SAML2 comme type d'authentification
  3. Cliquez sur Suivant

Une fois que vous avez obtenu Le formulaire d'authentification SAML2 retournez dans Azure.

Étape 4 : configuration d'Azure SSO #

  1. Naviguez vers Authentification unique dans la barre latérale
  2. Choisissez SAML
  3. Configuration de base de SAML (cliquez sur le crayon pour modifier) :
    • Identifiant (ID de l'entité) : C'est ici que vous mettez l'adresse de votre sous-domaine, par exemple https://acmecompany.clockify.me/
    • URL de réponse ( URL du service consommateur d'assertions) : retournez sur Clockify et copiez l'URL de réponse, ré-générée, par exemple : https://global.api.clockify.me/auth/saml2

Cliquez sur Enregistrer et continuez avec le Certificat de signature SAML: (cliquez sur le crayon pour modifier) :

  • Nouveau certificat

Enregistrez les modifications et cliquez sur les 3 points du certificat Inactif, choisissez Rendre le certificat actif et cliquez sur Oui.

Maintenant, rechargez la page pour voir les changements.

Étape 5 : Clockify #

  1. l'ID de l'entité: (c'est ici que vous mettez l'adresse de votre sous-domaine, dans notre cas il s'agit https://yourcompanysubdomain.clockify.me/)
  2. Métadonnées de la fédération : naviguez vers Azure, sous SAML Certificats copiez/collez Url des métadonnées de la fédération d'applications dans Clockify

Url de connexion : Naviguer vers Azure, sous Configurer Clockify trouver l'URL de connexion et copiez/collez dans Clockify

Cliquez sur Terminer la configuration et activez Se connecter avec SAML2 (et désactivez éventuellement Se connecter avec l'email et le mot de passe).

Étape 6 : Attribuer l'application dans Azure #

  1. Naviguez vers Utilisateurs et Groupes dans la barre latérale (où vous choisissez quels utilisateurs de votre compte Azure pourront accéder à Clockify)
  2. Cliquez sur Ajouter un utilisateur/groupe
  3. Dans Utilisateurs et groupes choisissez les utilisateurs que vous voulez
  4. Cliquez sur Sélectionner et Affecter

OAuth avec Okta #

Étape 1 : Création d'un sous-domaine dans Clockify #

Pour plus d'informations à ce sujet, consultez la section Mise en place d'un sous-domaine personnalisé.

Étape 2 : Créer une application dans Okta #

  1. Naviguez vers Applications dans la barre latérale
  2. Cliquez sur le bouton Créer une intégration d'application
  3. Choisissez OIDC - OpenID Connect dans la section Méthode de connexion
  4. Choisissez l'application Web dans la section Type d'application
  5. Cliquez sur Suivant

Créer l'intégration OIDC #

Dans le formulaire Nouvelle intégration d'application Web, Paramètres généraux, entrez les informations suivantes et cliquez sur Enregistrer.

  1. Nom de l'intégration d'application : p. ex. Clockify
  2. Logo (facultatif) : p. ex. télécharger le logo Clockify
  3. URIs de redirection de la connexion : Copier/coller l'URL de redirection (section Avancé) dans la configuration du SSO de Clockify

Vous devez également ajouter les URIs suivants pour que la connexion OAuth fonctionne sur les applications mobiles Clockify :

ou, si vous utilisez l'un des serveurs régionaux, vous devez ajouter l'une des URL régionales.

Ensuite, faites défiler l'écran vers le bas et, dans la section Affectations, cochez l'option Autoriser l'accès à tous les membres de votre organisation. Cliquez sur Enregistrer pour terminer l'action.

Vous devriez obtenir un écran qui ressemble à celui-ci :

Étape 3 : Ajouter la configuration SSO dans Clockify #

Maintenant, dans Clockify, dans l'écran Authentification où vous avez créé votre sous-domaine :

  1. Cliquez sur Configurer le SSO en bas de l'écran
  2. Choisissez OAuth2 comme type d'authentification
  3. Choisissez Okta comme modèle IdP
  4. Cliquez sur Suivant

Dans le formulaire d'authentification OAuth, entrez les informations suivantes :

  • ID du client: Généré dans Okta à l'étape précédente ; copiez-le depuis la section Informations d'identification du client .
  • Clé secrète client: identique à l'ID du client ; copiez-le depuis la section Informations d'identification du client .
  • Domaine Okta : Copiez depuis Okta, Paramètres généraux, champ Domaine Okta (Remarque : le domaine Okta nécessite un nom de domaine uniquement, par exemple : doamin_name.okta.com au lieu de : https://domain_name.okta.com)
  • La section Avancée est pré-remplie (générée automatiquement)

L'écran devrait ressembler à ceci :

et

Étape 4 : Attribuer l'application dans Okta #

Dans Okta :

  1. Naviguez vers Applications
  2. Choisissez Clockify
  3. Dans l'onglet Tâches, cliquez sur Attribuer
  4. Choisissez Attribuer à des personnes/groupes en fonction des personnes de votre compte Okta à qui vous souhaitez donner accès à Clockify

Dans Clockify, cliquez sur Terminer la configuration pour terminer le processus et activer la connexion avec OAuth. En option, vous pouvez désactiver la connexion avec l'email et le mot de passe.

Enfin, votre écran dans Clockify devrait ressembler à quelque chose comme ceci :

Et c'est tout ! Désormais, vous et les utilisateurs de votre espace de travail êtes en mesure de vous connecter à votre espace de travail avec OAuth.