> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plerion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure troubleshooting

> Troubleshoot errors in Azure subscription onboarding, workload security (CWPP) setup, and appliance lifecycle in Plerion.

With the **Azure integration**, you can onboard subscriptions for **Cloud Security Posture Management (CSPM)** and enable **workload security**—also known as **Cloud Workload Protection Platform (CWPP)**—to scan workloads for vulnerabilities. This guide explains how to resolve common errors you may encounter.

***

## Onboarding errors

The following errors may occur while onboarding Azure subscriptions using the automated CLI option.

### (AuthorizationFailed) The client ' ' with object id ' ' does not have authorization to perform action 'Microsoft.Authorization/roleAssignments/write'

<Frame>
  <img src="https://mintcdn.com/pleriondocs/rDG914-TLqofr4Lz/images/integrations/azure/troubleshoot-cli-cspm-authorization.png?fit=max&auto=format&n=rDG914-TLqofr4Lz&q=85&s=ebf64c23a4275da22dda658dc60a87a6" alt="AuthorizationFailed Error when assigning roles during onboarding" width="2880" height="354" data-path="images/integrations/azure/troubleshoot-cli-cspm-authorization.png" />
</Frame>

**Cause:** The user does not have sufficient permissions to assign required roles to the managed identity.

**Solution:** Grant the user permissions to assign roles. Plerion recommends assigning the **Owner** role in the subscription for smoother onboarding. See [Assign Azure Roles via the Azure Portal](https://docs.microsoft.com/en-us/azure/role-based-access-control/role-assignments-portal).

***

### (AuthorizationFailed) The client ' ' with object id ' ' does not have authorization to perform action 'Microsoft.Resources/subscriptions/resourcegroups/write'

<Frame>
  <img src="https://mintcdn.com/pleriondocs/rDG914-TLqofr4Lz/images/integrations/azure/troubleshoot-cli-authorization.png?fit=max&auto=format&n=rDG914-TLqofr4Lz&q=85&s=dbd3c60f1869fbf33ed9b80a2f481bae" alt="AuthorizationFailed Error when creating resource group for CWPP" width="2880" height="318" data-path="images/integrations/azure/troubleshoot-cli-authorization.png" />
</Frame>

**Cause:** The user does not have permission to create the resource group required to enable CWPP.

**Solution:** Assign the user the necessary permissions to create resource groups. Granting the **Owner** role at the subscription level is recommended. See [Assign Azure Roles via the Azure Portal](https://docs.microsoft.com/en-us/azure/role-based-access-control/role-assignments-portal).

***

### (RequestDisallowedByPolicy) Resource 'plerion-cwpp-appliance-\<plerionTenantId>-rg' was disallowed by policy

<Frame>
  <img src="https://mintcdn.com/pleriondocs/rDG914-TLqofr4Lz/images/integrations/azure/troubleshoot-cli-policy.png?fit=max&auto=format&n=rDG914-TLqofr4Lz&q=85&s=57f8ad91fbcc929d3dce60412adea2bc" alt="RequestDisallowedByPolicy Error preventing resource group creation" width="2880" height="104" data-path="images/integrations/azure/troubleshoot-cli-policy.png" />
</Frame>

**Cause:** A subscription policy blocks the creation of the required resource group. CWPP requires resource groups and managed identity names to exactly match the onboarding script.

**Solution:** Remove or adjust the policy, or create an exception to allow the resource group `plerion-cwpp-appliance-<plerionTenantId>-rg`. See [Naming Overview](https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/govern/resource-consistency/naming) for Azure resource naming conventions.

***

## CWPP integration errors

The following errors may occur when enabling workload security for an Azure subscription.

### BadCWPPConfiguration: Resources required to run CWPP capabilities have not been properly configured

**Cause:** The subscription does not contain all required resources, or the user lacks permissions during onboarding.

**Solution:** Re-run CWPP onboarding. See [Steps to add a Microsoft Azure subscription integration](/guides/integrations/azure/setting-up-azure-subscription#steps-to-add-a-microsoft-azure-subscription-integration).

***

### ProviderNotAvailable: Provider needed to run CWPP scan has not been registered

**Cause:** The `Microsoft.Compute` provider is not registered for the subscription.

**Solution:** Register the provider:

* [Register resource provider](https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/resource-providers-and-types#register-resource-provider-1)
* Or run:
  ```bash theme={"system"}
  az provider register --namespace Microsoft.Compute --subscription <your-subscription-id>
  ```

***

### AccessDenied: Plerion does not have access to the subscription

**Cause:** **Cause:** This error occurs when Plerion does not have the required permissions to access the subscription.

**Solution:**

1. Verify that the Plerion platform has the necessary subscription permissions.
2. Re-run CWPP onboarding. See [Steps to add a Microsoft Azure subscription integration](/guides/integrations/azure/setting-up-azure-subscription#steps-to-add-a-microsoft-azure-subscription-integration).

***

## Appliance lifecycle errors

The following errors may arise during CWPP appliance operation.

### OperationNotAllowed: Exceeding approved standardDSv3Family Cores quota

<Frame>
  <img src="https://mintcdn.com/pleriondocs/rDG914-TLqofr4Lz/images/integrations/azure/troubleshoot-appliance-core-quota.png?fit=max&auto=format&n=rDG914-TLqofr4Lz&q=85&s=3097b58a25af2fa571bc5d86c38208ea" alt="Error due to insufficient vCPU quota for appliance" width="1748" height="511" data-path="images/integrations/azure/troubleshoot-appliance-core-quota.png" />
</Frame>

**Cause:** Insufficient quota for `standardDSv3Family` cores in the selected region.

**Solution:** Increase the quota for that VM family in the region. See [Increase quota for regional cores](/guides/integrations/azure/prerequisites#increase-quota-for-regional-cores).

***

### PublicIPCountLimitReached: Cannot create more than x public IP addresses in this region

<Frame>
  <img src="https://mintcdn.com/pleriondocs/rDG914-TLqofr4Lz/images/integrations/azure/troubleshoot-appliance-public-ip-quota.png?fit=max&auto=format&n=rDG914-TLqofr4Lz&q=85&s=0b0c56cc2a50114a0946dd07184e974d" alt="Error due to insufficient public IP quota" width="1719" height="129" data-path="images/integrations/azure/troubleshoot-appliance-public-ip-quota.png" />
</Frame>

**Cause:** Insufficient quota for public IP addresses in the selected region.

**Solution:** Increase the quota for public IPs in that region. See [Increase quota for regional public IP addresses](/guides/integrations/azure/prerequisites#increase-quota-for-regional-public-ip-addresses).

***

### ResourceNotFound: Appliance virtual machine not found

<Frame>
  <img src="https://mintcdn.com/pleriondocs/rDG914-TLqofr4Lz/images/integrations/azure/troubleshoot-appliance-resource-not-found.png?fit=max&auto=format&n=rDG914-TLqofr4Lz&q=85&s=6d83716fe86b3228405bbca28feb88ea" alt="Error when appliance resource is deleted" width="1834" height="188" data-path="images/integrations/azure/troubleshoot-appliance-resource-not-found.png" />
</Frame>

**Cause:** The appliance VM was deleted from the subscription.

**Solution:** Do not delete CWPP appliances. Removing them will cause scans to fail.

***

### ApplianceTimeout: Appliance timed out

<Frame>
  <img src="https://mintcdn.com/pleriondocs/rDG914-TLqofr4Lz/images/integrations/azure/troubleshoot-appliance-timed-out.png?fit=max&auto=format&n=rDG914-TLqofr4Lz&q=85&s=ebeec940ef06ec8b8574818b8710d674" alt="Error when appliance times out during scan" width="1612" height="92" data-path="images/integrations/azure/troubleshoot-appliance-timed-out.png" />
</Frame>

**Cause:** Workload scans exceeding 3 hours cause the appliance to timeout.

**Solution:** Contact Plerion Support if this error persists. Support can extend the timeout limit if required.

***

### InternalError: Appliance failed with unknown error

<Frame>
  <img src="https://mintcdn.com/pleriondocs/rDG914-TLqofr4Lz/images/integrations/azure/troubleshoot-appliance-internal-error.png?fit=max&auto=format&n=rDG914-TLqofr4Lz&q=85&s=979e6de2cbef69c4301d752a3ef337ae" alt="Error when appliance fails internally" width="1804" height="103" data-path="images/integrations/azure/troubleshoot-appliance-internal-error.png" />
</Frame>

**Cause:** Internal error in the appliance.

**Solution:** The appliance usually recovers automatically in the next scan. Contact Plerion Support if the issue persists.
