Skip to content

Tag: <devicetemplate> - Template Definition

Definition

The <devicetemplate tag defines the details of the device name, type, version etc and also the version of the template itself.

This tag has the following attributes:

Parameters

  • name (str): This is the name of the template. This name acts as the unique identifier for the template and all other versions of this template. This string if for internal use and is not displayed in the Admin Interface.

  • vendor (str): This is the name of the vendor that makes the device.

  • display_name (str): This is the name of the template that appears in the Admin Interface. This should NOT include the name of the vendor as that is defined in the vendor attribute.

  • type (see table below*): This is the short code for the type of device, as per the table below.

  • os_version_min (str): This is the display string of the minimum version of the device that this template supports. This is purely for display purposes in the Admin Interface. The actual version is checked with <version> tags.

  • os_version_max (str): This is the display string of the minimum version of the device that this template supports. This is purely for display purposes in the Admin Interface. The actual version is checked with <version> tags. If the <os_version_min> and <os_version_max> strings are the same then just that value is displayed.

  • version_major (int): This is the major version of the template itself. This attribute is RESERVED for use by Osirium PAM and is used when releasing new official release templates.

  • version_minor (int): This is the minor version of the template itself. This attribute is for use by end users/partners to manage template changes. This is set to 0 in Osirium PAM official released templates.

The type attribute can have any of the following values:

Type Attribute Value Display Name
firewall Firewall
proxy Proxy Server
intrusionsystem Intrusion detection system
avgateway AntiVirus Gateway
emailgateway Email Gateway
sslvpn SSL VPN Device
wanoptimiser WAN Optimiser
appfirewall DB Access Monitor
logging Central Logging System
authsystem Authentication System
appdelivery Application Delivery Controller
imfirewall Instant Messaging Firewall
loadbalancer Load Balancer
switchrouter Network Switch or Router
linuxserver Linux Server
windows Windows
waf Web Application Firewall
customapp Custom Application
hypervisor Hypervisor
other Other Device Type

The attributes of the <devicetemplate> tag are displayed in the Admin Interface as shown below:

Template info fields

The '# Devices' column shows how many devices are currently that particular template version and is generated based on provisioned devices and is not supplied by the template itself.

Some attribute values are passed down to the PAM UI for each device added with a particular template. This allows searching in the PAM UI using the following attribute values:

  • Vendor
  • Type
  • Name
  • Display Name

For more details on managing template version numbers, see: :ref:template-versions.

Example

The following example shows how a 'Juniper Networks Netscreen Firewall' might be added with support for device operating system ScreenOS versions 6.0 - 6.3,and a template version of 8.0. This is the same example as shown in the Admin Interface shown above.

1
2
3
<devicetemplate name='juniper_netscreen' vendor='Juniper Networks' display_name='Netscreen ScreenOS' type='firewall'
os_version_min='v6.0' os_version_max='v6.3'
version_major='8' version_minor='0'>

Parent Tags

Child Tags