GRConfig: Automatic Setup of Server Connections

If your company has many users who need to set up a remote access to the same server in GoodReader, instead of having them manually enter all the connection parameters, you can create a simple GRConfig file and email it to them.^*

All they have to do is import that file into GoodReader and tap on it.

GRConfig is a simple JSON-formatted text file that contains all the parameters that you would enter into GoodReader`s Server Connection Parameters window by hand. You can create this file in any plain text editor such as TextEdit on a Mac or any other. Just make sure to change the .txt file extension to .grconfig:

{
  "addServers" : [
    
    {
    -- server 1 ---
    },
  
    {
    -- server 2 ---
    }
  
  ]
}

...where instead of "server 1" and "server 2" you place a JSON dictionary with an actual server description.

The server description varies for each server type. Here`s a list of sample descriptions. They are self-explanatory. Just replace the sample text with the actual values required by your server. Any field except for "type" can be omitted.

{
  "type" : "OneDrive,
  
  "readableTitle" : "Your Readable Title Here",
  
  "accessSharePointGroups" : true,
  
  "useCustomRepository" : true,
  "custRep_tenantID" : "your-tenant-id-here",
  "custRep_APIEndpoint" : "your-api-endpoint-here",
  "custRep_LoginEndpoint" : "your-login-endpoint-here",
},

{
  "type" : "WebDAV",
  
  "readableTitle" : "Your Readable Title Here",
  
  "urlAddress" : "your.url.address.here",
  "user" : "YourUserName",
  "domain" : "YourDomainHere",
  "windowsStyleNameEncoding" : false,
  "useCookies" : true,
},

{
  "type" : "FTP",
  
  "readableTitle" : "Your Readable Title Here",
  
  "urlAddress" : "your.url.address.here",
  "user" : "YourUserName",
  "encoding" : "UTF8",
},

{
  "type" : "SFTP",
  
  "readableTitle" : "Your Readable Title Here",
  
  "host" : "your.host.name.here",
  "path" : "your/path/here",
  "pathStartsAtSystemRoot" : false,
  "user" : "YourUserName",
  "keyFilePath" : "/path/to/file/starting/at/MyDocuments",
  "encoding" : "UTF8",
  "serverPort" : 22,
},

{
  "type" : "SMB",
  
  "readableTitle" : "Your Readable Title Here",
  
  "networkAddress" : "your-server-name-or-address-here",
  "user" : "YourUserName",
  "workstation" : "WorkstationNameHere",
  "enforceSMB3Encryption" : false,
}

You can add as many servers as you like in a single GRConfig file. Your users can later modify or delete those servers if they need to. Be sure to test the config file before sending it to your users.

If you need any additional help, drop us a line at support@goodreader.com

* This feature is a part of Pro Pack.