# Computle Client v3: Enterprise App Registration

Computle Client uses OAth 2.0 to authenticate users against your existing iDP, such as Entra ID. Additionally, Directory Sync automatically syncs Entra ID users to Computle, enabling machine assignment to users.

## Step 1: Computle Client Login Setup

### Steps

#### 1. Download and Install

* Download [Computle Client](https://docs.computle.com/installers/installers)
* Follow installation steps

#### 2. Login Process

* Click **"Login with Microsoft"**
* Enter your work email
* Enter your password

#### 3. Grant Application Consent

* If requested, grant consent for Computle Client to:
  * Sign you in and read your profile
  * Maintain access to data you have given it access to
* Select **"Consent on behalf of your organisation"** if applicable

{% hint style="warning" %}
Admin approval may be required, See [Microsoft Learn](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/review-admin-consent-requests) for guidance.
{% endhint %}

#### 4. Approval by Computle

* Once approved by Computle, you'll see your available machines. This is a manual step which takes up to 24 hours.

***

## Step 2: Portal Directory Sync Setup

### Setup Steps

#### 1. Grant Admin Consent

* Navigate to [**Directory Sync**](https://portal.computle.com/directory-sync) in sidebar
* Click **"Grant Admin Consent"** button,

{% hint style="warning" %}
If approval is required, you will need to repeat these steps **in full** once permission is granted. The sync process will fail otherwise.
{% endhint %}

<figure><img src="https://590139285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVtJhup5nG3tHLCSRWhhh%2Fuploads%2Fgit-blob-a9d30a88b1e0af23fa06f66b5505bb2784f43ea2%2FScreenshot_25-7-2025_1212_portal.computle.com.jpeg?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://590139285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVtJhup5nG3tHLCSRWhhh%2Fuploads%2Fgit-blob-377d17889c4c802589869a10ab45e7b6ab555394%2FScreenshot_25-7-2025_1233_login.microsoftonline.com.jpeg?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://590139285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVtJhup5nG3tHLCSRWhhh%2Fuploads%2Fgit-blob-185f84595d983d1aa7abf5847825a3d35200c236%2FScreenshot_25-7-2025_1250_login.microsoftonline.com%20(1).jpeg?alt=media" alt=""><figcaption></figcaption></figure>

#### 2. Click Sync Now

* Click **"Sync Now"** button to start synchronization

<figure><img src="https://590139285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVtJhup5nG3tHLCSRWhhh%2Fuploads%2Fgit-blob-24cfb2a5f96b8c8c8685ea55adc1b14581e422bf%2FScreenshot_25-7-2025_1317_portal.computle.com.jpeg?alt=media" alt=""><figcaption></figcaption></figure>

#### 3. Verify Users

* Check **Users** section to see synced accounts

<figure><img src="https://590139285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVtJhup5nG3tHLCSRWhhh%2Fuploads%2Fgit-blob-19fe127259ecceedfd50b8639523b10183761297%2FScreenshot_25-7-2025_1731_portal.computle.com.jpeg?alt=media" alt=""><figcaption></figcaption></figure>

### You're set

Users from Entra ID are now available in Computle for machine assignment and access management.

***

## Requied Permissions

#### Computle OAuth 2.0 (Portal Login)

Used for user authentication to access the app and portal:

| Permission    | Type      | Description                   |
| ------------- | --------- | ----------------------------- |
| **email**     | Delegated | View users' email address     |
| **openid**    | Delegated | Sign users in                 |
| **profile**   | Delegated | View users' basic profile     |
| **User.Read** | Delegated | Sign in and read user profile |

#### Computle OAuth 2.0 (Tenant Sync)

Used for directory synchronization with these Microsoft Graph permissions:

| Permission               | Type        | Description                   |
| ------------------------ | ----------- | ----------------------------- |
| **Directory.Read.All**   | Application | Read directory data           |
| **Group.Read.All**       | Application | Read all groups               |
| **GroupMember.Read.All** | Application | Read all group memberships    |
| **User.Read.All**        | Application | Read all users' full profiles |

> **Microsoft Graph API** enables applications to access Microsoft 365 data and intelligence through a unified REST API endpoint.