Alarm and electronic security systems - Part 11-31: Electronic access control systems - Core interoperability protocol based on Web services

IEC 60839-11-31:2016 defines procedures for communication between network clients and devices. This series of interoperability standards makes it possible to build an alarm and electronic security system with clients and devices from different manufacturers using common and well defined interfaces. The functions defined in this document covers discovery, device management and event framework. Supplementary dedicated services are defined in separate documents. The management and control interfaces defined in this document are described as Web services. This document also contains full XML schema and Web Service Description Language (WSDL) definitions. In order to offer full plug-and-play interoperability, this document defines procedures for device discovery. The device discovery mechanisms in this document are based on the WS-Discovery specification with extensions.

Systèmes d'alarme et de sécurité électroniques - Partie 11-31: Systèmes de contrôle d'accès électronique - Protocole de base d'interopérabilité en fonction des services Web

L'IEC 60839-11-31:2016 définit les procédures de communication entre les clients en réseau et les dispositifs. Cette série de normes relatives à l’interopérabilité permet de concevoir un système d'alarme et de sécurité électronique avec des clients et des dispositifs de différents fabricants utilisant des interfaces communes et bien définies. Les fonctions définies dans le présent document couvrent la découverte, la gestion de dispositif et le cadre des événements. Des services spécialisés supplémentaires sont définis dans des documents séparés. Les interfaces de gestion et de contrôle définies dans le présent document sont décrites sous forme de services Web. Le présent document comprend également les définitions complètes du schéma XML et du langage de description de services Web (WSDL). Afin d'offrir une interopérabilité complète et prête à l'emploi, le présent document définit les procédures de découverte de dispositif. Les mécanismes de découverte de dispositif du présent document reposent sur la spécification WS-Discovery, avec des extensions.

General Information

Status
Published
Publication Date
23-Nov-2016
Current Stage
PPUB - Publication issued
Completion Date
24-Nov-2016
Ref Project

Buy Standard

Standard
IEC 60839-11-31:2016 - Alarm and electronic security systems - Part 11-31: Electronic access control systems - Core interoperability protocol based on Web services
English and French language
399 pages
sale 15% off
Preview
sale 15% off
Preview

Standards Content (sample)

IEC 60839-11-31
Edition 1.0 2016-11
INTERNATIONAL
STANDARD
NORME
INTERNATIONALE
colour
inside
Alarm and electronic security systems –
Part 11-31: Electronic access control systems – Core interoperability protocol
based on Web services
Systèmes d'alarme et de sécurité électroniques –
Partie 11-31: Systèmes de contrôle d'accès électronique – Protocole de base
d’interopérabilité en fonction des services Web
IEC 60839-11-31:2016-11(en-fr)
---------------------- Page: 1 ----------------------
THIS PUBLICATION IS COPYRIGHT PROTECTED
Copyright © 2016 IEC, Geneva, Switzerland

All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized in any form

or by any means, electronic or mechanical, including photocopying and microfilm, without permission in writing from

either IEC or IEC's member National Committee in the country of the requester. If you have any questions about IEC

copyright or have an enquiry about obtaining additional rights to this publication, please contact the address below or

your local IEC member National Committee for further information.

Droits de reproduction réservés. Sauf indication contraire, aucune partie de cette publication ne peut être reproduite

ni utilisée sous quelque forme que ce soit et par aucun procédé, électronique ou mécanique, y compris la photocopie

et les microfilms, sans l'accord écrit de l'IEC ou du Comité national de l'IEC du pays du demandeur. Si vous avez des

questions sur le copyright de l'IEC ou si vous désirez obtenir des droits supplémentaires sur cette publication, utilisez

les coordonnées ci-après ou contactez le Comité national de l'IEC de votre pays de résidence.

IEC Central Office Tel.: +41 22 919 02 11
3, rue de Varembé Fax: +41 22 919 03 00
CH-1211 Geneva 20 info@iec.ch
Switzerland www.iec.ch
About the IEC

The International Electrotechnical Commission (IEC) is the leading global organization that prepares and publishes

International Standards for all electrical, electronic and related technologies.
About IEC publications

The technical content of IEC publications is kept under constant review by the IEC. Please make sure that you have the

latest edition, a corrigenda or an amendment might have been published.
IEC Catalogue - webstore.iec.ch/catalogue Electropedia - www.electropedia.org

The stand-alone application for consulting the entire The world's leading online dictionary of electronic and

bibliographical information on IEC International Standards, electrical terms containing 20 000 terms and definitions in

Technical Specifications, Technical Reports and other English and French, with equivalent terms in 15 additional

documents. Available for PC, Mac OS, Android Tablets and languages. Also known as the International Electrotechnical

iPad. Vocabulary (IEV) online.

IEC publications search - www.iec.ch/searchpub IEC Glossary - std.iec.ch/glossary

The advanced search enables to find IEC publications by a 65 000 electrotechnical terminology entries in English and

variety of criteria (reference number, text, technical French extracted from the Terms and Definitions clause of

committee,…). It also gives information on projects, replaced IEC publications issued since 2002. Some entries have been

and withdrawn publications. collected from earlier publications of IEC TC 37, 77, 86 and

CISPR.
IEC Just Published - webstore.iec.ch/justpublished

Stay up to date on all new IEC publications. Just Published IEC Customer Service Centre - webstore.iec.ch/csc

details all new publications released. Available online and If you wish to give us your feedback on this publication or

also once a month by email. need further assistance, please contact the Customer Service

Centre: csc@iec.ch.
A propos de l'IEC

La Commission Electrotechnique Internationale (IEC) est la première organisation mondiale qui élabore et publie des

Normes internationales pour tout ce qui a trait à l'électricité, à l'électronique et aux technologies apparentées.

A propos des publications IEC

Le contenu technique des publications IEC est constamment revu. Veuillez vous assurer que vous possédez l’édition la

plus récente, un corrigendum ou amendement peut avoir été publié.
Catalogue IEC - webstore.iec.ch/catalogue Electropedia - www.electropedia.org
Application autonome pour consulter tous les renseignements
Le premier dictionnaire en ligne de termes électroniques et
bibliographiques sur les Normes internationales,
électriques. Il contient 20 000 termes et définitions en anglais
Spécifications techniques, Rapports techniques et autres
et en français, ainsi que les termes équivalents dans 15
documents de l'IEC. Disponible pour PC, Mac OS, tablettes
langues additionnelles. Egalement appelé Vocabulaire
Android et iPad.
Electrotechnique International (IEV) en ligne.
Recherche de publications IEC - www.iec.ch/searchpub
Glossaire IEC - std.iec.ch/glossary
65 000 entrées terminologiques électrotechniques, en anglais
La recherche avancée permet de trouver des publications IEC

en utilisant différents critères (numéro de référence, texte, et en français, extraites des articles Termes et Définitions des

comité d’études,…). Elle donne aussi des informations sur les publications IEC parues depuis 2002. Plus certaines entrées

projets et les publications remplacées ou retirées. antérieures extraites des publications des CE 37, 77, 86 et

CISPR de l'IEC.
IEC Just Published - webstore.iec.ch/justpublished
Service Clients - webstore.iec.ch/csc
Restez informé sur les nouvelles publications IEC. Just

Published détaille les nouvelles publications parues. Si vous désirez nous donner des commentaires sur cette

Disponible en ligne et aussi une fois par mois par email. publication ou si vous avez des questions contactez-nous:

csc@iec.ch.
---------------------- Page: 2 ----------------------
IEC 60839-11-31
Edition 1.0 2016-11
INTERNATIONAL
STANDARD
NORME
INTERNATIONALE
colour
inside
Alarm and electronic security systems –
Part 11-31: Electronic access control systems – Core interoperability protocol
based on Web services
Systèmes d'alarme et de sécurité électroniques –
Partie 11-31: Systèmes de contrôle d'accès électronique – Protocole de base
d’interopérabilité en fonction des services Web
INTERNATIONAL
ELECTROTECHNICAL
COMMISSION
COMMISSION
ELECTROTECHNIQUE
INTERNATIONALE
ICS 13.320 ISBN 978-2-8322-3778-6

Warning! Make sure that you obtained this publication from an authorized distributor.

Attention! Veuillez vous assurer que vous avez obtenu cette publication via un distributeur agréé.

® Registered trademark of the International Electrotechnical Commission
Marque déposée de la Commission Electrotechnique Internationale
---------------------- Page: 3 ----------------------
– 2 – IEC 60839-11-31:2016 © IEC 2016
CONTENTS

FOREWORD ......................................................................................................................... 10

INTRODUCTION ................................................................................................................... 12

1 Scope ............................................................................................................................ 13

2 Normative references .................................................................................................... 13

3 Terms, definitions and abbreviated terms ...................................................................... 15

3.1 Terms and definitions ............................................................................................ 15

3.2 Abbreviated terms ................................................................................................. 16

4 Overview ....................................................................................................................... 17

4.1 General ................................................................................................................. 17

4.2 Web services ........................................................................................................ 17

4.3 IP configuration ..................................................................................................... 18

4.4 Device discovery ................................................................................................... 18

4.5 Device management ............................................................................................. 19

4.5.1 General ......................................................................................................... 19

4.5.2 Capabilities.................................................................................................... 19

4.5.3 Network ......................................................................................................... 19

4.5.4 System .......................................................................................................... 20

4.5.5 Retrieval of system information ...................................................................... 20

4.5.6 Firmware upgrade .......................................................................................... 20

4.5.7 SystemRestore .............................................................................................. 20

4.5.8 Security ......................................................................................................... 20

4.6 DeviceIO ............................................................................................................... 21

4.7 Event handling ...................................................................................................... 21

4.8 Security ................................................................................................................ 21

5 Web services framework ................................................................................................ 21

5.1 General ................................................................................................................. 21

5.2 Services overview ................................................................................................. 22

5.2.1 General ......................................................................................................... 22

5.2.2 Services requirements ................................................................................... 22

5.3 WSDL overview .................................................................................................... 22

5.4 Namespaces ......................................................................................................... 23

5.5 Types.................................................................................................................... 24

5.6 Messages ............................................................................................................. 24

5.7 Operations ............................................................................................................ 25

5.7.1 General ......................................................................................................... 25

5.7.2 One-way operation type ................................................................................. 26

5.7.3 Request-response operation type .................................................................. 26

5.8 Port types ............................................................................................................. 27

5.9 Binding ................................................................................................................. 27

5.10 Ports ..................................................................................................................... 27

5.11 Services ................................................................................................................ 28

5.12 Error handling ....................................................................................................... 28

5.12.1 General ......................................................................................................... 28

5.12.2 Protocol errors ............................................................................................... 28

5.12.3 SOAP errors .................................................................................................. 28

5.13 Security ................................................................................................................ 31

---------------------- Page: 4 ----------------------
IEC 60839-11-31:2016 © IEC 2016 – 3 –

5.13.1 Authentication................................................................................................ 31

5.13.2 User-based access control ............................................................................ 31

5.14 String representation ............................................................................................ 33

5.14.1 Character set ................................................................................................. 33

5.14.2 Allowed characters in strings ......................................................................... 33

5.15 Proprietary extensions .......................................................................................... 33

6 IP configuration ............................................................................................................. 33

7 Device discovery ........................................................................................................... 34

7.1 General ................................................................................................................. 34

7.2 Modes of operation ............................................................................................... 34

7.3 Discovery definitions ............................................................................................. 35

7.3.1 Endpoint reference ........................................................................................ 35

7.3.2 Hello .............................................................................................................. 35

7.3.3 Probe and probe match ................................................................................. 36

7.3.4 Resolve and resolve match ............................................................................ 37

7.3.5 Bye ................................................................................................................ 37

7.3.6 SOAP fault messages .................................................................................... 37

8 Device management ...................................................................................................... 37

8.1 General ................................................................................................................. 37

8.2 Capabilities ........................................................................................................... 38

8.2.1 Get WSDL URL ............................................................................................. 38

8.2.2 Capability exchange ...................................................................................... 38

8.3 Network ................................................................................................................ 40

8.3.1 Get hostname ................................................................................................ 40

8.3.2 Set hostname ................................................................................................ 40

8.3.3 Set hostname from DHCP .............................................................................. 41

8.3.4 Get DNS settings ........................................................................................... 41

8.3.5 Set DNS settings ........................................................................................... 42

8.3.6 Get NTP settings ........................................................................................... 42

8.3.7 Set NTP settings............................................................................................ 43

8.3.8 Get dynamic DNS settings ............................................................................. 43

8.3.9 Set dynamic DNS settings ............................................................................. 44

8.3.10 Get network interface configuration ............................................................... 44

8.3.11 Set network interface configuration ................................................................ 45

8.3.12 Get network protocols .................................................................................... 46

8.3.13 Set network protocols .................................................................................... 47

8.3.14 Get default gateway ....................................................................................... 47

8.3.15 Set default gateway ....................................................................................... 48

8.3.16 Get zero configuration ................................................................................... 48

8.3.17 Set zero configuration .................................................................................... 48

8.3.18 Get IP address filter ....................................................................................... 49

8.3.19 Set IP address filter ....................................................................................... 49

8.3.20 Add an IP filter address ................................................................................. 50

8.3.21 Remove an IP filter address ........................................................................... 50

8.3.22 IEEE 802.11 configuration ............................................................................. 51

8.4 System ................................................................................................................. 55

8.4.1 Device information ......................................................................................... 55

8.4.2 Get system URIs ........................................................................................... 55

8.4.3 Backup .......................................................................................................... 56

---------------------- Page: 5 ----------------------
– 4 – IEC 60839-11-31:2016 © IEC 2016

8.4.4 Restore.......................................................................................................... 56

8.4.5 Start system restore ...................................................................................... 57

8.4.6 Get system date and time .............................................................................. 57

8.4.7 Set system date and time .............................................................................. 58

8.4.8 Factory default............................................................................................... 59

8.4.9 Firmware upgrade .......................................................................................... 59

8.4.10 Start firmware upgrade .................................................................................. 60

8.4.11 Get system logs ............................................................................................. 61

8.4.12 Get support information ................................................................................. 61

8.4.13 Reboot........................................................................................................... 62

8.4.14 Get scope parameters ................................................................................... 62

8.4.15 Set scope parameters .................................................................................... 62

8.4.16 Add scope parameters ................................................................................... 63

8.4.17 Remove scope parameters ............................................................................ 63

8.4.18 Get discovery mode ....................................................................................... 64

8.4.19 Set discovery mode ....................................................................................... 64

8.5 Security ................................................................................................................ 65

8.5.1 General ......................................................................................................... 65

8.5.2 Get access policy .......................................................................................... 65

8.5.3 Set access policy ........................................................................................... 65

8.5.4 Get users ....................................................................................................... 65

8.5.5 Create users .................................................................................................. 66

8.5.6 Delete users .................................................................................................. 67

8.5.7 Set users settings .......................................................................................... 67

8.5.8 IEEE 802.1X configuration ............................................................................. 68

8.5.9 Create self-signed certificate ......................................................................... 71

8.5.10 Get certificates .............................................................................................. 71

8.5.11 Get CA certificates ........................................................................................ 71

8.5.12 Get certificate status ...................................................................................... 72

8.5.13 Set certificate status ...................................................................................... 72

8.5.14 Get certificate request ................................................................................... 72

8.5.15 Get client certificate status ............................................................................ 73

8.5.16 Set client certificate status ............................................................................. 73

8.5.17 Load device certificate ................................................................................... 74

8.5.18 Load device certificates in conjunction with its private key ............................. 74

8.5.19 Get certificate information request ................................................................. 75

8.5.20 Load CA certificates ...................................................................................... 76

8.5.21 Delete certificate ........................................................................................... 76

8.5.22 Get remote user ............................................................................................. 76

8.5.23 Set remote user ............................................................................................. 77

8.5.24 Get endpoint reference .................................................................................. 77

8.6 Auxiliary operation ................................................................................................ 78

8.7 Monitoring events ................................................................................................. 78

8.7.1 Processor usage ............................................................................................ 78

8.7.2 Link status ..................................................................................................... 79

8.7.3 Upload status ................................................................................................ 79

8.7.4 Operating time ............................................................................................... 79

8.7.5 Environmental conditions ............................................................................... 81

8.7.6 Battery capacity ............................................................................................. 81

---------------------- Page: 6 ----------------------
IEC 60839-11-31:2016 © IEC 2016 – 5 –

8.7.7 Device management ...................................................................................... 82

8.8 Service specific fault codes ................................................................................... 82

9 Device I/O ..................................................................................................................... 86

9.1 General ................................................................................................................. 86

9.2 Relay outputs ........................................................................................................ 86

9.2.1 Overview ....................................................................................................... 86

9.2.2 Get relay outputs ........................................................................................... 86

9.2.3 Get relay output options................................................................................. 86

9.2.4 Set relay output settings ................................................................................ 87

9.2.5 Trigger relay output ....................................................................................... 88

9.3 Digital inputs ......................................................................................................... 88

9.3.1 Overview ....................................................................................................... 88

9.3.2 GetDigitalInputs ............................................................................................. 88

9.4 SerialPorts ............................................................................................................ 89

9.4.1 Overview ....................................................................................................... 89

9.4.2 GetSerialPorts ............................................................................................... 89

9.4.3 GetSerialPortConfiguration ............................................................................ 89

9.4.4 SetSerialPortConfiguration ............................................................................ 89

9.4.5 GetSerialPortConfigurationOptions ................................................................ 90

9.4.6 Send and/or Receive serial command ............................................................ 90

9.5 Capabilities ........................................................................................................... 92

9.6 Events .................................................................................................................. 92

9.6.1 DigitalInput state change ............................................................................... 92

9.6.2 Relay output trigger ....................................................................................... 92

9.7 Service specific fault codes ................................................................................... 93

10 Event handling ............................................................................................................... 93

10.1 General ................................................................................................................. 93

10.2 Real-time Pull-Point notification interface .............................................................. 93

10.2.1 General ......................................................................................................... 93

10.2.2 Create pull point subscription ........................................................................ 95

10.2.3 Pull messages ............................................................................................... 95

10.2.4 Renew ........................................................................................................... 96

10.2.5 Unsubscribe .................................................................................................. 96

10.2.6 Seek .............................................................................................................. 97

10.2.7 Pull point lifecycle .......................................................................................... 98

10.2.8 Persistent notification storage ........................................................................ 98

10.3 Basic notification interface .................................................................................... 98

10.3.1 General ......................................................................................................... 98

10.3.2 Summary ....................................................................................................... 98

10.3.3 Requirements ................................................................................................ 99

10.4 Properties ........................................................................................................... 100

10.5 Notification structure ........................................................................................... 1

...

Questions, Comments and Discussion

Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.