Skip to content

Commit e4d5c5a

Browse files
author
TuannasCodeCatastrophe
committed
Feat Insomnia Add scopes required
1 parent c3fe640 commit e4d5c5a

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

app/insomnia/external-vault.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -157,11 +157,26 @@ For HashiCorp, the environment variables to define for Inso CLI depend on the pl
157157

158158
## Azure Key Vault
159159

160+
When you connect Insomnia to Azure Key Vault, Azure prompts for OAuth consent in a browser. The requested scopes define the permissions Insomnia uses to authenticate and access secrets.
161+
162+
Use the following required scopes:
163+
- `openid`: Support sign-in with Microsoft Entra ID.
164+
- `profile`: Provide basic account information that's required for authentication.
165+
- `offline_access`: Allow authentication to persist without repeated sign-in.
166+
- `user_impersonation`: Grant delegated access to Azure Key Vault and allow secret retrieval using the signed-in user’s existing permissions.
167+
168+
Azure enforces these permissions during consent and applies Key Vault access control based on the user’s assigned roles. For more information about required scopes, go to [Scopes and permissions](https://learn.microsoft.com/en-us/entra/identity-platform/scopes-oidc).
169+
170+
To choose Azure Key Vault:
160171
1. Navigate to **Preferences > Cloud Credentials**.
161172
1. Click **Add Credentials**, select **Azure**.
162173
1. You will be redirected to authorize Insomnia in your browser.
163174
1. After authorization, you'll return to Insomnia with your Azure account credential added.
164175

176+
{:.info}
177+
> Azure Key Vault access uses delegated permissions. The Azure account that you sign in with in Insomnia, the Azure app registration, and the Azure Key Vault must belong to the same Azure organization, unless cross-organization access is explicitly configured in Azure. If these are in different organizations, Azure can deny access even when the correct scopes are granted.
178+
179+
165180
## Using secrets
166181

167182
External vault secrets can be referenced anywhere in Insomnia requests using [template tags](/insomnia/template-tags/). In the field of your choice:

0 commit comments

Comments
 (0)