XML-схемы

XML-схема — это описание структуры и правил, которым должен соответствовать XML-документ. Схема определяет, какие элементы и атрибуты могут присутствовать в документе, в каком порядке они располагаются, какие значения могут содержать и какие из них являются обязательными.

В UserGate WAF XML-схемы используются для проверки запросов, содержащих данные в формате XML. В отличие от синтаксической проверки, которая определяет только корректность формата XML, схема проверяет соответствие данных заданным требованиям: допустима ли такая структура, присутствуют ли обязательные поля и соответствуют ли значения установленным ограничениям.

Действия с XML-схемами выполняются в разделе Настройки в разделе Библиотеки ➜ XML-схемы. Вы можете создавать схемы, редактировать их и удалять, а также выполнять экспорт и импорт схем.

Создание XML-схемы

Чтобы создать XML-схему:

1. В разделе Библиотеки ➜ XML-схемы нажмите Добавить. Откроется окно свойства XML-схемы.

2. Укажите название схемы, при необходимости описание и версию спецификации.

3. В поле Содержимое схемы опишите XML-схему.

4. Нажмите Проверить синтаксис. Если результат проверки неудовлетворительный, внесите исправления и повторно выполните проверку.

5. Сохраните изменения.

Теперь созданную XML-схему можно использовать при настройке XML-профиля. Подробнее об этом  — в разделе «Создание XML-профиля».

Общие сведения о XML-схемах

Простейшая XML-схема имеет следующий вид:

<?xml version="1.0" encoding="UTF-8"?>

<xs:schema
    xmlns:xs="http://www.w3.org/2001/XMLSchema">

    <xs:element name="user">
        <xs:complexType>
            <xs:sequence>

                <xs:element name="name" type="xs:string"/>
                <xs:element name="age" type="xs:integer"/>

            </xs:sequence>
        </xs:complexType>
    </xs:element>

</xs:schema>

XML-схема состоит из следующих основных элементов

• xs:schema — корневой элемент, внутри которого описываются все элементы схемы, типы данных, атрибуты и другие правила структуры XML-документа.

• xmlns:xs — объявляет пространство имен XML Schema. Пространство имен определяет, к какой схеме или модели данных относится XML-элемент. Оно позволяет использовать одинаковые имена элементов в разных схемах и при этом не путать их.

• xs:element — описывает элемент XML-документа. В примере атрибут name задаёт имя элемента, а type — его тип данных.

• xs:simpleType — используется для создания простого типа данных на основе стандартного типа. Это позволяет дополнительно ограничивать допустимые значения.

• xs:complexType — описывает структуру сложного элемента, который может содержать вложенные элементы или атрибуты. 

• xs:sequence — описывает последовательность вложенных элементов.

• xs:attribute — описывает атрибут XML-элемента.

• type — тип данных элемента или атрибута;

• minOccurs/maxOccurs — количество допустимых вхождений элементов. Если эти атрибуты не указаны, элемент по умолчанию является обязательным и может встречаться один раз.

XML-схема содержит набор встроенных типов данных. Наиболее часто используются:

• xs:string — строка;

• xs:integer — целое число;

• xs:decimal — десятичное число;

• xs:boolean — булево значение (true или false);

• xs:date — дата;

• xs:dateTime — дата и время;

• xs:anyURI — URI.