.. _misc: Misc ==== Authentication """""""""""""" Basic ^^^^^ The default authorisation used is Basic Authentication. This requires providing a basic authentication header with each request. DotCMIS :ref:`sample` .. code-block:: xml Authorization: Basic UkRcY21pczpDTUlTcXVhbGl0eQ== NT ^^^ Authentication with NT also uses the same Basic auth header. The difference here is that the domain name must also be included with the request. e.g. To use the cmis user on the RD domain, the following header would be used: ``RD\cmis:CMISquality`` .. code-block:: xml Authorization: Basic UkRcY21pczpDTUlTcXVhbGl0eQ== Alternatively, you can use the standard username/password combination for the authorization header value and pass the domain using a custom AuthDomain header value: ``cmis:CMISquality`` .. code-block:: xml Authorization: Basic Y21pczpDTUlTcXVhbGl0eQ== AuthDomain: RD .. _oauthauthentication: OAuth ^^^^^ Authentication using OAuth is fairly similar to the standard authentication processes. The only difference is that the authorization header is set as a Bearer token. DotCMIS :ref:`sample` .. Important:: The session User and Password parameters MUST be null to use Bearer tokens. .. code-block:: xml Authorization: Bearer c2577e83-a71e-4d73-b1b8-e180789c6953 .. _paging: Paging """""" .. sidebar:: Total Items In order to improve performance most result sets will not include the total number of items. Instead, a count between 0 and 100 will be returned. If 100 results are returned it can generally be assumed that more pages are available. Result sets in CMIS can by paged by passing through pageSize and skipCount parameters. One thing to keep in mind while using this functionality is that the skipCount parameter must be a valid multiple of the pageSize value. e.g. if pageSize = 10, skipCount should be 0, 10, 20, 30, 40, 50, 60, ... Change Event Paging ^^^^^^^^^^^^^^^^^^^ See :ref:`Change Event Paging`