# How to get started?

{% hint style="warning" %}
**Requirements:** 

Microsoft Entra ID (formerly known as Azure Active Directory)

* *For hybrid setups: You’ll also need to complete* [*Step 3 - Hybrid setup - Active Directory*](#optional-step-3-hybrid-setup-active-directory)
  {% endhint %}

ServiceChanger provides a streamlined and user-friendly method for connecting to your Microsoft Entra ID tenant via [OAuth2](https://learn.microsoft.com/en-us/entra/architecture/auth-oauth2). Through our intuitive onboarding screen, all you need to do is input your Entra Tenant ID and grant admin consent – it's that easy.

## Step 1: Azure Entra ID

1. Open [portal.azure.com](https://portal.azure.com), sign in and navigate towards Microsoft Entra ID.
2. Copy your (Entra) Tenant ID

<figure><img src="/files/QyXUv0arOuRhbIdgAo9z" alt=""><figcaption></figcaption></figure>

## Step 2: ServiceChanger.com

3. Go to the onboarding link you received in your mailbox after completing the '[start free trial](https://servicechanger.com/en#pricing)' process
4. Paste your (Entra) Tenant ID
5. Submit
6. Grant permission by logging in with an **Global Administrator account**

<figure><img src="/files/f1gtpYIas8H2PHeUMcp2" alt=""><figcaption></figcaption></figure>

7. After that, your [app](https://app.servicechanger.com/en) will start synchronizing the users, groups, and user-group relations from your Entra ID Tenant. This may take a few minutes.&#x20;

{% hint style="info" %}
Grant operators access rights to ServiceChanger can be found on the [Microsoft Entra ID integration page](/servicechanger.com/general/microsoft-entra-id.md).
{% endhint %}

8. Once that's done, you're ready to start creating your Attribute-Based Access Control (ABAC) model. We really suggest getting the hang of the [basics of the tool](/servicechanger.com/getting-started/learn-the-basics.md) first.

## (Optional) Step 3: Hybrid Setup - Active Directory&#x20;

To review your current state of transformation, [click here](https://learn.microsoft.com/en-us/entra/architecture/road-to-the-cloud-posture)

{% hint style="warning" %}
**Requirements:**&#x20;

Ensure the following prerequisites are met before proceeding:

* User, Group, and Membership information must be accessible (at minimum, **read-only**) in Microsoft Entra ID.<br>

Additionally, confirm that these components are set up:

* Hybrid Worker(s)
* Microsoft Entra Connect *(or AD Connect)*
* Automation Account (Runbooks) in Azure
  {% endhint %}

Many companies still utilize Active Directory (AD) as their primary source for identity and access management, with changes synchronized to Entra ID. ServiceChanger seamlessly supports managing these environments simultaneously.

**How Does It Work?**\
ServiceChanger directly reads from Entra ID, not from Active Directory. However, updates made within ServiceChanger are exposed through the [ServiceChanger API](/servicechanger.com/general/api-documentation.md), allowing you to reflect these updates back into your Active Directory environment.

**How to Set This Up?**

1. Start with Steps 1 & 2 to ensure Entra ID is properly connected and in sync.
2. Set up your runbook to fetch delta changes from the [ServiceChanger API](/servicechanger.com/general/api-documentation.md) and apply them to your local Active Directory.

{% hint style="success" %}
To make things easier, we’ve also [pre-created a membership runbook](/servicechanger.com/general/api-documentation/example-membership-runbook.md) for you. It’s optional but available if needed.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://servicechanger.gitbook.io/servicechanger.com/getting-started/how-to-get-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.