1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
Validating APIs
````````````````
Please make sure you go through this before you wonder why zmNinja is not working.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Assumption: Your ZM server is accessible at ``http://server/zm`` ->
replace this with your actual path
.. important::
Make sure you have the following settings in ZM:
- ``AUTH_RELAY`` is set to hashed
- A valid ``AUTH_HASH_SECRET`` is provided (not empty)
- ``AUTH_HASH_IPS`` is disabled
- ``OPT_USE_APIS`` is enabled
- If you are using any version lower than ZM 1.34, ``OPT_USE_GOOG_RECAPTCHA`` is disabled
- If you are NOT using authentication at all in ZM, that is ``OPT_USE_AUTH`` is disabled, then make sure you also disable authentication in zmNinja, otherwise it will keep waiting for auth keys.
Make sure ZM APIs are working:
''''''''''''''''''''''''''''''
**Note 1**: nginx users, if you are facing API issues, please see if `this
page <https://github.com/pliablepixels/zmNinja/wiki/How-to-configure-APIs-with-nginx>`__
helps)
**Note 2**: It is **important** that you run the API tests from the device you plan to use zmNinja with. Very often, I've seen folks doing API tests on the same server ZM is running on and then face issues (mostly due to network connectivity) when using zmNinja because it is running on a different device. So, I'd recommend you open a chrome browser on the device you plan to use zmNinja on (desktop or mobile) and then run these tests.
- Step 1: Open up a browser
- Step 2: Log into ZM
- Step 3: Open another tab in the same browser (**IMPORTANT**: Has to
be from the same browser you logged into ZM)
- Step 4: Type in ``http://server/zm/api/host/getVersion.json`` --> you
should see a response like:
.. code:: json
{
"version": "1.30.0",
"apiversion": "1.0"
}
version/apiversion may be different. If you don't see such a
response, your APIs are **not** working
- Step 5:Make sure you can see monitors and events:
Type in ``http://server/zm/api/monitors.json`` --> you should see a
response like:
.. code:: jsonld
{
"monitors": [
{
"Monitor": {
/*lots of additional details*/
},
/*more monitor objects if you have more than one*/
}]
}
- Step 6: (If you find your APIs show ok, but zmNinja has issues)
- Open a browser, log into ZM
- Open a new tab, enter ``http://server/zm/api/host/getVersion.json``
- Now, right click and do a ``View Source`` in your browser (different
browsers may have different names for it). This brings up a full
source code view of the page. Do you ONLY see the JSON output or do
you see gobs of HTML on top like ``<pre class=`` and lots of cake
related messages? If you do, you need to fix it.
if you find the page empty, your APIs/permissions have a problem. Please
post in the ZM forums (**please DON'T** contact me first as its not a
zmNinja bug)
Type in ``http://server/zm/api/events.json`` --> you should see a
response like: (this list may be an empty set if you don't have events
but you will still see the ``{"events":[]}`` text - if you find the page
empty, your APIs have a problem. Please post in the ZM forums (please
**DON'T** contact me first, as its not a zmNinja bug)
.. code:: jsonld
{"events":[{"Event":{ /* many more details */ }}]}
Top reasons why monitors and events API returns blank while getVersion
works:
* You don't have monitor/event view permissions allocated
* You don't have system view permissions (zmNinja needs this to access ``/servers.json`` API)
* You have an invalid camera definition (happens sometimes when you remove and re-add cameras)
zmNinja API notes:
^^^^^^^^^^^^^^^^^^
- Please make sure the user credentials you use has:
- view or edit access to monitors
- view or edit access to streams
- view or edit access to system
- If you are accessing zmNinja remotely, make sure you first access ZM
remotely from your desktop browser, ensure it works and then use the
same DNS/IP for zmNinja
|
