Skip to main content
Version: 3.9.x

Permission Policy Actions and Resources

This reference catalogs every action and resource ARN that can appear in an API7 Gateway permission policy. Use it as the authoritative source when authoring policies — every action listed here is enforced by the Control Plane, and every resource ARN follows the exact format the policy engine accepts.

Permissions are organized into three namespaces:

NamespacePurpose
gateway:Data plane configuration — gateway groups, services, routes, consumers, plugins, certificates, alerts
iam:Identity and organization — users, roles, permission policies, license, audit logs, login options, SMTP, contact points
portal:Developer Portal — portals, API products, developers, DCR providers, portal tokens

Wildcards are expressed as * (literal wildcard in the resource path) or <regex> (regular expression enclosed in angle brackets, applied at match time). For example, arn:api7:gateway:gatewaygroup/<.*> matches every gateway group, while arn:api7:gateway:gatewaygroup/* is used in creation statements where there is no specific target yet.

gateway: namespace​

Gateway Group​

ActionResource
gateway:GetGatewayGrouparn:api7:gateway:gatewaygroup/%s
gateway:CreateGatewayGrouparn:api7:gateway:gatewaygroup/*
gateway:UpdateGatewayGrouparn:api7:gateway:gatewaygroup/%s
gateway:DeleteGatewayGrouparn:api7:gateway:gatewaygroup/%s
gateway:GetAdminKeyarn:api7:gateway:gatewaygroup/%s

Gateway Instance​

ActionResource
gateway:GetGatewayInstancearn:api7:gateway:gatewaygroup/%s
gateway:GetGatewayInstanceCorearn:api7:gateway:gatewaygroup/*
gateway:CreateGatewayInstancearn:api7:gateway:gatewaygroup/%s
gateway:DeleteGatewayInstancearn:api7:gateway:gatewaygroup/%s

Consumer​

ActionResource
gateway:GetConsumerarn:api7:gateway:gatewaygroup/%s/consumer/%s
gateway:CreateConsumerarn:api7:gateway:gatewaygroup/%s/consumer/*
gateway:UpdateConsumerarn:api7:gateway:gatewaygroup/%s/consumer/%s
gateway:DeleteConsumerarn:api7:gateway:gatewaygroup/%s/consumer/%s

Consumer Credential​

ActionResource
gateway:GetConsumerCredentialarn:api7:gateway:gatewaygroup/%s/consumer/%s
gateway:CreateConsumerCredentialarn:api7:gateway:gatewaygroup/%s/consumer/%s
gateway:UpdateConsumerCredentialarn:api7:gateway:gatewaygroup/%s/consumer/%s
gateway:DeleteConsumerCredentialarn:api7:gateway:gatewaygroup/%s/consumer/%s

SSL Certificate​

ActionResource
gateway:GetSSLCertificatearn:api7:gateway:gatewaygroup/%s
gateway:CreateSSLCertificatearn:api7:gateway:gatewaygroup/%s
gateway:UpdateSSLCertificatearn:api7:gateway:gatewaygroup/%s
gateway:DeleteSSLCertificatearn:api7:gateway:gatewaygroup/%s

Certificate​

ActionResource
gateway:GetCertificatearn:api7:gateway:gatewaygroup/%s
gateway:CreateCertificatearn:api7:gateway:gatewaygroup/%s
gateway:UpdateCertificatearn:api7:gateway:gatewaygroup/%s
gateway:DeleteCertificatearn:api7:gateway:gatewaygroup/%s

CA Certificate​

ActionResource
gateway:GetCACertificatearn:api7:gateway:gatewaygroup/%s
gateway:CreateCACertificatearn:api7:gateway:gatewaygroup/%s
gateway:UpdateCACertificatearn:api7:gateway:gatewaygroup/%s
gateway:DeleteCACertificatearn:api7:gateway:gatewaygroup/%s

SNI​

ActionResource
gateway:GetSNIarn:api7:gateway:gatewaygroup/%s
gateway:CreateSNIarn:api7:gateway:gatewaygroup/%s
gateway:UpdateSNIarn:api7:gateway:gatewaygroup/%s
gateway:DeleteSNIarn:api7:gateway:gatewaygroup/%s

Global Plugin Rule​

ActionResource
gateway:GetGlobalPluginRulearn:api7:gateway:gatewaygroup/%s
gateway:CreateGlobalPluginRulearn:api7:gateway:gatewaygroup/%s
gateway:UpdateGlobalPluginRulearn:api7:gateway:gatewaygroup/%s
gateway:DeleteGlobalPluginRulearn:api7:gateway:gatewaygroup/%s

Plugin Metadata​

ActionResource
gateway:GetPluginMetadataarn:api7:gateway:gatewaygroup/%s
gateway:UpdatePluginMetadataarn:api7:gateway:gatewaygroup/%s
gateway:DeletePluginMetadataarn:api7:gateway:gatewaygroup/%s

Service Registry​

ActionResource
gateway:GetServiceRegistryarn:api7:gateway:gatewaygroup/%s
gateway:ConnectServiceRegistryarn:api7:gateway:gatewaygroup/%s
gateway:UpdateServiceRegistryarn:api7:gateway:gatewaygroup/%s
gateway:DisconnectServiceRegistryarn:api7:gateway:gatewaygroup/%s

Secret Provider​

ActionResource
gateway:GetSecretProviderarn:api7:gateway:gatewaygroup/%s/secret_provider/%s
gateway:PutSecretProviderarn:api7:gateway:gatewaygroup/%s/secret_provider/%s
gateway:DeleteSecretProviderarn:api7:gateway:gatewaygroup/%s/secret_provider/%s

Proto​

For gRPC service definitions used by the grpc-transcode and proto plugins.

ActionResource
gateway:GetProtoarn:api7:gateway:gatewaygroup/%s
gateway:CreateProtoarn:api7:gateway:gatewaygroup/%s
gateway:UpdateProtoarn:api7:gateway:gatewaygroup/%s
gateway:DeleteProtoarn:api7:gateway:gatewaygroup/%s

Debug Session​

For online request debugging and trace capture.

ActionResource
gateway:GetDebugSessionarn:api7:gateway:gatewaygroup/%s
gateway:CreateDebugSessionarn:api7:gateway:gatewaygroup/%s
gateway:StopDebugSessionarn:api7:gateway:gatewaygroup/%s
gateway:DeleteDebugSessionarn:api7:gateway:gatewaygroup/%s
gateway:ExportDebugSessionarn:api7:gateway:gatewaygroup/%s

Service Template​

Service templates define reusable service configurations, including their routes and stream routes. See the Service Manager example for the difference between a Service Template ID and a Published Service ID, and how to use each in permission policies.

ActionResource
gateway:GetServiceTemplatearn:api7:gateway:servicetemplate/%s
gateway:CreateServiceTemplatearn:api7:gateway:servicetemplate/*
gateway:UpdateServiceTemplatearn:api7:gateway:servicetemplate/%s
gateway:DeleteServiceTemplatearn:api7:gateway:servicetemplate/%s

Published Service​

A published service is a service template that has been deployed to a specific gateway group. The same four actions cover the service's routes and stream routes.

ActionResource
gateway:GetPublishedServicearn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway:CreatePublishedServicearn:api7:gateway:gatewaygroup/%s/publishedservice/*
gateway:UpdatePublishedServicearn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway:DeletePublishedServicearn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway:PublishServicesarn:api7:gateway:gatewaygroup/%s/publishedservice/*

Deployment Settings​

System-wide gateway deployment settings.

ActionResource
gateway:UpdateDeploymentSettingarn:api7:gateway:gatewaysetting/*

Custom Plugin​

ActionResource
gateway:CreateCustomPluginarn:api7:gateway:gatewaysetting/*
gateway:UpdateCustomPluginarn:api7:gateway:gatewaysetting/*
gateway:DeleteCustomPluginarn:api7:gateway:gatewaysetting/*

Alert Policy​

ActionResource
gateway:GetAlertPolicyarn:api7:gateway:alert/%s
gateway:CreateAlertPolicyarn:api7:gateway:alert/*
gateway:UpdateAlertPolicyarn:api7:gateway:alert/%s
gateway:DeleteAlertPolicyarn:api7:gateway:alert/%s

Webhook Template​

Reusable webhook payload templates used by alert contact points.

ActionResource
gateway:GetWebhookTemplatearn:api7:gateway:gatewaysetting/*
gateway:CreateWebhookTemplatearn:api7:gateway:gatewaysetting/*
gateway:UpdateWebhookTemplatearn:api7:gateway:gatewaysetting/*
gateway:DeleteWebhookTemplatearn:api7:gateway:gatewaysetting/*

iam: namespace​

User​

ActionResource
iam:GetUserarn:api7:iam:user/%s
iam:InviteUserarn:api7:iam:user/*
iam:UpdateUserarn:api7:iam:user/%s
iam:DeleteUserarn:api7:iam:user/%s
iam:UpdateUserRolearn:api7:iam:user/%s
iam:ResetPasswordarn:api7:iam:user/%s
iam:UpdateUserBoundaryarn:api7:iam:user/%s

Role​

ActionResource
iam:GetRolearn:api7:iam:role/%s
iam:CreateRolearn:api7:iam:role/*
iam:UpdateRolearn:api7:iam:role/%s
iam:DeleteRolearn:api7:iam:role/%s

Permission Policy​

ActionResource
iam:GetPermissionPolicyarn:api7:iam:permissionpolicy/%s
iam:CreatePermissionPolicyarn:api7:iam:permissionpolicy/*
iam:UpdatePermissionPolicyarn:api7:iam:permissionpolicy/%s
iam:DeletePermissionPolicyarn:api7:iam:permissionpolicy/%s

License​

ActionResource
iam:UpdateLicensearn:api7:iam:organization/*

Audit Log​

ActionResource
iam:GetAuditarn:api7:iam:organization/*
iam:ExportAuditsarn:api7:iam:organization/*

Login Option​

Login options configure authentication methods for the Dashboard (OIDC, SAML, LDAP, CAS).

ActionResource
iam:GetLoginOptionarn:api7:iam:organization/*
iam:CreateLoginOptionarn:api7:iam:organization/*
iam:UpdateLoginOptionarn:api7:iam:organization/*
iam:DeleteLoginOptionarn:api7:iam:organization/*

SCIM Provisioning​

ActionResource
iam:GetSCIMProvisioningarn:api7:iam:organization/*
iam:UpdateSCIMProvisioningarn:api7:iam:organization/*

SMTP Server​

Used for outbound email notifications and user invitations.

ActionResource
iam:GetSMTPServerarn:api7:iam:organization/*
iam:UpdateSMTPServerarn:api7:iam:organization/*

Contact Point​

Contact points are alert notification targets (email, webhook, etc.) referenced by alert policies.

ActionResource
iam:GetContactPointarn:api7:iam:contactpoint/%s
iam:CreateContactPointarn:api7:iam:contactpoint/*
iam:UpdateContactPointarn:api7:iam:contactpoint/%s
iam:DeleteContactPointarn:api7:iam:contactpoint/%s

portal: namespace​

Portal​

ActionResource
portal:GetPortalarn:api7:portal:portal/%s
portal:CreatePortalarn:api7:portal:portal/*
portal:UpdatePortalarn:api7:portal:portal/%s
portal:DeletePortalarn:api7:portal:portal/%s

Portal Token​

ActionResource
portal:GetPortalTokenarn:api7:portal:portal/%s/token/*
portal:CreatePortalTokenarn:api7:portal:portal/%s/token/*
portal:UpdatePortalTokenarn:api7:portal:portal/%s/token/*
portal:DeletePortalTokenarn:api7:portal:portal/%s/token/*

API Product​

ActionResource
portal:GetAPIProductarn:api7:portal:portal/%s/apiproduct/%s
portal:CreateAPIProductarn:api7:portal:portal/%s/apiproduct/*
portal:UpdateAPIProductarn:api7:portal:portal/%s/apiproduct/%s
portal:DeleteAPIProductarn:api7:portal:portal/%s/apiproduct/%s

Developer​

ActionResource
portal:GetDeveloperarn:api7:portal:portal/%s/developer/%s
portal:InviteDeveloperarn:api7:portal:portal/%s/developer/*
portal:DeleteDeveloperarn:api7:portal:portal/%s/developer/%s

DCR Provider​

Dynamic Client Registration providers used by the Developer Portal.

ActionResource
portal:GetDCRProviderarn:api7:portal:dcrprovider/*
portal:CreateDCRProviderarn:api7:portal:dcrprovider/*
portal:UpdateDCRProviderarn:api7:portal:dcrprovider/*
portal:DeleteDCRProviderarn:api7:portal:dcrprovider/*

Developer Login Option​

Configures authentication methods that developers can use to sign in to a Developer Portal.

ActionResource
portal:GetDeveloperLoginOptionarn:api7:portal:portal/%s/loginsetting/*
portal:CreateDeveloperLoginOptionarn:api7:portal:portal/%s/loginsetting/*
portal:UpdateDeveloperLoginOptionarn:api7:portal:portal/%s/loginsetting/*
portal:DeleteDeveloperLoginOptionarn:api7:portal:portal/%s/loginsetting/*

Developer SCIM Provisioning​

ActionResource
portal:GetDeveloperSCIMProvisioningarn:api7:portal:portal/%s/loginsetting/*
portal:UpdateDeveloperSCIMProvisioningarn:api7:portal:portal/%s/loginsetting/*

Developer Portal Public Access​

Controls whether a Developer Portal is publicly accessible without login.

ActionResource
portal:GetDeveloperPortalPublicAccessarn:api7:portal:portal/%s/loginsetting/*
portal:UpdateDeveloperPortalPublicAccessarn:api7:portal:portal/%s/loginsetting/*

Approvals​

Approve pending API product subscriptions or new developer sign-ups.

ActionResource
portal:ApproveAPIProductSubscriptionarn:api7:portal:portal/%s/apiproduct/%s
portal:ApproveDeveloperSignUparn:api7:portal:portal/%s/developer/*

Next steps​