Credentials and Cloud

There are two credential files used by SyncOS: certificate file and Rclone configuration file. They are in SyncOS USB drive's root directory and shown as userid__SyncOS.crt.tes, and rclone.conf.tes.

These two credential files are encrypted and copied using SyncOffice Manager, the original source plaintext files are userid__SyncOS.crt, and rclone.conf.

Boot Step: Password Update

SyncOS always set the Linux user as "teleon". Its password is set by customer's administrator, and is stored in the attached certificate file.

After boot up, SyncOS will search for userid__SyncOS.crt.tes file, decipher it and retrieve the Linux user password. Then SyncOS rc.local procedure updates the SyncOS teleon user's password accordingly.

This password update procedure should be done in a fraction of a second. In some cases if you login password is rejected, please wait a few seconds and then retry again. In rare case, you may need to reboot it again. Use faster USB thumb drive and large enough PC memory will greatly improves your experiences.

Boot Step: Connect To Cloud

The second task after update password is connecting to cloud.

SyncOS will search for rclone.conf.tes file, decipher it and retrieve the cloud connection type, server IP/domain and port, as well as login user/password.

An sample rclone.conf's content is similar as follow:

rclone-conf

Rclone cloud connection has two layers, an ordinary remote connection layer and a top extra layer to add encryption. The ordinary remote connection layer covers various of different backend types. Administrator needs to use SyncOffice Manager's Rclone tab page to set up Rclone remote connections, and then use the generated Rclone.conf for his end-users.

The following are part of popular Rclone supported backend. You can refer to Rclone supported cloud storage system for latest full list.

  • Amazon Drive
  • Amazon S3
  • Box
  • Dropbox
  • FTP
  • Google Cloud Storage
  • Google Drive
  • HDFS
  • HTTP
  • Memory
  • Microsoft Azure
  • Microsoft OneDrive
  • OpenDrive
  • SFTP
  • WebDAV
  • Yandex Disk
  • Zoho WorkDrive
  • The local file system

You can find in most cases, the Rclone needs network connection. So SyncOS's Rclone cloud connection procedure is designed to be triggered by Debian network connection event.

So after boot up, please check your network connection before you hurry up to open file repository stored on cloud.

Within SyncOS, the Rclone cloud drive is mapped to /loopfs_user_home/home/teleon/rclone-cloud folder. Under SyncOS, you can check the cloud drive content using LibreOffice/SyncOffice. After Launch LibreOffice/SyncOffice Startup, click "Open File" button, you can find it goes to /teleon/rclone-cloud folder. Refer to below example case.

rclone-folder

The files shown in /loopfs_user_home/home/teleon/rclone-cloud are mapped from the cloud storage drive after Rclone cloud connected. Typically they look like the same as local stored files.

Please note for those cloud stored files, when you use LibreOffice/SyncOffice application to open it for the first time, sometimes it may look like a empty file. If you encounter such a case, please close the file, and then re-open it after a few seconds. It will show up the correct content of the file.