Menu List

<
Additional Information
Cautions on Use
Care and Storage
Trademarks
Security Threats

Security Threats

Necessary preparations

Images and video files stored on the RICOH THETA Z1 are important information assets and require appropriate security measures to reduce the risk of information leaks and unauthorized use. To ensure safe use, the operating environment and equipment must be properly configured according to the user's information security policy.

Means of Control

RICOH THETA Z1 (henceforth THETA) can be controlled via wireless LAN, wired LAN, USB, Bluetooth®, and buttons on the unit. The security risks for each of these are as follows

Specifications
Means of control Initial Configuration Risk Starting procedure
Wireless LAN AP (access point) mode OFF SSID and encryption key can be used to remotely connect and control the device, which requires proper management. Enable the function before connecting from the device.
Wireless LAN CL (Client) Mode OFF Even if Digest Authentication is set, proper management is required because the user name and password can be controlled via WebAPI if they are compromised. Configure the necessary settings for connection using the API before enabling the function.
Wired LAN OFF As with wireless LAN (CL mode), proper management is required. A wired LAN adapter must be connected to the USB port.
USB(MTP) ON Connect to a PC via USB cable to retrieve images and video files stored on THETA; camera can also be controlled via MTP. Please note the operating environment. Connection via USB cable capable of data transmission is required.
USB(UVC) OFF Video and audio can be acquired from THETA by connecting to a PC with a USB cable. Pay attention to the operating environment. Requires activation of the function and connection with a USB cable capable of data communication.
Bluetooth® (Low Energy)
(Low Energy)
OFF (~v3.50)
ON(v3.50~)
Connection using WebAPI or direct access without authentication is available, and information acquisition is enabled by BLEAPI, so please pay attention to the operating environment. Connection from the device is required.
Bluetooth® (Classic)
(Classic)
OFF Connection to devices with specific profiles is available. Requires plug-in.
Operation Buttons No Lock The power button turns power on and off, and the wireless button turns wireless LAN and Bluetooth® on and off. Power ON

Setting ranges and procedures related to each operation method are as follows

Wireless LAN

Wireless LAN can be set to OFF, AP mode, or CL mode. Wireless LAN is turned off in Sleep mode.
Wireless LAN is turned off when connected to a PC via USB cable. (~v3.50)

How to use Wireless LAN setting

By pressing the WLAN button, you can switch between OFF, AP mode, and CL mode, in that order. The mode can also be selected using the API.
CL mode can be switched only when router information is set.

Configuration Value
Configuration Value Initial value Setting Method Description
Network type OFF WebAPI Options._networkType Network type to use
MTPAPI 0xD81D NetworkType
BLEAPI Set network type

AP (Access Point) mode

Specification AP (Access Point) Mode
Network Interface Wireless LAN
1.WPA2-Personal
2.Encryption method: AES
3.Wireless LAN mode: Access Point
The default specifications are as follows
SSID: ""THETA""+""serial number""+"".OSC"""
Encryption key (passphrase): Random 8-digit string
Encryption key (passphrase): last 8 digits of the serial number
The initial value of the encryption key can be checked by pressing the shutter release button for 2 seconds while holding down the WLAN button. (v3.50~)
Service Protocol HTTP
Service Protocol Authentication Method None
Service Protocol Encryption Method None
Provided Services The Web API specification is available at
https://docs-theta-api.ricoh360.com/web-api/index.html
How to use Connecting in AP mode
  1. Turn on the THETA and press the WLAN button to switch to AP mode.
  2. Search for the THETA's SSID (by default, the THETA's serial number (2 alphabetic characters + 8 digits) + .OSC) from the device you are using.
  3. Connect to THETA's SSID from the device you are using. At this time, you will need to enter the encryption key.
Setting value
Setting value Initial value Setting Method Description
SSID Serial number (2 alphabetic characters + 8 digits) + .OSC WebAPI Options._ssid
Can be set/obtained in WLAN AP mode
Name to identify the THETA's WLAN
MTPAPI N/A
BLEAPI N/A
Encryption key (passphrase) Set per device WebAPI Options.wifiPassword
Encryption key can be set
Options._defaultWifiPassword
Allows you to get the factory default encryption key
Encryption key used when connecting in AP mode
Can be changed using the RICOH360 Smartphone App

Passwords can be set to a length of eight digits, but this makes them vulnerable to brute force attacks. Please take measures such as making the password longer or selecting characters from multiple sets, including uppercase and lowercase letters, numbers, and special characters.
MTPAPI 0xD806 Passphrase
BLEAPI Get Options
Get the factory encryption key
Read WLAN password state
Get encryption key update status
Frequency setting 2.4GHz WebAPI Options._wlanFrequency
Can be set/retrieved in WLAN AP mode
Can be retrieved in WLAN CL mode
Frequency setting used in AP mode
MTPAPI 0xD821 Wlan Frequency
BLEAPI N/A

CL (Client) mode: Control via WebAPI

Specifications
Network Interface Wireless LAN
1.Authentication Method: none, WEP, WPA/WPA2-PSK
2.Encryption method: AES
3.Wireless LAN mode: Client(Station)
SSID and password of the access point to be connected must be set.
Wired LAN (USB-LAN adapter )
1.Authentication Method: none, WEP, WPA/WPA2-PSK
2.Encryption method: AES
Service Protocol HTTP
Detect the camera IP address using mDNS
Service Protocol Authentication Method HTTP Digest Access Authentication
Service Protocol Encryption Method None
Provided Services The Web API specification is available at
https://docs-theta-api.ricoh360.com/web-api/index.html
How to use Connect in wireless LAN CL mode

When controlling via the API, digest authentication settings are required. It is also necessary to configure settings according to the network used.
When using the wireless LAN CL mode, information on the router to be connected must be registered. These settings must be configured using wireless LAN or MTP.

When setting up using wireless LAN (AP mode)

  1. Connect in AP mode.
  2. Set the user name and password for digest authentication.
  3. Set the frequency band to be used.
  4. Register the router to be connected.

When setting up with MTP

  1. Turn on the THETA.
  2. Connect to a PC via USB.
  3. Set the user name and password for digest authentication.
  4. Register the router to be connected.
Setup value
Set value Initial value Setting Method Description
Authentication method digest WebAPI N/A Authentication method used in CL mode
MTPAPI N/A
BLEAPI N/A
Digest Authentication User Name THETA+ serial number (2 alphabetic characters + 8 digits) WebAPI Options._username
Can be set in WLAN AP mode
User name used for digest authentication
MTPAPI 0xD815 Username
BLEAPI N/A
Digest Authentication Password Not set or 8 digits of serial number (2 alphabetic characters + 8 digits) WebAPI Options._password
Can be set in WLAN AP mode
Password to be used for Digest Authentication.
Cannot be used unset.

Passwords can be set to a length of eight digits, but this makes them vulnerable to brute force attacks. Please take measures such as making the password longer or selecting characters from multiple sets, including uppercase and lowercase letters, numbers, and special characters.
MTPAPI 0xD816 Password
BLEAPI N/A
Access Point Information Not set WebAPI camera.setAccessPoint
Can be set in WLAN AP mode
Information on the access point (router) to be connected in WLAN CL mode
MTPAPI 0x99A5 SetAccessPoint
BLEAPI Set Access Point
Proxy Information Not set WebAPI camera.setAccessPoint
Proxy information to connect in wireless LAN CL mode
MTPAPI N/A
BLEAPI N/A

Wired LAN

How to use Connected via wired LAN

When controlling via API, digest authentication settings are required. Settings must also be made according to the network used.
These settings must be made using wireless LAN or MTP.
After completing the settings, connect the wired LAN adapter and connect it to the router with a wired LAN cable.

When setting up using wireless LAN (AP mode)

  1. Connect in AP mode.
  2. Set user name and password for Digest Authentication.
  3. Set the wired LAN connection configuration if necessary.

When configuring with MTP

  1. Turn on the THETA.
  2. Connect to a PC via USB.
  3. Set the Digest Authentication user name and password.
  4. Set the wired LAN connection configuration if necessary.
Configuration Value
Set value Default value Setting Method Description
Authentication method digest WebAPI N/A Authentication method used in CL mode
MTPAPI N/A
BLEAPI N/A
Digest Authentication User Name THETA+ serial number (2 alphabetic characters + 8 digits) WebAPI Options._username
Can be set in WLAN AP mode
User name used for digest authentication
MTPAPI 0xD815 Username
BLEAPI N/A
Digest Authentication Password Not set or 8 digits of serial number (2 alphabetic characters + 8 digits) WebAPI Options._password
Can be set in WLAN AP mode
Password to be used for Digest Authentication.
Cannot be used unset.

Passwords can be set to a length of eight digits, but this makes them vulnerable to brute force attacks. Please take measures such as making the password longer or selecting characters from multiple sets, including uppercase and lowercase letters, numbers, and special characters.
MTPAPI 0xD816 Password
BLEAPI N/A

CL (Client) mode: Controlled by RICOH360 Cloud

Specifications
Network Interface Wireless LAN
1.Authentication Method: none, WEP, WPA/WPA2-PSK
2.Encryption method: AES
3.Wireless LAN mode: Client(Station)
SSID and password of the access point to be connected must be set.
Wired LAN (USB-LAN adapter)
1.Authentication Method: none, WEP, WPA/WPA2-PSK
2.Encryption method: AES
Service Protocol MQTT
Service Protocol Authentication Method MQTT connection with mutual TLS(mTLS) authentication
Service Protocol Encryption Method TLS
How to use

https://support.ricoh360.com/manual/z1-ricoh360-app-upload-02?apps=ricoh360-app

CL (Client) mode: live streaming

Specifications
Network Interface Wireless LAN
1.Authentication Method: none, WEP, WPA/WPA2-PSK
2.Encryption method: AES
3.Wireless LAN mode: Client(Station)
SSID and password of the access point to be connected must be set.
Wired LAN (USB-LAN adapter )
Tethering connection
1.Authentication Method: none, WEP, WPA/WPA2-PSK
2.Encryption method: AES
Service Protocol WebRTC
WebSocket-TLS
Service Protocol Authentication Method JWT
Service Protocol Encryption Method DTLS, SRTP, TLS
Usage Method

In preparation

Bluetooth® (Bluetooth®)

Bluetooth® Low Energy (BLE) and Bluetooth® Classic are controlled independently; to control THETA, you must connect via BLE.

Specifications
Interface Bluetooth® Low Energy
1.Profile: GATT
2.Security: Some models have multiple connections.
BLE(standard)
- BLE Security mode 1
BLE(proprietary) :Used only by RICOH smartphone apps
- BLE Security mode 1
- RICOH proprietary password 3.
3.BLE mode: Peripheral
Service Protocol GATT
Service Protocol Authentication Method BLE(standard)
    None
BLE(proprietary) :Used only by RICOH smartphone apps
    RICOH proprietary password
Service Protocol Encryption Method BLE(standard)
    None
BLE(proprietary) :Used only by RICOH smartphone apps
    None
Provided Services The Bluetooth® API specification is available at
https://docs-theta-api.ricoh360.com/bluetooth-api/
Camera control command v2 service
WLAN Control Command service
WLAN Control Command v2 service
Registration to RICOH360 Cloud can only be performed with RICOH applications.
How to useConnect via Bluetooth®: BLE(standard)

BLE is enabled by default. (Disabled until v3.50~). If disabled, it must be enabled using the API or by operating the main unit.
The THETA can be controlled as a peripheral device by following the steps below.


  1. Turn on the THETA.
  2. Press and hold the WLAN button.
  3. Search for the THETA (the last 8 digits of the serial number) via Bluetooth® from the device to be used.
  4. Connect from the device.

If you are connecting a remote controller, you must connect the device with a plug-in.


Procedure


Connect via Bluetooth®: BLE(proprietary)

Previously supported by RICOH Smartphone App.

Setting value
Setting value Initial value Setting method Description
Bluetooth® status OFF(~v3.50)
ON(v3.50~)
WebAPI Options._bluetoothPower
Can be set/obtained in WLAN AP/CL mode
Enables/disables Bluetooth® switching
MTPAPI N/A
BLEAPI N/A

USB

Specification
InterfaceCompliant with the following standards:  
    USB Spec.3.2 super speed standard
    USB2.0 High speed standard
Service Protocol MTP (Media Transfer Protocol)
UVC (USB Video Class)
Service Protocol Authentication Method None
Service Protocol Encryption Method None
Provided Services The MTP API specification is available at
https://docs-theta-api.ricoh360.com/usb-api/
How to use Connecting via USB

When controlling via USB, it must be determined whether the device is to be used as an MTP device or a UVC device.

When setting up via button operation

  1. Turn on the THETA power.
  2. Connect to a PC with a USB cable.
  3. Press the Mode button to switch between still image, movie, and live streaming (UVC).

Operating Device

The operation of the unit's Power button, WLAN button, Shutter button, Mode button, and Fn button cannot be inhibited.

Device Settings

Location and date/time information is recorded in images and videos. These settings affect the integrity of the information.

Location Information

Location information added to images and videos can be set using the API; there is no built-in GPS.
Azimuth information acquired using an electronic compass is recorded in magnetic north.

Setting value
Set value Default value Setting Method Description
Location Not set WebAPI Options.gpsInfo
Can be set/retrieved in WLAN AP/CL mode
Location information
MTPAPI 0xD801 GpsInfo
BLEAPI N/A

Date and time information

Allows you to set the date and time information for this product.

Set value
Set value Default value Setting Method Description
Date, time, and time zone information 01/01/2019 00:00:00
WebAPI Options.dateTimeZone
Can be set/retrieved in WLAN AP/CL mode
Date, time, and time zone information
MTPAPI 0x5011 DateTime
BLEAPI N/A

Power status setting

The API can be used to control the camera power. However, it is not possible to wake up the camera from a powered-off state.
The camera buttons can be used to control power on, sleep, and power off.

Setup Value
Setup Value Default value Setting Method Description
Power status OFF WebAPI Options._cameraPower
Can be set/retrieved in WLAN AP/CL mode
Set power status
MTPAPI 0x1013 PowerDown
0xD80E SleepMode
BLEAPI N/A
Sleep mode transition time 180 (seconds)
WebAPI Options.sleepDelay
Can be set/obtained in WLAN AP/CL mode
Period of inactivity (in seconds) before entering sleep mode
MTPAPI 0xD803 SleepDelay
BLEAPI N/A
Power OFF transition time 64800 (sec)
WebAPI Options.offDelay
Can be set/retrieved in WLAN AP/CL mode
Period of inactivity from sleep mode to power off (60+ seconds in seconds)
MTPAPI 0xD81B AutoPowerOffDelaySec
BLEAPI N/A
Restart WebAPI N/A Restart
MTPAPI 0x99AF Reboot
BLEAPI N/A

Device Log

The device logs at least 1000 events for critical information assets such as images and video files.
This log can be accessed via WebAPI.

How to get
API Name getEventLog
URL /log/eventLog /log/eventLog
Content-Type Text/plain;
Charset Charset=UTF-8
method GET

Vulnerability Response

We recommend firmware updates to address software vulnerabilities. Firmware update information will be posted on our website and smartphone applications.
https://support.ricoh360.com/system-information

How to update the firmware

Please refer to the User's Manual for instructions on how to update the firmware.

Update using the RICOH360 Smartphone App

https://support.ricoh360.com/manual/z1-ricoh360-app-firm-update-01

Update using the basic application for PCs

https://support.ricoh360.com/manual/z1-update-01?apps=ricoh-theta

Update from RICOH360 Cloud

https://support.ricoh360.com/manual/ricoh360-web-08

Delete and initialize registered information

Connection information stored on the THETA main unit can be initialized by performing the following operations.
To delete the RICOH360 registration on the THETA main unit, delete it from the application.
Images and videos stored on the THETA main unit can also be deleted from a USB-connected PC.

THETA Z1
Registration Information Initialization to factory defaults Reset settings Initialization of connection information Storage format
N/A API WLAN + Mode button 6 sec. long press/API API
Network type Initialize ( OFF ) Initialize ( OFF ) N/A N/A
SSID Initialize Initialize N/A N/A
Encryption key (passphrase) Initialize Initialize Initialize N/A
Frequency setting ( AP mode ) Initialize ( 2.4GHz ) Initialize ( 2.4GHz ) Initialize ( 2.4GHz ) N/A
Digest Authentication User Name Initialize Initialize N/A N/A
Digest Authentication Password Initialize Initialize N/A N/A
Access point information Initialize ( delete ) Initialize ( delete ) N/A N/A
Proxy information Initialize ( delete ) Initialize ( delete ) N/A N/A
Wired LAN connection settings Initialize Initialize N/A N/A
Bluetooth® status Initialize ( OFF ) Initialize ( OFF ) N/A N/A
Connection information with Bluetooth® peripherals Initialize ( delete ) Initialize ( delete ) N/A N/A
Connection information with Bluetooth® terminal N/A N/A N/A N/A
Location information set by API delete N/A N/A N/A
Date and time zone information Initialize Initialize N/A N/A
Sleep mode transition time Initialize Initialize N/A N/A
Power off transition time Initialize Initialize N/A N/A
Still image/video file Initialize ( delete ) N/A N/A Initialize ( delete )
Device log Initialize ( delete ) N/A N/A N/A
RICOH360 Registration Information Initialize ( delete ) N/A N/A N/A

Set value
Type of processing Operation Method Setting Method ( API )
Initialization to shipping state N/A WebAPI N/A
MTPAPI N/A
BLEAPI N/A
Configuration reset N/A WebAPI camera.reset
Can be set/retrieved in WLAN AP/CL mode
MTPAPI 0x1017 ResetDevicePropValue [*1].
BLEAPI N/A
Connection information initialization While holding down the WLAN button
Press Mode button for 6 seconds
WebAPI camera._deleteAccessPoint [*2].
Can be set/retrieved in WLAN AP/CL mode
MTPAPI N/A
BLEAPI N/A
Format N/A WebAPI camera.delete
Can be set/retrieved in WLAN AP/CL mode
MTPAPI 0x100B DeleteObject
BLEAPI N/A

[*1] Reset the DeviceProperties defined in the MTP.
[*2] Deletes access point information configured via API.

Supplementary Information