Reference documentation and code samples for the Google Cloud Network Security V1 Client class AuthzPolicy.
AuthzPolicy
is a resource that allows to forward traffic to a
callout backend designed to scan the traffic for security purposes.
Generated from protobuf message google.cloud.networksecurity.v1.AuthzPolicy
Namespace
Google \ Cloud \ NetworkSecurity \ V1Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ name
string
Required. Identifier. Name of the AuthzPolicy
resource in the following format: projects/{project}/locations/{location}/authzPolicies/{authz_policy}
.
↳ create_time
↳ update_time
↳ description
string
Optional. A human-readable description of the resource.
↳ labels
array| Google\Protobuf\Internal\MapField
Optional. Set of labels associated with the AuthzPolicy
resource. The format must comply with the following requirements
.
↳ target
AuthzPolicy\Target
Required. Specifies the set of resources to which this policy should be applied to.
↳ http_rules
array< AuthzPolicy\AuthzRule
>
Optional. A list of authorization HTTP rules to match against the incoming request. A policy match occurs when at least one HTTP rule matches the request or when no HTTP rules are specified in the policy. At least one HTTP Rule is required for Allow or Deny Action. Limited to 5 rules.
↳ action
int
Required. Can be one of ALLOW
, DENY
, CUSTOM
. When the action is CUSTOM
, customProvider
must be specified. When the action is ALLOW
, only requests matching the policy will be allowed. When the action is DENY
, only requests matching the policy will be denied. When a request arrives, the policies are evaluated in the following order: 1. If there is a CUSTOM
policy that matches the request, the CUSTOM
policy is evaluated using the custom authorization providers and the request is denied if the provider rejects the request. 2. If there are any DENY
policies that match the request, the request is denied. 3. If there are no ALLOW
policies for the resource or if any of the ALLOW
policies match the request, the request is allowed. 4. Else the request is denied by default if none of the configured AuthzPolicies with ALLOW
action match the request.
↳ custom_provider
AuthzPolicy\CustomProvider
Optional. Required if the action is CUSTOM
. Allows delegating authorization decisions to Cloud IAP or to Service Extensions. One of cloudIap
or authzExtension
must be specified.
↳ policy_profile
int
Optional. Immutable. Defines the type of authorization being performed. If not specified, REQUEST_AUTHZ
is applied. This field cannot be changed once AuthzPolicy is created.
getName
Required. Identifier. Name of the AuthzPolicy
resource in the following
format: projects/{project}/locations/{location}/authzPolicies/{authz_policy}
.
string
setName
Required. Identifier. Name of the AuthzPolicy
resource in the following
format: projects/{project}/locations/{location}/authzPolicies/{authz_policy}
.
var
string
$this
getCreateTime
Output only. The timestamp when the resource was created.
hasCreateTime
clearCreateTime
setCreateTime
Output only. The timestamp when the resource was created.
$this
getUpdateTime
Output only. The timestamp when the resource was updated.
hasUpdateTime
clearUpdateTime
setUpdateTime
Output only. The timestamp when the resource was updated.
$this
getDescription
Optional. A human-readable description of the resource.
string
setDescription
Optional. A human-readable description of the resource.
var
string
$this
getLabels
Optional. Set of labels associated with the AuthzPolicy
resource.
The format must comply with the following requirements .
setLabels
Optional. Set of labels associated with the AuthzPolicy
resource.
The format must comply with the following requirements .
$this
getTarget
Required. Specifies the set of resources to which this policy should be applied to.
hasTarget
clearTarget
setTarget
Required. Specifies the set of resources to which this policy should be applied to.
$this
getHttpRules
Optional. A list of authorization HTTP rules to match against the incoming request. A policy match occurs when at least one HTTP rule matches the request or when no HTTP rules are specified in the policy.
At least one HTTP Rule is required for Allow or Deny Action. Limited to 5 rules.
setHttpRules
Optional. A list of authorization HTTP rules to match against the incoming request. A policy match occurs when at least one HTTP rule matches the request or when no HTTP rules are specified in the policy.
At least one HTTP Rule is required for Allow or Deny Action. Limited to 5 rules.
$this
getAction
Required. Can be one of ALLOW
, DENY
, CUSTOM
.
When the action is CUSTOM
, customProvider
must be specified.
When the action is ALLOW
, only requests matching the policy will
be allowed.
When the action is DENY
, only requests matching the policy will be
denied.
When a request arrives, the policies are evaluated in the following order:
- If there is a
CUSTOMpolicy that matches the request, theCUSTOMpolicy is evaluated using the custom authorization providers and the request is denied if the provider rejects the request. - If there are any
DENYpolicies that match the request, the request is denied. - If there are no
ALLOWpolicies for the resource or if any of theALLOWpolicies match the request, the request is allowed. - Else the request is denied by default if none of the configured
AuthzPolicies with
ALLOWaction match the request.
setAction
Required. Can be one of ALLOW
, DENY
, CUSTOM
.
When the action is CUSTOM
, customProvider
must be specified.
When the action is ALLOW
, only requests matching the policy will
be allowed.
When the action is DENY
, only requests matching the policy will be
denied.
When a request arrives, the policies are evaluated in the following order:
- If there is a
CUSTOMpolicy that matches the request, theCUSTOMpolicy is evaluated using the custom authorization providers and the request is denied if the provider rejects the request. - If there are any
DENYpolicies that match the request, the request is denied. - If there are no
ALLOWpolicies for the resource or if any of theALLOWpolicies match the request, the request is allowed. - Else the request is denied by default if none of the configured
AuthzPolicies with
ALLOWaction match the request.
$this
getCustomProvider
Optional. Required if the action is CUSTOM
. Allows delegating
authorization decisions to Cloud IAP or to Service Extensions. One of cloudIap
or authzExtension
must be specified.
hasCustomProvider
clearCustomProvider
setCustomProvider
Optional. Required if the action is CUSTOM
. Allows delegating
authorization decisions to Cloud IAP or to Service Extensions. One of cloudIap
or authzExtension
must be specified.
$this
getPolicyProfile
Optional. Immutable. Defines the type of authorization being performed.
If not specified, REQUEST_AUTHZ
is applied. This field cannot be changed
once AuthzPolicy is created.
setPolicyProfile
Optional. Immutable. Defines the type of authorization being performed.
If not specified, REQUEST_AUTHZ
is applied. This field cannot be changed
once AuthzPolicy is created.
$this

