> For the complete documentation index, see [llms.txt](https://docs.teleskope.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.teleskope.ai/connectors/azure/cosmosdb.md).

# 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)**

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 %}