--- title: How do I setup OAuth 2.0 with CMiC? description: SmartBarrel connects to CMiC using OAuth 2.0 authentication. Learn how to set up a CMiC service account, configure your Azure App Registration, and enter your credentials in SmartBarrel to complete the connection. --- [Skip to content](https://ask.smartbarrel.io/how-do-i-setup-oauth-2.0-with-cmic#main-content) English Show submenu for translations [Customer portal](https://ask.smartbarrel.io/ticketsview?hsLang=en) ![smartbarrel-logo-1.png\]](https://ask.smartbarrel.io/hs-fs/hubfs/smartbarrel-logo-1.png?height=39&name=smartbarrel-logo-1.png) - Home - Products - Pricing - Blog - Company Open main navigation Close main navigation - Home - Products - Pricing - Blog - Company - English Show submenu for translations - [Customer portal](https://ask.smartbarrel.io/ticketsview) - Go to Dashboard Go to Dashboard Search the SmartBarrel Knowledge Base - There are no suggestions because the search field is empty. 1. [SmartBarrel Knowledge Base](https://ask.smartbarrel.io/?hsLang=en) 2. [Integrations](https://ask.smartbarrel.io/integrations?hsLang=en) 3. [CMiC Integration](https://ask.smartbarrel.io/integrations?hsLang=en#cmic-integration) # How do I setup OAuth 2.0 with CMiC? ## Learn how to connect SmartBarrel to CMiC using OAuth 2.0 authentication. ### **Setting Up the Connection** CMiC OAuth 2.0 requires setup in three places: CMiC, Azure (or your identity provider), and SmartBarrel. Your CMiC administrator and IT team will need to complete the first two steps before you can connect in SmartBarrel. #### **Step 1: CMiC Setup** Your CMiC administrator will need to: 1. Create a dedicated API service account in CMiC for the SmartBarrel integration. For detailed steps, refer to the CMiC Developer API Account documentation: [https://developers.cmicglobal.com/v1/docs/developer-api-account](https://developers.cmicglobal.com/v1/docs/developer-api-account) Note down the following from the service account: - **Client ID** (e.g. ACME) - **User ID** (e.g. SMARTBARREL) These are combined to form the cmicuser claim value used in Step 2 (format: ClientID||UserID). 2. Create an API role and assign the required API endpoints to it 3. Register your Azure app in CMiC using your Azure Issuer URL and Application (Client) ID, and assign the role to the app For steps 2 and 3, refer to the CMiC API Security Configuration documentation: [https://docs.cmicglobal.com/portal/Content/E\_Reference\_Material/CMiC\_API\_Access\_Setup/Reference/API\_Access\_Setup/Security/API\_Security\_Configuration.htm](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/CMiC_API_Access_Setup/Reference/API_Access_Setup/Security/API_Security_Configuration.htm) #### **Step 2: Azure Entra ID Setup** Your IT team will need to create an App Registration in Microsoft Entra ID (https://entra.microsoft.com) and configure it to work with CMiC. This includes: 1. Creating the App Registration and a Client Secret 2. Setting an Application ID URI 3. Updating the app Manifest 4. Adding a custom cmicuser claim using the service account details from Step 1 (format: ClientID||UserID, e.g. ACME||SMARTBARREL) For detailed steps, refer to the CMiC Microsoft Entra ID Application documentation: [https://docs.cmicglobal.com/portal/Content/E\_Reference\_Material/OAuth/References/OAuth2\_Microsoft\_Entra\_ID\_App.htm](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/OAuth/References/OAuth2_Microsoft_Entra_ID_App.htm) #### **Step 3: Connect in SmartBarrel** Once the above is complete, gather the following from your Azure and CMiC administrators: - **Endpoint:** Your CMiC OAuth API URL. Note: this is different from the Basic Auth URL. For cloud users you can find your OAuth URL in the following URL: [https://developers.cmicglobal.com/v1/docs/cloud-api-server-urls](https://developers.cmicglobal.com/v1/docs/cloud-api-server-urls) - **Token URL:** Your Azure token endpoint (e.g. https://login.microsoftonline.com/your-tenant-id/oauth2/v2.0/token) - **Client ID:** The Application (Client) ID from your Azure App Registration - **Client Secret:** The client secret value created in Azure - **Scope:** api://your-client-id/.default (filled in automatically if left blank) To connect the integration, follow these steps: 1. Navigate to the SmartBarrel dashboard and click **Integrations** in the left-hand sidebar menu. 2. Find the CMiC integration card and click **Connect**. 3. Select **OAuth 2.0** as the Authentication Method. 4. Enter your Endpoint, Token URL, Client ID, Client Secret, and Scope. 5. Click **Connect**. SmartBarrel will verify the credentials and confirm the connection. ![](https://ask.smartbarrel.io/hs-fs/hubfs/image-png-Jun-25-2026-03-09-30-9656-PM.png?width=678&height=1016&name=image-png-Jun-25-2026-03-09-30-9656-PM.png) - [SmartBarrel Dashboard](https://ask.smartbarrel.io/smartbarrel-dashboard?hsLang=en#main-content) - [Worker Profile Management](https://ask.smartbarrel.io/smartbarrel-dashboard?hsLang=en#worker-profile-management) - [Project Settings](https://ask.smartbarrel.io/smartbarrel-dashboard?hsLang=en#project-settings) - [Timesheet Management](https://ask.smartbarrel.io/smartbarrel-dashboard?hsLang=en#timesheet-management) - [Productivity](https://ask.smartbarrel.io/smartbarrel-dashboard?hsLang=en#productivity) - [Worker Vs User](https://ask.smartbarrel.io/smartbarrel-dashboard?hsLang=en#worker-vs-user) - [Crew Management](https://ask.smartbarrel.io/smartbarrel-dashboard?hsLang=en#crew-management) - [Reports](https://ask.smartbarrel.io/smartbarrel-dashboard?hsLang=en#reports) - [Company Settings](https://ask.smartbarrel.io/smartbarrel-dashboard?hsLang=en#company-settings) - [Security](https://ask.smartbarrel.io/smartbarrel-dashboard?hsLang=en#security) - [PunchFlow and SMS Messages](https://ask.smartbarrel.io/smartbarrel-dashboard?hsLang=en#punchflow-and-sms-messages) - [Microsoft SSO](https://ask.smartbarrel.io/smartbarrel-dashboard?hsLang=en#microsoft-sso) - [Unions and Agreements](https://ask.smartbarrel.io/smartbarrel-dashboard?hsLang=en#unions-and-agreements) - [Device and Solar](https://ask.smartbarrel.io/device-and-solar?hsLang=en) - [Mobile App](https://ask.smartbarrel.io/mobile-app?hsLang=en#main-content) - [Manage the Apps Settings](https://ask.smartbarrel.io/mobile-app?hsLang=en#manage-the-apps-settings) - [Using the App](https://ask.smartbarrel.io/mobile-app?hsLang=en#using-the-app) - [Integrations](https://ask.smartbarrel.io/integrations?hsLang=en#main-content) - [Procore Integration](https://ask.smartbarrel.io/integrations?hsLang=en#procore-integration) - [CMiC Integration](https://ask.smartbarrel.io/integrations?hsLang=en#cmic-integration) - [API](https://ask.smartbarrel.io/integrations?hsLang=en#api) - [Viewpoint Vista (App Xchange)](https://ask.smartbarrel.io/integrations?hsLang=en#viewpoint-vista-app-xchange) - [Plexxis](https://ask.smartbarrel.io/integrations?hsLang=en#plexxis) - [Foundation](https://ask.smartbarrel.io/integrations?hsLang=en#foundation) - [BuildOps](https://ask.smartbarrel.io/integrations?hsLang=en#buildops) - [Spectrum](https://ask.smartbarrel.io/integrations?hsLang=en#spectrum) - [Feature Highlights](https://ask.smartbarrel.io/feature-highlights?hsLang=en) - Home - Products - Pricing - Blog - Company [![Chill listening crop-3](https://ask.smartbarrel.io/hs-fs/hubfs/SMARTBARREL-Logo-png-1.png?width=42&height=24&name=SMARTBARREL-Logo-png-1.png "Chill listening crop-3")](https://smartbarrel.io) Copyright © 2026, SmartBarrel