Connect Azure OpenAI

≈ 5 min Extension Web app JWT

Before you start

• An Azure subscription with an Azure OpenAI resource and at least one model deployment.

Used by

• Chat Azure OpenAI
• Aria and agents (Settings › Providers)

Pick a method

Method	Use it when
Aria & agents Recommended	Chat with Aria or an agent on Azure OpenAI models. The key is kept in Settings › Providers.
Workflow nodes	Use Chat Azure OpenAI in a workflow. The key is a saved credential.

Set it up

Aria & agents (recommended)

1. Create a key. In the Azure portal, open your Azure OpenAI resource, go to Keys and Endpoint and copy KEY 1. Note the resource (instance) name and the name of a model deployment.
2. Open Settings › Providers and click + Add provider.
3. Pick Azure OpenAI as the Provider, give it a Label and paste the key into API key.
4. Type the Model id, the instance name and the deployment name, then click Add.
5. Optionally click Set as default, so Aria and agents set to Same as Aria use it.

Check it's connected — 

Open a chat, pick the provider’s model in the model menu and send Hello: the reply comes from Azure OpenAI. A wrong key shows a provider error in the chat right away.

Workflow nodes

1. Create a key. In the Azure portal, open your Azure OpenAI resource, go to Keys and Endpoint and copy KEY 1. Note the resource (instance) name and the name of a model deployment.

2. Save it in AWFlow. Open Credentials and click Add Credential (or + Add Credential in the node’s Authentication field), then fill the New Credential form. In the browser side panel the form comes in two steps: tap Simple Credential (or click Continue), then fill the rest.

   123456

   1. 1 Step 1:Keep it a simple credential Leave Integration App / Service on Select an integration..., or pick Simple Credential at the top of its list.
   2. 2 Step 2:Name it For example Azure OpenAI – personal. A Description is optional.
   3. 3 Step 3:Set Auth Type to JWT Open Auth Type and choose JWT.
   4. 4 Step 4:Paste the key Paste the key into JWT, exactly as copied.
   5. 5 Step 5:Check where it is saved Signed in, choose Local (this browser only) or Cloud (synced to your account) under Storage location. Without an account it is saved locally in this browser, as here.
   6. 6 Step 6:Click Create Credential Check: the credential is listed on the Credentials page, ready to pick in nodes.

   Numbered areas in the screenshot: 1. Integration App / Service: none (Simple Credential); 2. Name; 3. Auth Type: JWT; 4. JWT; 5. Where the secret is stored (here, locally in this browser); 6. Create Credential.

3. Pick it in the node. In Chat Azure OpenAI, choose the credential in Authentication and type the Model id.

Check it's connected — 

Connect Chat Azure OpenAI to an AI node (for example a Basic LLM Chain with the prompt Say hello) and click Test step on the AI node: you get a reply.

Where your token lives

Where your token lives — 

The credential is stored where you choose when you create it:

• Local (this browser only): encrypted in this browser. The encryption key is kept on the same device, so turn on the local secret vault to lock it with a passphrase only you know.
• Cloud (synced to your account): sent over an encrypted connection and stored encrypted on AWFlow’s server, so it works on your other devices.

When a step runs, your browser sends it only to <your-resource>.openai.azure.com. AWFlow’s servers never relay the call.

Keys added in Settings › Providers are separate: they stay on this device only, encrypted, and are never synced to your account.

Privacy & your data →

Common issues

• A 401, “invalid API key” or “Incorrect API key” error. The key was mistyped, revoked, or belongs to another account. Create a new key and update the credential (or the provider in Settings › Providers).
• A 429 or “quota” error. The account is out of credit or over its rate limit. Add credit or wait, then run again.
• An embeddings node fails with 401 while a chat node with the same key works. The credential is a Bearer Token. Embeddings nodes pass the value to the provider as it is, so use a JWT credential that holds only the key.
• “DeploymentNotFound” or 404. The deployment name is wrong, or it belongs to another resource. Copy it from Azure AI Foundry › Deployments.

Related

Chat Azure OpenAI node

All connections

Create and manage credentials

Privacy & your data