203050 - Failed to Get VPC Firewall Rule

Agent error code #203050 indicates that the agent could not retrieve the VPC firewall rule from GCP. The error message includes additional detail about the underlying cause (e.g., authentication, authorization, resource not found, or timeout).

This error occurs during the GET phase of a grant or revocation operation, before any modification is attempted.

Common causes include:

• The firewall rule name configured in Knocknoc does not match any rule in the GCP project (see also #203151)
• The service account lacks compute.firewalls.get permission (see also #203002)
• The GCP project ID is incorrect
• Network connectivity to the GCP API failed (see also #203000, #203003)

Steps to Resolve

Verify the Firewall Rule Name

1. In the GCP Console, navigate to VPC Network > Firewall
2. Confirm a rule exists with the exact name configured in the Knocknoc ACL
3. Rule names are case-sensitive — they must match exactly

Verify the GCP Project ID

1. In the Knocknoc admin interface, check the backend configuration
2. Confirm the GCP Project ID matches the project containing the firewall rule
3. Find your project ID in the GCP Console dashboard or project selector

Check IAM Permissions

1. Ensure the service account has the compute.firewalls.get permission
2. See error #203002 for detailed IAM troubleshooting steps