ONVIF™ – 1 – ONVIF Core Spec. – Ver. 2.10
ONVIF™
Core Specification
Version 2.1
June, 2011
ONVIF™ – 2 – ONVIF Core Spec. – Ver. 2.10
2008-2011 by ONVIF: Open Network Video Interface Forum Inc.. All rights reserved.
Recipients of this document may copy, distribute, publish, or display this document so long as this
copyright notice, license and disclaimer are retained with all copies of the document. No license is
granted to modify this document.
THIS DOCUMENT IS PROVIDED "AS IS," AND THE CORPORATION AND ITS MEMBERS AND
THEIR AFFILIATES, MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE, NON-INFRINGEMENT, OR TITLE; THAT THE CONTENTS OF THIS
DOCUMENT ARE SUITABLE FOR ANY PURPOSE; OR THAT THE IMPLEMENTATION OF SUCH
CONTENTS WILL NOT INFRINGE ANY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER
RIGHTS.
IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE
FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, PUNITIVE OR CONSEQUENTIAL
DAMAGES, ARISING OUT OF OR RELATING TO ANY USE OR DISTRIBUTION OF THIS
DOCUMENT, WHETHER OR NOT (1) THE CORPORATION, MEMBERS OR THEIR AFFILIATES
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR (2) SUCH DAMAGES
WERE REASONABLY FORESEEABLE, AND ARISING OUT OF OR RELATING TO ANY USE OR
DISTRIBUTION OF THIS DOCUMENT. THE FOREGOING DISCLAIMER AND LIMITATION ON
LIABILITY DO NOT APPLY TO, INVALIDATE, OR LIMIT REPRESENTATIONS AND WARRANTIES
MADE BY THE MEMBERS AND THEIR RESPECTIVE AFFILIATES TO THE CORPORATION AND
OTHER MEMBERS IN CERTAIN WRITTEN POLICIES OF THE CORPORATION.
ONVIF™ – 3 – ONVIF Core Spec. – Ver. 2.10
CONTENTS
1 Scope 9
2 Normative references 10
3 Terms and Definitions 11
3.1 Definitions......................................................................................................................11
3.2 Abbreviations ................................................................................................................12
4 Overview 14
4.1 Web Services ................................................................................................................14
4.2 IP configuration .............................................................................................................15
4.3 Device discovery...........................................................................................................15
4.4 Device Types ................................................................................................................15
4.5 Device management .....................................................................................................16
4.5.1 Capabilities ...............................................................................................................16
4.5.2 Network.....................................................................................................................16
4.5.3 System......................................................................................................................17
4.5.4 Retrieval of System Information................................................................................17
4.5.5 Firmware Upgrade....................................................................................................17
4.5.6 System Restore ........................................................................................................18
4.5.7 Security.....................................................................................................................18
4.6 Event handling ..............................................................................................................18
4.7 Security .........................................................................................................................19
5 Web Services framework 20
5.1 Services overview .........................................................................................................20
5.1.1 Services requirements ..............................................................................................20
5.2 WSDL overview.............................................................................................................21
5.3 Namespaces .................................................................................................................21
5.4 Types.............................................................................................................................22
5.5 Messages......................................................................................................................23
5.6 Operations.....................................................................................................................23
5.6.1 One-way operation type............................................................................................24
5.6.2 Request-response operation type.............................................................................25
5.7 Port Types.....................................................................................................................25
5.8 Binding ..........................................................................................................................26
5.9 Ports..............................................................................................................................26
5.10 Services.........................................................................................................................26
5.11 Error handling................................................................................................................26
5.11.1 Protocol errors......................................................................................................26
5.11.2 SOAP errors .........................................................................................................27
5.12 Security .........................................................................................................................30
5.12.1 User-based access control...................................................................................32
5.12.2 Username token profile ........................................................................................33
6 IP configuration 35
7 Device discovery 36
ONVIF™ – 4 – ONVIF Core Spec. – Ver. 2.10
7.1
General..........................................................................................................................36
7.2 Modes of operation .......................................................................................................36
7.3 Discovery definitions .....................................................................................................36
7.3.1 Endpoint reference ...................................................................................................36
7.3.2 Hello..........................................................................................................................37
7.3.3 Probe and Probe Match............................................................................................39
7.3.4 Resolve and Resolve Match.....................................................................................39
7.3.5 Bye............................................................................................................................39
7.3.6 SOAP Fault Messages .............................................................................................39
7.4 Remote discovery extensions .......................................................................................40
7.4.1 Network scenarios ....................................................................................................40
7.4.2 Discover proxy ..........................................................................................................42
7.4.3 Remote Hello and Probe behaviour..........................................................................43
7.4.4 Client behaviour........................................................................................................44
7.4.5 Security.....................................................................................................................45
8 Device management 47
8.1 Capabilities....................................................................................................................47
8.1.1 Get WSDL URL.........................................................................................................47
8.1.2 Capability exchange .................................................................................................47
8.2 Network .........................................................................................................................52
8.2.1 Get hostname ...........................................................................................................52
8.2.2 Set hostname............................................................................................................52
8.2.3 Set hostname from DHCP ........................................................................................53
8.2.4 Get DNS settings ......................................................................................................53
8.2.5 Set DNS settings ......................................................................................................54
8.2.6 Get NTP settings ......................................................................................................54
8.2.7 Set NTP settings.......................................................................................................55
8.2.8 Get dynamic DNS settings........................................................................................55
8.2.9 Set dynamic DNS settings........................................................................................56
8.2.10 Get network interface configuration......................................................................57
8.2.11 Set network interface configuration......................................................................58
8.2.12 Get network protocols ..........................................................................................59
8.2.13 Set network protocols...........................................................................................59
8.2.14 Get default gateway..............................................................................................60
8.2.15 Set default gateway..............................................................................................60
8.2.16 Get zero configuration..........................................................................................61
8.2.17 Set zero configuration ..........................................................................................61
8.2.18 Get IP address filter..............................................................................................62
8.2.19 Set IP address filter ..............................................................................................62
8.2.20 Add an IP filter address ........................................................................................63
8.2.21 Remove an IP filter address.................................................................................63
8.2.22 IEEE 802.11 configuration....................................................................................64
8.3 System ..........................................................................................................................68
8.3.1 Device Information....................................................................................................68
8.3.2 Get System URIs ......................................................................................................69
8.3.3 Backup......................................................................................................................69
8.3.4 Restore .....................................................................................................................70
8.3.5 Start system restore..................................................................................................70
8.3.6 Get system date and time.........................................................................................71
8.3.7 Set system date and time .........................................................................................72
8.3.8 Factory default ..........................................................................................................72
8.3.9 Firmware upgrade.....................................................................................................73
8.3.10 Start firmware upgrade.........................................................................................74
8.3.11 Get system logs....................................................................................................74
8.3.12 Get support information........................................................................................75
8.3.13 Reboot..................................................................................................................76
8.3.14 Get scope parameters..........................................................................................76
ONVIF™ – 5 – ONVIF Core Spec. – Ver. 2.10
8.3.15
Set scope parameters ..........................................................................................77
8.3.16 Add scope parameters .........................................................................................77
8.3.17 Remove scope parameters ..................................................................................77
8.3.18 Get discovery mode..............................................................................................78
8.3.19 Set discovery mode..............................................................................................78
8.3.20 Get remote discovery mode .................................................................................79
8.3.21 Set remote discovery mode..................................................................................79
8.3.22 Get remote DP addresses....................................................................................80
8.3.23 Set remote DP addresses ....................................................................................80
8.4 Security .........................................................................................................................81
8.4.1 Get access policy......................................................................................................81
8.4.2 Set access policy ......................................................................................................81
8.4.3 Get users ..................................................................................................................82
8.4.4 Create users .............................................................................................................82
8.4.5 Delete users..............................................................................................................83
8.4.6 Set users settings .....................................................................................................83
8.4.7 IEEE 802.1X configuration........................................................................................84
8.4.8 Create self-signed certificate ....................................................................................88
8.4.9 Get certificates..........................................................................................................89
8.4.10 Get CA certificates................................................................................................89
8.4.11 Get certificate status.............................................................................................89
8.4.12 Set certificate status .............................................................................................90
8.4.13 Get certificate request ..........................................................................................90
8.4.14 Get client certificate status ...................................................................................91
8.4.15 Set client certificate status....................................................................................91
8.4.16 Load device certificate..........................................................................................92
8.4.17 Load device certificates in conjunction with its private key..................................93
8.4.18 Get certificate information request .......................................................................93
8.4.19 Load CA certificates .............................................................................................94
8.4.20 Delete certificate...................................................................................................95
8.4.21 Get remote user....................................................................................................95
8.4.22 Set remote user....................................................................................................96
8.4.23 Get endpoint reference.........................................................................................97
8.5 Input/Output (I/O) ..........................................................................................................97
8.5.1 Get relay outputs ......................................................................................................97
8.5.2 Set relay output settings ...........................................................................................97
8.5.3 Trigger relay output...................................................................................................98
8.5.4 Auxiliary operation ....................................................................................................99
8.6 Service specific fault codes...........................................................................................99
9 Event handling 106
9.1 Basic Notification Interface..........................................................................................106
9.1.1 Introduction .............................................................................................................106
9.1.2 Requirements..........................................................................................................107
9.2 Real-time Pull-Point Notification Interface ..................................................................108
9.2.1 Create pull point subscription .................................................................................110
9.2.2 Pull messages.........................................................................................................110
9.3 Notification Streaming Interface..................................................................................111
9.4 Properties....................................................................................................................111
9.4.1 Property Example ...................................................................................................111
9.5 Notification Structure...................................................................................................112
9.5.1 Notification information ...........................................................................................112
9.5.2 Message Format.....................................................................................................113
9.5.3 Property example, continued..................................................................................114
9.5.4 Message Description Language.............................................................................116
9.5.5 Message Content Filter...........................................................................................117
9.6 Synchronization Point .................................................................................................118
- 1
- 2
- 3
- 4
- 5
- 6
前往页