Get an Enterprise workspace
Enterprise onboarding is currently sales-assisted. The first IT administrator creates an OpenWhispr account in the desktop app and creates the customer workspace. OpenWhispr then activates that existing workspace as Enterprise and confirms its owner. The owner opens the admin portal and configures SSO, SCIM, policy, and cloud trust. Employees do not configure any of those systems: once IT assigns them, they choose company SSO and receive their workspace, teams, and managed models automatically.How access works
- Your identity provider assigns the employee through SCIM, or SSO admits them through the temporary just-in-time fallback during a pilot.
- The employee signs in to OpenWhispr with company SSO.
- OpenWhispr issues a five-minute assertion for that workspace and provider.
- AWS STS or Microsoft Entra exchanges it for short-lived cloud access.
- The desktop sends the model request, or the audio for Azure transcription, directly to Bedrock or Azure.
Before you start
You need:- an active OpenWhispr Enterprise workspace; SSO, SCIM, and managed cloud access are not enforced on Business or Pro workspaces
- a verified SAML or OIDC provider; managed cloud assertions require a current company SSO session
- SCIM directory sync, recommended with just-in-time fallback off after rollout
- permission to create AWS IAM federation or a Microsoft Entra workload identity
- deployed and approved models in the cloud region or Azure resource you will use
Configure Amazon Bedrock
1
Create the OpenWhispr OIDC provider in AWS
In AWS IAM, add an OpenID Connect identity provider. Use the issuer shown by OpenWhispr as the provider URL and
sts.amazonaws.com as its audience.AWS must be able to reach the issuer discovery and JWKS endpoints over HTTPS. See AWS’s OIDC provider guide.2
Create a least-privilege Bedrock role
Create a web-identity IAM role in the same AWS account as the OIDC provider. Grant access only to the models or inference profiles your workspace needs.Typical runtime actions are
bedrock:InvokeModel and bedrock:InvokeModelWithResponseStream. If employees may browse the Bedrock catalog, also allow bedrock:ListFoundationModels and bedrock:ListInferenceProfiles.Cross-region inference needs permission for both the inference-profile ARN and its destination foundation-model ARNs. Make sure organization SCP region restrictions permit every destination, and review the destination geography with your security and data-residency teams before rollout.3
Apply the generated trust policy
Enter the role ARN in OpenWhispr. The admin portal generates a trust policy constrained to the OpenWhispr issuer,
sts.amazonaws.com audience, and workspace:<workspace-id> subject.Copy that policy to the IAM role. These conditions prevent an assertion for another workspace from assuming it.4
Choose the permitted models
Enter the AWS region and each allowed Bedrock model or inference profile ID, one per line. Commercial AWS and AWS GovCloud are supported; the role ARN partition must match the region. AWS China is not supported. The managed desktop configuration cannot invoke a model outside this list.Choose a default for dictation cleanup, dictation agent, note formatting, note chat, and translation.
5
Roll out and test
Save the provider as Configured, not active, allow Bedrock under Policies > AI providers, and select Validate cloud access. OpenWhispr verifies the AWS identity exchange and Bedrock control-plane access. The employee pilot confirms that the permitted model or inference profile can run; invocation permissions and destination-region service control policies still apply.Start the pilot with Managed by default and leave Allow manual setup on. Have a SCIM-assigned employee sign in with company SSO. When the pilot succeeds, turn manual setup off or choose Managed required. Revalidate after changing any trust or provider value.
Configure Azure OpenAI
1
Create a workload identity
Create a Microsoft Entra app registration or a user-assigned managed identity. Do not create a client secret.Record the Entra tenant ID and the application’s client ID, or the user-assigned identity’s client ID.
2
Grant Azure OpenAI inference access
On the intended Azure OpenAI resource, assign the workload identity the Cognitive Services OpenAI User role. Scope the assignment to the resource where possible.Azure role changes can take several minutes to propagate. See Microsoft’s Azure OpenAI Entra authentication guide.
3
Add the generated federated credential
In OpenWhispr, enter the tenant ID and client ID. Copy the generated federated credential JSON.Add it under Federated credentials on the app registration or user-assigned managed identity. The issuer, subject, and
api://AzureADTokenExchange audience are case-sensitive and must match exactly. Choose the Other issuer scenario when the portal asks.4
Configure the resource and deployments
Enter the Azure OpenAI HTTPS endpoint and use API version
v1 for stable APIs, or preview only when a required feature is preview-only.Enter only the public Azure resource origin, such as https://acme.openai.azure.com. Azure OpenAI (.openai.azure.com), Azure AI services (.cognitiveservices.azure.com), and Azure AI Foundry (.services.ai.azure.com) hosts are accepted. Do not add /openai, /openai/v1, a deployment path, query parameters, or credentials. OpenWhispr adds the API path itself. Azure Government and other Azure clouds are not currently supported.Then turn on Text processing, Transcription, or both:- Text processing: add each permitted deployment name, one per line, then choose a default deployment for all five OpenWhispr text features.
- Transcription: add each permitted transcription deployment, such as
gpt-4o-transcribe, then choose the default. See Azure transcription for what it covers.
5
Roll out and test
Save Azure as Configured, not active. Under Policies > AI providers, allow Enterprise cloud in the AI text & agents policy, the Transcription policy, or both, to match what you turned on. Then select Validate cloud access. OpenWhispr verifies the Entra token exchange, access to the exact Azure resource, and that every listed deployment exists.Start with Managed by default and Allow manual setup on, then test with a SCIM-assigned employee using a fresh company SSO session. After the pilot, turn manual setup off or choose Managed required. Revalidate after changing any tenant, identity, endpoint, version, or deployment value.
Azure transcription
Azure can also turn speech into text. Audio goes straight from the desktop to your Azure resource using the same short-lived Entra token, with no key on the device. Bedrock is for AI text only. Employees need OpenWhispr 1.10 or later.
Use a transcription model deployed through Azure OpenAI or Azure AI Foundry, such as
gpt-4o-transcribe. Employees see it as Enterprise cloud in the desktop’s speech-to-text settings.
Note recording keeps its own speech-to-text mode. If the Transcription policy allows only Enterprise cloud, the app tells employees that it doesn’t cover meeting recording yet. Allow a second transcription mode if they need to record notes.
Choose a rollout mode
Any active managed mode requires a verified company SSO provider and a workspace policy that allows the selected enterprise cloud. Managed required also requires Require SSO and a successful validation of the exact cloud configuration within the previous 30 minutes. The admin portal shows these checks before it allows activation.
Allow manual setup preserves the existing AWS profile/access-key and Azure API-key flow during migration. Existing manual users are not silently switched until managed access becomes required. Employees without a manual configuration receive the managed provider by default.
Rotate, switch, or roll back
- AWS role change: create the new role and apply the generated trust policy, enter the new ARN and validate the draft, save it, then remove the old trust.
- Azure identity change: create the new identity, add the generated federated credential and resource role, enter its client ID and validate the draft, save it, then remove the old credential or role assignment.
- Model change: add the new model or deployment, set all affected defaults, save, then remove the old item.
- Provider switch: save the inactive provider first, set the active provider to Configured, not active, then activate the other. The API prevents two active providers.
- Emergency rollback: choose Configured, not active. Existing manual access remains available only when your policy and Allow manual setup permit it.