Reference documentation and code samples for the Identity-Aware Proxy V1 API class Google::Cloud::Iap::V1::AttributePropagationSettings.
Configuration for propagating attributes to applications protected
by IAP.
Inherits
Object
Extended By
Google::Protobuf::MessageExts::ClassMethods
Includes
Google::Protobuf::MessageExts
Methods
#enable
defenable()->::Boolean
Returns
(::Boolean) — Optional. Whether the provided attribute propagation settings should be
evaluated on user requests. If set to true, attributes returned from the
expression will be propagated in the set output credentials.
#enable=
defenable=(value)->::Boolean
Parameter
value (::Boolean) — Optional. Whether the provided attribute propagation settings should be
evaluated on user requests. If set to true, attributes returned from the
expression will be propagated in the set output credentials.
Returns
(::Boolean) — Optional. Whether the provided attribute propagation settings should be
evaluated on user requests. If set to true, attributes returned from the
expression will be propagated in the set output credentials.
#expression
defexpression()->::String
Returns
(::String) — Optional. Raw string CEL expression. Must return a list of attributes. A
maximum of 45 attributes can be selected. Expressions can select different
attribute types from attributes: attributes.saml_attributes,
attributes.iap_attributes. The following functions are supported:
filter <list>.filter(<iter_var>, <predicate>): Returns a subset of
<list> where <predicate> is true for every item.
in <var> in <list>: Returns true if <list> contains <var>.
selectByName <list>.selectByName(<string>): Returns the attribute
in
<list> with the given <string> name, otherwise returns empty.
emitAs <attribute>.emitAs(<string>): Sets the <attribute> name
field to the given <string> for propagation in selected output
credentials.
strict <attribute>.strict(): Ignores the x-goog-iap-attr- prefix
for the provided <attribute> when propagating with the HEADER output
credential, such as request headers.
append <target_list>.append(<attribute>) OR
<target_list>.append(<list>): Appends the provided <attribute> or
<list> to the end of <target_list>.
Example expression: attributes.saml_attributes.filter(x, x.name in
['test']).append(attributes.iap_attributes.selectByName('exact').emitAs('custom').strict())
#expression=
defexpression=(value)->::String
Parameter
value (::String) — Optional. Raw string CEL expression. Must return a list of attributes. A
maximum of 45 attributes can be selected. Expressions can select different
attribute types from attributes: attributes.saml_attributes,
attributes.iap_attributes. The following functions are supported:
filter <list>.filter(<iter_var>, <predicate>): Returns a subset of
<list> where <predicate> is true for every item.
in <var> in <list>: Returns true if <list> contains <var>.
selectByName <list>.selectByName(<string>): Returns the attribute
in
<list> with the given <string> name, otherwise returns empty.
emitAs <attribute>.emitAs(<string>): Sets the <attribute> name
field to the given <string> for propagation in selected output
credentials.
strict <attribute>.strict(): Ignores the x-goog-iap-attr- prefix
for the provided <attribute> when propagating with the HEADER output
credential, such as request headers.
append <target_list>.append(<attribute>) OR
<target_list>.append(<list>): Appends the provided <attribute> or
<list> to the end of <target_list>.
Example expression: attributes.saml_attributes.filter(x, x.name in
['test']).append(attributes.iap_attributes.selectByName('exact').emitAs('custom').strict())
Returns
(::String) — Optional. Raw string CEL expression. Must return a list of attributes. A
maximum of 45 attributes can be selected. Expressions can select different
attribute types from attributes: attributes.saml_attributes,
attributes.iap_attributes. The following functions are supported:
filter <list>.filter(<iter_var>, <predicate>): Returns a subset of
<list> where <predicate> is true for every item.
in <var> in <list>: Returns true if <list> contains <var>.
selectByName <list>.selectByName(<string>): Returns the attribute
in
<list> with the given <string> name, otherwise returns empty.
emitAs <attribute>.emitAs(<string>): Sets the <attribute> name
field to the given <string> for propagation in selected output
credentials.
strict <attribute>.strict(): Ignores the x-goog-iap-attr- prefix
for the provided <attribute> when propagating with the HEADER output
credential, such as request headers.
append <target_list>.append(<attribute>) OR
<target_list>.append(<list>): Appends the provided <attribute> or
<list> to the end of <target_list>.
Example expression: attributes.saml_attributes.filter(x, x.name in
['test']).append(attributes.iap_attributes.selectByName('exact').emitAs('custom').strict())
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Identity-Aware Proxy V1 API - Class Google::Cloud::Iap::V1::AttributePropagationSettings (v1.4.1)\n\nVersion latestkeyboard_arrow_down\n\n- [1.4.1 (latest)](/ruby/docs/reference/google-cloud-iap-v1/latest/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [1.4.0](/ruby/docs/reference/google-cloud-iap-v1/1.4.0/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [1.3.1](/ruby/docs/reference/google-cloud-iap-v1/1.3.1/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [1.2.0](/ruby/docs/reference/google-cloud-iap-v1/1.2.0/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [1.1.0](/ruby/docs/reference/google-cloud-iap-v1/1.1.0/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [1.0.1](/ruby/docs/reference/google-cloud-iap-v1/1.0.1/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [0.12.0](/ruby/docs/reference/google-cloud-iap-v1/0.12.0/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [0.11.2](/ruby/docs/reference/google-cloud-iap-v1/0.11.2/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [0.10.1](/ruby/docs/reference/google-cloud-iap-v1/0.10.1/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [0.9.0](/ruby/docs/reference/google-cloud-iap-v1/0.9.0/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [0.8.1](/ruby/docs/reference/google-cloud-iap-v1/0.8.1/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [0.7.0](/ruby/docs/reference/google-cloud-iap-v1/0.7.0/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [0.6.0](/ruby/docs/reference/google-cloud-iap-v1/0.6.0/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [0.5.0](/ruby/docs/reference/google-cloud-iap-v1/0.5.0/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [0.4.0](/ruby/docs/reference/google-cloud-iap-v1/0.4.0/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [0.3.0](/ruby/docs/reference/google-cloud-iap-v1/0.3.0/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [0.2.0](/ruby/docs/reference/google-cloud-iap-v1/0.2.0/Google-Cloud-Iap-V1-AttributePropagationSettings)\n- [0.1.3](/ruby/docs/reference/google-cloud-iap-v1/0.1.3/Google-Cloud-Iap-V1-AttributePropagationSettings) \nReference documentation and code samples for the Identity-Aware Proxy V1 API class Google::Cloud::Iap::V1::AttributePropagationSettings.\n\nConfiguration for propagating attributes to applications protected\nby IAP. \n\nInherits\n--------\n\n- Object \n\nExtended By\n-----------\n\n- Google::Protobuf::MessageExts::ClassMethods \n\nIncludes\n--------\n\n- Google::Protobuf::MessageExts\n\nMethods\n-------\n\n### #enable\n\n def enable() -\u003e ::Boolean\n\n**Returns**\n\n- (::Boolean) --- Optional. Whether the provided attribute propagation settings should be evaluated on user requests. If set to true, attributes returned from the expression will be propagated in the set output credentials.\n\n### #enable=\n\n def enable=(value) -\u003e ::Boolean\n\n**Parameter**\n\n- **value** (::Boolean) --- Optional. Whether the provided attribute propagation settings should be evaluated on user requests. If set to true, attributes returned from the expression will be propagated in the set output credentials. \n**Returns**\n\n- (::Boolean) --- Optional. Whether the provided attribute propagation settings should be evaluated on user requests. If set to true, attributes returned from the expression will be propagated in the set output credentials.\n\n### #expression\n\n def expression() -\u003e ::String\n\n**Returns**\n\n- (::String) --- Optional. Raw string CEL expression. Must return a list of attributes. A maximum of 45 attributes can be selected. Expressions can select different attribute types from `attributes`: `attributes.saml_attributes`, `attributes.iap_attributes`. The following functions are supported:\n\n\n - filter `\u003clist\u003e.filter(\u003citer_var\u003e, \u003cpredicate\u003e)`: Returns a subset of\n `\u003clist\u003e` where `\u003cpredicate\u003e` is true for every item.\n\n - in `\u003cvar\u003e in \u003clist\u003e`: Returns true if `\u003clist\u003e` contains `\u003cvar\u003e`.\n\n - selectByName `\u003clist\u003e.selectByName(\u003cstring\u003e)`: Returns the attribute\n in\n `\u003clist\u003e` with the given `\u003cstring\u003e` name, otherwise returns empty.\n\n - emitAs `\u003cattribute\u003e.emitAs(\u003cstring\u003e)`: Sets the `\u003cattribute\u003e` name\n field to the given `\u003cstring\u003e` for propagation in selected output\n credentials.\n\n - strict `\u003cattribute\u003e.strict()`: Ignores the `x-goog-iap-attr-` prefix\n for the provided `\u003cattribute\u003e` when propagating with the `HEADER` output\n credential, such as request headers.\n\n - append `\u003ctarget_list\u003e.append(\u003cattribute\u003e)` OR\n `\u003ctarget_list\u003e.append(\u003clist\u003e)`: Appends the provided `\u003cattribute\u003e` or\n `\u003clist\u003e` to the end of `\u003ctarget_list\u003e`.\n\n Example expression: `attributes.saml_attributes.filter(x, x.name in\n ['test']).append(attributes.iap_attributes.selectByName('exact').emitAs('custom').strict())`\n\n### #expression=\n\n def expression=(value) -\u003e ::String\n\n**Parameter**\n\n- **value** (::String) --- Optional. Raw string CEL expression. Must return a list of attributes. A maximum of 45 attributes can be selected. Expressions can select different attribute types from `attributes`: `attributes.saml_attributes`, `attributes.iap_attributes`. The following functions are supported:\n\n\n - filter `\u003clist\u003e.filter(\u003citer_var\u003e, \u003cpredicate\u003e)`: Returns a subset of\n `\u003clist\u003e` where `\u003cpredicate\u003e` is true for every item.\n\n - in `\u003cvar\u003e in \u003clist\u003e`: Returns true if `\u003clist\u003e` contains `\u003cvar\u003e`.\n\n - selectByName `\u003clist\u003e.selectByName(\u003cstring\u003e)`: Returns the attribute\n in\n `\u003clist\u003e` with the given `\u003cstring\u003e` name, otherwise returns empty.\n\n - emitAs `\u003cattribute\u003e.emitAs(\u003cstring\u003e)`: Sets the `\u003cattribute\u003e` name\n field to the given `\u003cstring\u003e` for propagation in selected output\n credentials.\n\n - strict `\u003cattribute\u003e.strict()`: Ignores the `x-goog-iap-attr-` prefix\n for the provided `\u003cattribute\u003e` when propagating with the `HEADER` output\n credential, such as request headers.\n\n - append `\u003ctarget_list\u003e.append(\u003cattribute\u003e)` OR\n `\u003ctarget_list\u003e.append(\u003clist\u003e)`: Appends the provided `\u003cattribute\u003e` or\n `\u003clist\u003e` to the end of `\u003ctarget_list\u003e`.\n\n Example expression: `attributes.saml_attributes.filter(x, x.name in\n['test']).append(attributes.iap_attributes.selectByName('exact').emitAs('custom').strict())` \n**Returns**\n\n- (::String) --- Optional. Raw string CEL expression. Must return a list of attributes. A maximum of 45 attributes can be selected. Expressions can select different attribute types from `attributes`: `attributes.saml_attributes`, `attributes.iap_attributes`. The following functions are supported:\n\n\n - filter `\u003clist\u003e.filter(\u003citer_var\u003e, \u003cpredicate\u003e)`: Returns a subset of\n `\u003clist\u003e` where `\u003cpredicate\u003e` is true for every item.\n\n - in `\u003cvar\u003e in \u003clist\u003e`: Returns true if `\u003clist\u003e` contains `\u003cvar\u003e`.\n\n - selectByName `\u003clist\u003e.selectByName(\u003cstring\u003e)`: Returns the attribute\n in\n `\u003clist\u003e` with the given `\u003cstring\u003e` name, otherwise returns empty.\n\n - emitAs `\u003cattribute\u003e.emitAs(\u003cstring\u003e)`: Sets the `\u003cattribute\u003e` name\n field to the given `\u003cstring\u003e` for propagation in selected output\n credentials.\n\n - strict `\u003cattribute\u003e.strict()`: Ignores the `x-goog-iap-attr-` prefix\n for the provided `\u003cattribute\u003e` when propagating with the `HEADER` output\n credential, such as request headers.\n\n - append `\u003ctarget_list\u003e.append(\u003cattribute\u003e)` OR\n `\u003ctarget_list\u003e.append(\u003clist\u003e)`: Appends the provided `\u003cattribute\u003e` or\n `\u003clist\u003e` to the end of `\u003ctarget_list\u003e`.\n\n Example expression: `attributes.saml_attributes.filter(x, x.name in\n ['test']).append(attributes.iap_attributes.selectByName('exact').emitAs('custom').strict())`\n\n### #output_credentials\n\n def output_credentials() -\u003e ::Array\u003c::Google::Cloud::Iap::V1::AttributePropagationSettings::OutputCredentials\u003e\n\n**Returns**\n\n- (::Array\\\u003c[::Google::Cloud::Iap::V1::AttributePropagationSettings::OutputCredentials](./Google-Cloud-Iap-V1-AttributePropagationSettings-OutputCredentials)\\\u003e) --- Optional. Which output credentials attributes selected by the CEL expression should be propagated in. All attributes will be fully duplicated in each selected output credential.\n\n### #output_credentials=\n\n def output_credentials=(value) -\u003e ::Array\u003c::Google::Cloud::Iap::V1::AttributePropagationSettings::OutputCredentials\u003e\n\n**Parameter**\n\n- **value** (::Array\\\u003c[::Google::Cloud::Iap::V1::AttributePropagationSettings::OutputCredentials](./Google-Cloud-Iap-V1-AttributePropagationSettings-OutputCredentials)\\\u003e) --- Optional. Which output credentials attributes selected by the CEL expression should be propagated in. All attributes will be fully duplicated in each selected output credential. \n**Returns**\n\n- (::Array\\\u003c[::Google::Cloud::Iap::V1::AttributePropagationSettings::OutputCredentials](./Google-Cloud-Iap-V1-AttributePropagationSettings-OutputCredentials)\\\u003e) --- Optional. Which output credentials attributes selected by the CEL expression should be propagated in. All attributes will be fully duplicated in each selected output credential."]]