Skip to content

Commit 199aae2

Browse files
committed
add support for basic authentication over https
1 parent ae44f9e commit 199aae2

2 files changed

Lines changed: 23 additions & 2 deletions

File tree

doc/Core.xml

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -553,6 +553,8 @@
553553
<para role="reference">&lt;<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.ietf.org/rfc/rfc2617.txt"></link>&gt;</para>
554554
<para>RFC 7616, HTTP Digest Access Authentication</para>
555555
<para role="reference">&lt;<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.ietf.org/rfc/rfc7616.txt"></link>&gt;</para>
556+
<para>RFC 7617, The 'Basic' HTTP Authentication Scheme</para>
557+
<para role="reference">&lt;<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.ietf.org/rfc/rfc7617.txt"></link>&gt;</para>
556558
<para>RFC 3315, Dynamic Host Configuration Protocol for IPv6 (DHCPv6)</para>
557559
<para role="reference">&lt;<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.ietf.org/rfc/rfc3315.txt"></link>&gt;</para>
558560
<para>RFC 3548, The Base16, Base32, and Base64 Data Encodings</para>
@@ -2270,11 +2272,15 @@ DATE: when response was generated
22702272
<listitem>
22712273
<para>TLS client authorization and</para>
22722274
</listitem>
2275+
<listitem>
2276+
<para>Devices supporting HTTP Basic authentication according to [RFC 7617], only over HTTPS, and</para>
2277+
</listitem>
22732278
<listitem>
22742279
<para>Devices supporting JWT client authorization based on [RFC 6750], only over
22752280
HTTPS.</para>
22762281
</listitem>
22772282
</itemizedlist>
2283+
<para>A device that supports HTTP Basic authentication over HTTPS shall signal the HttpBasic capability as true.</para>
22782284
<para>If server supports both digest authentication as specified in [RFC 2617] and the user name token profile as specified in WS-Security the following behavior shall be adapted: a web service request can be authenticated on the HTTP level via digest authentication [RFC 2617] or on the web service level via the WS-Security (WSS) framework. If a client does not supply authentication credentials along with a web service request, the server shall assume that the client intends to use digest authentication [RFC 2617], if required. Hence, if a client does not provide authentication credentials when requesting a service that requires authentication, it will receive an HTTP 401 error according to [RFC 2617]. Note that this behaviour on the server’s side differs from the case of supporting only username token profile, which requires for this case an HTTP 400 error on the HTTP level and a SOAP:Fault env:Sender ter:NotAuthorized error on the WS level.</para>
22792285
<para>A client should not simultaneously supply authentication credentials on both the HTTP level and the WS level. If a server receives a web service request that contains authentication credentials on both the HTTP level and the WS level, it shall first validate the credentials provided on the HTTP layer. If this validation was successful, the server shall finally validate the authentication credentials provided on the WS layer.</para>
22802286
<para><xref linkend="AuthenticationFlow"/> summarizes the authentication of a web service request by a server over HTTP and HTTPS.</para>
@@ -2290,7 +2296,7 @@ DATE: when response was generated
22902296
<para>JWT client authorization should only be used over TLS secured connections, in order to
22912297
protect bearer tokens against replay attacks.</para>
22922298
<para>An ONVIF compliant device should authenticate an RTSP request at the RTSP level. If HTTP is used to tunnel the RTSP request the device shall not authenticate on the HTTP level.</para>
2293-
<para>When authenticating RTSP or HTTP methods, an ONVIF compliant device shall use digest authentication [RFC 2617] or JWT-based authorization. The credentials shall be managed with the GetUsers, CreateUsers, DeleteUsers and SetUser methods. If the device also supports WS-Security, the same set of credentials shall be used.</para>
2299+
<para>When authenticating RTSP or HTTP methods, an ONVIF compliant device shall use digest authentication [RFC 2617], HTTP Basic authentication [RFC 7617] or JWT-based authorization. The credentials shall be managed with the GetUsers, CreateUsers, DeleteUsers and SetUser methods. If the device also supports WS-Security, the same set of credentials shall be used.</para>
22942300
</section>
22952301
<section>
22962302
<title>Authentication over SCTP</title>
@@ -3262,7 +3268,7 @@ onvif://www.onvif.org/name/ARV-453
32623268
</entry>
32633269
</row>
32643270
<row>
3265-
<entry morerows="17">
3271+
<entry morerows="18">
32663272
<para>Security</para>
32673273
</entry>
32683274
<entry>
@@ -3296,6 +3302,16 @@ onvif://www.onvif.org/name/ARV-453
32963302
<para>Indication if the device supports the HTTP digest authentication. </para>
32973303
</entry>
32983304
</row>
3305+
<row>
3306+
<entry>
3307+
<para>HttpBasic</para>
3308+
</entry>
3309+
<entry>
3310+
<para>Indication if the device supports HTTP Basic authentication according to
3311+
[RFC 7617], only over HTTPS. For backward compatibility this feature is
3312+
disabled by default.</para>
3313+
</entry>
3314+
</row>
32993315
<row>
33003316
<entry>
33013317
<para>X.509Token</para>

wsdl/ver10/device/wsdl/devicemgmt.wsdl

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -227,6 +227,11 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO
227227
<xs:documentation>Indicates support for WS over HTTP digest authenticated communication layer.</xs:documentation>
228228
</xs:annotation>
229229
</xs:attribute>
230+
<xs:attribute name="HttpBasic" type="xs:boolean">
231+
<xs:annotation>
232+
<xs:documentation>Indicates support for WS over HTTPS basic authenticated communication layer according to RFC 7617. For backward compatibility this capability is disabled by default.</xs:documentation>
233+
</xs:annotation>
234+
</xs:attribute>
230235
<xs:attribute name="RELToken" type="xs:boolean">
231236
<xs:annotation>
232237
<xs:documentation>Indicates support for WS-Security REL token.</xs:documentation>

0 commit comments

Comments
 (0)