Manage server users with the Wowza Streaming Engine REST API

Use the Wowza Streaming Engine™ media server software REST API to identify and manage users of a Wowza Streaming Engine instance.

Notes:

• Wowza Streaming Engine 4.3.0 or later is required.
• PHP examples for the tasks in this article are available in the tests folder of the PHP REST Library for Wowza Streaming Engine on GitHub.
• Reference documentation for the Wowza Streaming Engine REST API is available by using OpenAPI (Swagger), which you can download and install locally. See Access reference documentation for the Wowza Streaming Engine REST API.

Get a list of server users

View a list of users for a Wowza Streaming Engine instance:

curl -X GET \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v2/servers/{serverName}/users

The command should return a response that lists each user and the groups to which each is assigned, like this:

{
   "serverName": "serverName",
   "users": [
      {
         "userName": "WowzaNinja",
         "groups": [
            "admin",
            "advUser"
         ],
         "passwordEncoding": "bcrypt"
      }
   ]
}

Create a server user

Create a user (WowzaNewbie, in this example) who isn't assigned to any groups:

curl -X POST \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v2/servers/{serverName}/users -d'
{
   "userName": "WowzaNewbie",
   "password":"mypassword",
   "groups": [
      ""
   ],
   "passwordEncoding": "bcrypt"
}

Remove a server user

Delete a user:

curl -X DELETE \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v2/servers/{serverName}/users/WowzaNewbie