Tilt Base reaches your Speech resource with access your Microsoft Entra directory grants, so there's no key to create, store or rotate. Usage is billed to your Azure subscription. Each Speech resource is its own connection, and its region decides which models it can run.
## Before you start
- For step 1, an administrator of your Microsoft Entra directory: a Global Administrator, Cloud Application Administrator or Application Administrator.
- For step 2, the Owner or User Access Administrator role on the resource group, to create a new resource. To use an existing resource, you need to be able to add role assignments on it.
## Connect a Speech resource
Go to Settings › Organisation › Transcription, select **Add connection**, then choose **Azure Speech**. The dialog has two steps, **Grant access** and **Speech resource**. Once one resource is connected, your directory has already granted access, so the next starts at **Speech resource**.
### 1. Grant access in Microsoft Entra
1. Select **Grant access in Microsoft Entra**. An administrator of your directory signs in.
2. Check that Microsoft shows **Tilt Base**, from the verified publisher **TILT Legal Pty Ltd**, with the application ID `d0d9b19c-3d21-433a-a60c-e4a529c12b31`. Then select **Accept**.
3. Microsoft brings you back to Tilt Base, with your directory ID filled in, at the **Speech resource** step.
If someone else grants access, send them the link from the dialog, and enter **Directory (tenant) ID** yourself. It's the **Tenant ID** on the overview page of the Microsoft Entra admin centre. Then select **Next**.
<callout icon="ℹ️" color="blue_bg">
	**Granting access doesn't open your Azure resources to Tilt Base.** It adds Tilt Base to your directory, so you can give it a role on a Speech resource. Tilt Base can reach only the resources you give it a role on, and uses them only to transcribe.
</callout>
### 2. Create or choose a Speech resource
<callout icon="🌏" color="blue_bg">
	**Where recordings are processed.** Azure processes each recording in its Speech resource's region. Azure LLM Speech and MAI-Transcribe-2 run only in Central India, East US, North Europe, Southeast Asia, West US and West US 2; Australia East doesn't offer them. To keep fast transcription in Australia and use those models too, connect one resource in Australia East and one in Southeast Asia (Singapore).
</callout>
<tabs>
	<tab icon="✨">
		Create a new resource (recommended)
		1. Select **Deploy to Azure**. The Azure portal opens in a new tab with Tilt Base's template.
		2. Choose a subscription, a resource group and the region recordings should be processed in. Australia East is the default. For Azure LLM Speech or MAI-Transcribe-2, choose Southeast Asia (Singapore), the closest region to Australia that offers them.
		3. Select **Review + create**, then **Create**. You need the Owner or User Access Administrator role on the resource group, because the deployment gives Tilt Base a role.
		4. Leave the Tilt Base dialog open. It connects the new resource by itself as soon as Azure has created it and applied Tilt Base's role, usually within a few minutes. **Check now** asks Azure again.
		The template creates one Speech resource named `tilt-base-` followed by ten letters and digits, on Azure's Standard (S0) pricing. Key access is turned off, so only identities you grant can use it, and public network access is on. Tilt Base gets the **Cognitive Services Speech User** role on that resource alone.
	</tab>
	<tab icon="📦">
		Use an existing resource
		1. In the dialog, select **Use an existing resource instead**.
		2. In the Azure portal, open the resource's **Access control (IAM)** page and select **Add › Add role assignment**. Choose **Cognitive Services Speech User**, then under **Members** select **Tilt Base**, and select **Review + assign**. Give the role on that resource only.
		3. If the resource has no custom domain name, generate one on its **Networking** page. Leave public network access on, because agents send recordings from their own environments.
		4. Back in Tilt Base, the dialog lists the Speech resources Tilt Base can reach, and checks again every 15 seconds, so the resource appears within a few minutes of getting the role. Select **Connect** beside it.
		A resource without a custom domain name, or in a region without Azure fast transcription, is listed but can't be connected; the dialog says why.
	</tab>
</tabs>
### 3. Add a model
If it's your first connection, Base then asks which model to add. Choose **Fast transcription**, **Azure LLM Speech** or **MAI-Transcribe-2**. A model the resource's region can't run is greyed out and says the region "does not offer enhanced mode". **Maximum speakers** sets the most speakers Azure separates, for Fast transcription and Azure LLM Speech.
## How Base uses the resource
For each recording, Base gets a Microsoft Entra access token for Tilt Base in your directory, which the agent sends with the recording; in Microsoft Copilot, Base uses it itself. Microsoft Entra sets how long it lasts, usually 60 to 90 minutes, and it works only on resources in your directory where Tilt Base has a role. Base stores no Azure key: only your directory ID and the resource's address and region.
## Change or disconnect a resource
- **Change resource**, in the connection's **…** menu or its settings, moves every model on the connection to another Speech resource once Base has checked it.
- To stop Base's access, select **Disconnect** on the connection, then remove Tilt Base's role assignment on the resource, or the Tilt Base enterprise application in Microsoft Entra.
## Troubleshooting
- **"Tilt Base was not found in that directory."** Access hasn't been granted yet, or the directory ID is wrong. Grant access, then wait a minute: Microsoft can take a moment to register it.
- **The deployment fails with an authorisation error.** You need the Owner or User Access Administrator role on the resource group.
- **The new resource hasn't connected.** Keep the dialog open and select **Check now**: Azure can take a few minutes to apply a new role. If Azure hasn't finished after 20 minutes, check the deployment in the Azure portal, then select **Check now**.
- **Azure created the resource in a region without fast transcription.** Base can't connect it. Deploy another in a region that has it.
- **An existing resource isn't listed.** Check that Tilt Base has the Cognitive Services Speech User role on that resource; a new role can take a few minutes to show. A custom role must also allow reading the resource.
- **A resource is listed but can't be connected.** The dialog says why: generate a custom domain name on its **Networking** page, or use a region with Azure fast transcription.
## Related
- <mention-page url="https://app.notion.com/p/41b4815eed4f81d59899dd4b1047e98b">Set up transcription</mention-page>
- <mention-page url="https://app.notion.com/p/41b4815eed4f81e7af6ceb8b531fabda">Transcribe a recording</mention-page>
- <mention-page url="https://app.notion.com/p/41b4815eed4f81afabbbd5e5f7927d46">How Tilt Base handles your data</mention-page>