NetworkTrafficRules Schema

The NetworkTrafficRules node is an optional element in the service definition file that specifies how roles communicate with each other. It limits which roles can access the internal endpoints of the specific role. The NetworkTrafficRules is not a standalone element; it is combined with two or more roles in a service definition file.

The default extension for the service definition file is .csdef.

Basic service definition schema for the network traffic rules

The basic format of a service definition file containing network traffic definitions is as follows.

<ServiceDefinition …>
   <NetworkTrafficRules>
      <OnlyAllowTrafficTo >
         <Destinations>
            <RoleEndpoint endpointName="<name-of-the-endpoint>" roleName="<name-of-the-role-containing-the-endpoint>"/>
         </Destinations>
         <AllowAllTraffic/>
         <WhenSource matches="[AnyRule]">
            <FromRole roleName="<name-of-the-role-to-allow-traffic-from>"/>
         </WhenSource>
      </OnlyAllowTrafficTo>
   </NetworkTrafficRules>
</ServiceDefinition>

Schema Elements

The NetworkTrafficRules node of the service definition file includes these elements, described in detail in subsequent sections in this topic:

NetworkTrafficRules Element

OnlyAllowTrafficTo Element

Destinations Element

RoleEndpoint Element

No text is specified for bookmark or legacy link '351b369f-365e-46c1-82ce-03fc3655cc88#AllowAllTraffic'.

WhenSource Element

FromRole Element

NetworkTrafficRules Element

The NetworkTrafficRules element specifies which roles can communicate with which endpoint on another role. A service can contain one NetworkTrafficRules definition.

OnlyAllowTrafficTo Element

The OnlyAllowTrafficTo element describes a collection of destination endpoints and the roles that can communicate with them. You can specify multiple OnlyAllowTrafficTo nodes.

Destinations Element

The Destinations element describes a collection of RoleEndpoints than can be communicated with.

RoleEndpoint Element

The RoleEndpoint element describes an endpoint on a role to allow communications with. You can specify multiple RoleEndpoint elements if there are more than one endpoint on the role.

AllowAllTraffic Element

The AllowAllTraffic element is a rule that allows all roles to communicate with the endpoints defined in the Destinations node.

WhenSource Element

The WhenSource element describes a collection of roles than can communicate with the endpoints defined in the Destinations node.

FromRole Element

The FromRole element specifies the roles that can communicate with the endpoints defined in the Destinations node. You can specify multiple FromRole elements if there are more than one role that can communicate with the endpoints.

See Also

Schema Reference