Single sign-on (SSO)

Step 1: Create subdomain in Clockify #

For more information on this, check out Setting up custom subdomain section.

Step 2: Create application in Okta #

1. Navigate to Applications in the sidebar
2. Click Create App Integration button
3. Choose SAML 2.0 in modal
4. Click Next

Create SAML 2.0 integration #

In General Settings form, enter the following information and click Next

• App name: e.g. Clockify
• Logo: e.g. upload Clockify logo

In Configure SAML form, enter the following information:

• Single sign on URL (or ACS): Specific URL that SAML assertions from Okta should be sent to (e.g. https://global.api.clockify.me/auth/saml2)
• Audience URI (Entity ID in your app): Unique identifier of your custom application; same as Entity Id in SAML authentication field (e.g. https://yourcompanysubdomain.clockify.me)
• Default Relay State: IdP-initiated authentication so that users can log in to Clockify straight from the Okta dashboard

Example of Default Relay State:

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

Make sure you put straight quotes instead of the curly ones, or it won’t work.

Leave everything else as is and click Next.

In Feedback check I’m an Okta customer adding an internal app and click Finish.

You should get the screen that looks something like this:

As the final step in this section, click View Setup Instructions button seen in the screenshot above.

In How to Configure SAML 2.0 for Clockify Application, you’ll get the list of data you need in order to configure your Clockify application.

Step 3: Add SSO configuration in Clockify #

Now, in Clockify, in the Authentication screen:

1. Click Add SSO Configuration at the bottom of the screen
2. Choose SAML2 as authentication type
3. Choose Okta as IdP Template

SAML2 authentication form appears:

Enter the following:

• Entity Id (Audience URI in Okta): e.g. https://yourcompanysubdomain.clockify.me
• Metadata Url:
  • Navigate back to Okta
  • Copy the Identity Provider metadata link from the Settings section in Okta
  • Save it as an .xml file and upload it to Clockify
• SAML SSO URL: Copy/paste Identity Provider Single Sign-On URL from Okta’s How to configure SAML 2.0 for Clockify Application

For example:

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

• Advanced: Copy/paste X.509 Certificate from Okta

Finally, your screen in Clockify should look something like this:

and

After entering all required data, you can choose to verify your configuration by clicking the Test configuration button. This action ensures the accuracy of the provided information. If everything is correct, the Test configuration button will be replaced with a Finish configuration button.

Click Finish configuration to complete the process and enable Log in with SAML2. Optionally, disable Log in with email and password.

Step 4: Assign application in Okta #

In Okta:

1. Navigate to Applications
2. Choose Clockify
3. In Assignments tab click Assign
4. Choose Assign to People/Groups depending on who from your Okta account you’d like to be able to access Clockify

And that’s it! Now you, and your workspace users are able to log in to your workspace with SAML2.

Step 1: Create subdomain in Clockify #

For more information on this, check out Setting up custom subdomain section.

Step 2: Create application in OneLogin #

1. Navigate to Applications
2. Click Add App
3. Search and choose SAML Custom Connector (Advanced)
4. Info:
   • Display Name: Clockify
   • Logo: e.g. upload Clockify logo

Click Save and fill out the Configuration:

• Audience: Clockify
• Recipient: https://global.api.clockify.me/auth/saml2
• ACS (Consumer) URL Validator*: ^https:\/\/global.api.clockify\.me\/auth\/saml2\/$
• ACS (Consumer) URL*: https://global.api.clockify.me/auth/saml2
• Login URL: https://yourcompanysubdomain.clockify.me/
• SAML initiator: Service Provider
• Click Save to complete the process

Step 3: Add SSO configuration in Clockify #

1. Click Add SSO Configuration
2. Choose SAML2 as authentication type
3. Choose OneLogin as IdP Template and fill out the following fields
   • Audience (Entity Id): Clockify
   • Metadata Url: Go to OneLogin > SSO and copy Issuer URL then paste it in Metadata Url in Clockify
   • Login Url: Copy/paste SAML 2.0 Endpoint (HTTP) from SSO section in OneLogin

In Advanced section, enter:

• Certificate: Copy/paste the X.509 Certificate from View Details, SSO in OneLogin

Step 4: Assign application in OneLogin #

In OneLogin:

1. Navigate to Users (this is where you choose which users from your OneLogin account will be able to access Clockify)
2. Click on the specific User
3. In Applications, click the + sign to add an app
4. Choose Clockify
5. Click Continue and Save

In Clockify, after entering all required data, you can choose to verify your configuration by clicking the Test configuration button. This action ensures the accuracy of the provided information. If everything is correct, the Test configuration button will be replaced with a Finish configuration button.

Click Finish configuration to complete the process and enable Log in with SAML 2.0. Optionally, you can disable Log in with email and password.

And that’s it! Now you, and your workspace users are able to log in to your workspace with SAML 2.0.

Once you move to subdomain, the default Google log-in will stop working and you’ll have to configure it manually to continue using it.

Setting up Google log-in is quick and easy.

You’ll need to have a G Suite or Cloud Identity account in order to do this.

You need to Set up OAuth 2.0 in your Google account, create a project and get OAuth 2.0 client ID for a web application.

In Google Cloud Platform navigate to API & Services and choose Credentials. Open the project/application you’ve created and paste https://yoursubdomain.clockify.me/login under the Authorized redirect URIs.

You should also add the following URIs in order for the OAuth login to work on Clockify mobile apps:

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

If you’re using one of the regional servers for hosting, please note that the URLs for workspaces that are on subdomain won’t contain the indicator of the region in question, although they are hosted on a regional server.

1. In Clockify, go to Authentication tab
2. Click Add SSO Configiuration
3. Choose OAuth2 authentication type
4. Choose Google in IdP Templates modal
5. Click Next
6. Copy/paste Client ID and Client Secret from your Google app as seen in the example below (fields in the Advanced section will be pre-populated)

Your screen in Clockify should look something like this:

and

After entering all required data, you can choose to verify your configuration by clicking the Test configuration button. This action ensures the accuracy of the provided information. If everything is correct, the Test configuration button will be replaced with a Finish configuration button.

Click Finish configuration to complete the process. Check the Log in with OAuth checkbox to start using Google login. Optionally, you can force everyone to use your company’s Google identity for logging in by disabling Log in with email and password.

You can connect Azure to Clockify by setting up OAuth.

Step 1: Create subdomain in Clockify #

For more information on this, check out Setting up custom subdomain section.

Step 2: Add SSO configuration in Clockify #

1. Click Add SSO Configuration
2. Choose OAuth2 as authentication type
3. Choose Azure in IdP Templates modal
4. Copy Redirect URL

Step 3: Register application in AzureAD #

1. Navigate to App registrations
2. Click New Registration
3. Enter the following information:
   • Info:
     • Name: Clockify
     • Supported account types: Choose what you prefer; in our case it’s Accounts in this organizational directory only (Default Directory only – Single tenant)
     • Redirect URI: Paste Redirect URL you copied from Step 2; https://yourcompanysubdomain.clockify.me/login (it can also be: https://yourcompanysubdomain.clockify.me/login/ios/oauth2 or https://yourcompanysubdomain.clockify.me/login/android/oauth2) and click Register to continue

Or, if you’re using one of the regional servers, you should add one of the regional URLs.

Step 4: Configure (Clockify & Azure) #

Configure AzureAD:  #

• Certificates & Secrets:
  • Choose New client secret
    • Description: Clockify
    • Expires: Never
  • Click Add
• Client Secret: Copy/paste the value of this client secret
• API permissions:
  • Add a permission
    • Microsoft Graph
    • Check openid in Delegated permissions
    • Add permissions (you can also check other permissions such as email and profile)
• Refresh the page
• Go back to Overview

Configure Clockify: #

• OAuth2 authentication:
  • Client Id: Go to Azure — Overview — Application (client) ID: copy the value and paste it back in Clockify
  • Client Secret: this should already be pasted from previous steps (Certificates & Secrets)
  • Directory (tenant) ID: Go to Azure — Overview — Directory (tenant) ID copy the value and paste it back in Clockify

Fields in the Advanced section will be pre-populated.

Your screen in Clockify should look something like this:

and

After entering all required data, you can choose to verify your configuration by clicking the Test configuration button. This action ensures the accuracy of the provided information. If everything is correct, the Test configuration button will be replaced with a Finish configuration button.

Click Finish configuration to complete the process. Check the Log in with OAuth checkbox (and optionally disable Log in with email and password).

Alternatively, you can connect Azure using the SAML2 authentication protocol, first by adding an unlisted (non-gallery) application to your Azure AD organization and then configuring SAML-based single sign-on to this non-gallery application.

Step 1: Create subdomain in Clockify #

For more information on this, check out Setting up custom subdomain section.

Step 2: Add application in Azure #

1. Navigate to Enterprise Applications
2. New application (then make sure you’re on the new gallery view)
3. Choose Create your own application
4. Enter the following:
   • Name: Clockify
   • Integrate any other application you don’t find in the gallery

Click Create and navigate to Properties and fill out the fields:

• Logo: e.g. upload Clockify logo
• Optionally change User assignment required and Visible to users if necessary

Click Save to complete the process.

Step 3: Clockify #

1. Click Add SSO Configuration
2. Choose SAML2 as authentication type
3. Click Next

Once you get the SAML2 authentication template, go back to Azure.

Step 4: Azure SSO configuration #

1. Navigate to Single sign-on in the sidebar
2. Choose SAML
3. Basic SAML Configuration (click the pencil to edit):
   • Identifier (Entity ID): This is where you put your subdomain address, e.g. https://yourcompanysubdomain.clockify.me/
   • Reply URL (Assertion Consumer Service URL): go back to Clockify and copy pre-generated Reply URL, e.g. https://global.api.clockify.me/auth/saml2

Click Save and continue with SAML Certificate: (click the pencil to edit):

• New certificate

Save the changes and click the 3 dots on the Inactive certificate, choose Make certificate active and click Yes.

Now, reload the page to see the changes.

Step 5: Clockify #

1. Entity Id: (this is where you put your subdomain address, in our case it’s https://yourcompanysubdomain.clockify.me/)
2. Federation Metadata: Navigate to Azure, under SAML Certificates copy/paste App Federation Metadata Url in Clockify

Login Url: Navigate to Azure, under Set up Clockify find Login URL and copy/paste it in Clockify

Your screen should look like this:

and like this:

After entering all required data, you can choose to verify your configuration by clicking the Test configuration button. This action ensures the accuracy of the provided information. If everything is correct, the Test configuration button will be replaced with a Finish configuration button.

Click Finish configuration and enable Log in with SAML2 (and optionally disable Log in with email and password).

Step 6: Assign application in Azure #

1. Navigate to Users and Groups in the sidebar (where you choose which users from your Azure account will be able to access Clockify)
2. Click Add user/group
3. In Users and groups choose users you want
4. Click Select and Assign

Step 1: Create subdomain in Clockify #

For more information on this, check out Setting up custom subdomain section.

Step 2: Create application in Okta #

1. Navigate to Applications in the sidebar
2. Click Create App Integration button
3. Choose OIDC – OpenID Connect in Sign-in method section
4. Choose Web application in Application type section
5. Click Next

Create OIDC Integration #

In New Web App Integration, General Settings form enter the following information and click Save.

1. App integration name: e.g. Clockify
2. Logo (optional): e.g. upload Clockify logo
3. Sign-in redirect URIs: Copy/paste URL from Redirect URL (Advanced section) in Clockify SSO configuration

You should also add the following URIs in order for the OAuth 2.0 (OIDC) login to work on Clockify mobile apps:

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

or, if you’re using one of the regional servers, you should add one of the regional URLs.

Then, scroll down and in the Assignments section check Allow everyone in your organization to access option. Click Save to complete the action.

You should get the screen that looks like this:

Step 3: Add SSO configuration in Clockify #

Now, in Clockify, in Authentication screen where you created your subdomain:

1. Click Add SSO Configuration at the bottom of the screen
2. Choose OAuth2 as authentication type
3. Choose Okta as IdP Template
4. Click Next

In OAuth 2.0 (OIDC) authentication form enter the following information:

• Client ID: Generated in Okta in the previous step; copy it from the Client Credentials section
• Client Secret: Same as Client ID; copy it from the Client Credentials section
• Okta Domain: Copy it from Okta, General Settings, Okta domain field (Note: Okta Domain requires a domain name only, for example: doamin_name.okta.com instead of: https://domain_name.okta.com)
• Advanced section is pre-populated (automatically generated)

The screen should look something like this:

and

Step 4: Assign application in Okta #

In Okta:

1. Navigate to Applications
2. Choose Clockify
3. In Assignments tab click Assign
4. Choose Assign to People/Groups depending on who from your Okta account you’d like to be able to access Clockify

After entering all required data, on the Clockify side, you can choose to verify your configuration by clicking the Test configuration button. This action ensures the accuracy of the provided information. If everything is correct, the Test configuration button will be replaced with a Finish configuration button.

Click Finish configuration to complete the process and enable Log in with OAuth. Optionally, you can disable Log in with email and password.

Finally, your screen in Clockify should look something like this:

And that’s it! Now you, and your workspace users are able to log in to your workspace with OAuth 2.0 (OIDC).