# CosmosDB

## Requirements

In order to integrate Teleskope with Cosmos DB, you must make sure the following prerequisites are met:

* Within Azure: You must have created an Entra App as described previously
* Within Teleskope: A Teleskope admin account to complete the setup process.

## Integration

{% stepper %}
{% step %}

### Grant the Teleskope App read access to Azure Cosmos DB 

Grant the Teleskope app the following role:

* Cosmos DB Account Reader
  {% endstep %}

{% step %}

### Whitelist Teleskope IP range (Optional)  <a href="#h_01hxcch1qefcwjx0y2awa9z72v" id="h_01hxcch1qefcwjx0y2awa9z72v"></a>

You may need to whitelist Teleskope's IP range to allow Teleskope to connect to Azure Cosmos DB

1. Log in to the [Azure portal](https://portal.azure.com/).
2. Open the menu and search for or select **Azure Cosmos DB**.
3. On the *Azure Cosmos DB* page, select your Azure Cosmos DB for MongoDB account.
4. From the left menu of your Azure Cosmos DB for MongoDB account page, click **Networking**.
5. On the *Networking* page, under *Public network access*, check the following:
   * If **All networks** is enabled, no further action required.
   * If **Select networks** is enabled, enter your dedicated Teleskope IP range

<br>

{% endstep %}
{% endstepper %}