SubscriptionValidationPolicy.xml

subscription-validation-policies

Subscription validation policies

The following table lists the elements that an element of type subscription-validation-policies can contain:

Name	Type	Description	Min occurs	Max occurs
topics	topics	A map of topics to policies.	0	1
policy	policy	A subscription validation policy.	0	unbounded

A map of topics to policies.

The following table lists the elements that an element of type topics can contain:

Name	Type	Description	Min occurs	Max occurs
topic	topic	A topic to policy mapping.	0	unbounded

The following table lists the attributes that an element of type topic can have:

Name	Type	Description	Required
policy	push:string	The name of the policy to apply to this topic.	true

A subscription validation policy.

The following table lists the attributes that an element of type policy can have:

Name	Type	Description	Required
name	push:string	Each policy must be supplied with a unique name for easy reference.	true
type	push:string	The policy type is either "blacklist" or "whitelist". A blacklist indicates that if any of the policy rules in this policy match the incoming connection, that connection is to be rejected. A whitelist requires that at least one policy rule matches for the connection to be accepted.	true
automatic	push:boolean	Policies which are set to automatic are applied by Diffusion and the publishers do not need to perform any checks themselves. If this is set to false, the policy is not applied unless it is done by the publisher. If this value is not specified, a default of true is used.	false
validate-children	xsd:boolean	Controls whether to perform validation on child topics if the parent topic fails validation. If a value is not specified, a default of false is used.	false

The following table lists the elements that an element of type policy can contain:

Name	Type	Description	Min occurs	Max occurs
addresses	addresses	Subscription validation policy addresses. These are addresses that are blacklisted/whitelisted.	0	1
locale	locale	Connection validation policy locale. This is locale details that are blacklisted/whitelisted.	0	unbounded

The following table lists the elements that an element of type addresses can contain:

Name	Type	Description	Max occurs
address	push:string	An IP address (or regular expression) of a subscribing client.	unbounded
hostname	push:string	The hostname (or regular expression) of a subscribing client.	unbounded
resolved-name	push:string	The resolved hostname (or regular expression) of a subscribing client, as returned by the WhoIs service.	unbounded

The following table lists the elements that an element of type locale can contain:

Name	Type	Description	Min occurs	Max occurs
country	push:string	The ISO country code of the subscribing client, as returned by the WhoIs service.	0	1
language	push:string	The ISO language code of the subscribing client, as returned by the WhoIs service.	0	1