CA API Gateway 9.1

9.4 9.1

Manage Gateway Assertion

The Manage Gateway assertion processes the request as a management SOAP message and will populate the response message. This assertion is automatically added to a policy when the "Gateway Management" internal service is published. For more information, see Working with Internal Services.
gateway83
The
Manage Gateway
assertion
processes the request as a management SOAP message and will populate the response message. This assertion is automatically added to a policy when the "Gateway Management" internal service is published
.
For more information, see Working with Internal Services.
This assertion is similar to the REST Manage Gateway Assertion, except it calls the SOAP API service instead of processing the request as a REST message.
The Manage Gateway assertion is only intended for use with the Gateway Management internal service. CA does not support its use in any other scenario.
Context Variables Created by Assertion
The Manage Gateway assertion can optionally set the following context variables. The
<prefix>
 is defined in the assertion properties.
There is no default prefix—if no prefix is specified in the properties, then no context variables will be set by this assertion.
Variable
Description
<prefix>
.
action
Contains the action that was performed on the entity: Create, Read, Update, Delete, Enumerate
<prefix>
.
entityType
The type of entity receiving the action: Identity Provider, Published Service, Trusted Certificate, etc
<prefix>
.
entityId
The identifier for the entity (if applicable for the operation).
<prefix>
.
message
A message describing the outcome of the operation.
Using the Assertion
  1. Do one of the following:
    • To add the assertion to the policy development window, publish the internal Gateway Management Service.
    • To change the configuration of an existing assertion, proceed to step 2 below.
  2. Right-click
    Manage Gateway
     in the policy window and select
    Gateway Management Properties
     or double-click the assertion in the policy window. The assertion properties are displayed.
  3. If you want to create the context variables listed above, enter a prefix. Leave the field blank if you do not want to set the context variables. You may enter a new prefix or one that has been used before to overwrite existing content. Enter a prefix that will be added to the context variables created by this assertion. This prefix will ensure uniqueness and will prevent the variables from overwriting each other when multiple instances of this assertion appear in a policy. For an explanation of the validation messages displayed, see Context Variable Validation.
  4. Click [
    OK
    ].

Content feedback and comments