Preferences

KosmicTask Help

Preferences

To display the preferences panel select menu KosmicTask - Preferences... (command - comma)

General

The general preferences tab contains the following options:

Share my tasks when I log in
When the user logs in their tasks are made available to other KosmicTask users on the network. The KosmicTask application window will not be displayed unless the user launches the application.
Pin task when executed
This option will automatically pin a task tab once it has been executed. This behaviour prevents task results from being replaced with newly selected tasks.
Display group list when sidebar hidden
When the application sidebar is hidden the task browser may not list all the available tasks. Selecting this option adds a group list to the task browser whenever the sidebar is hidden.
Check for application updates
The application will check for updates at startup. If an update is found the user is prompted to install it. Manual update checks can be performed using menu KosmicTask - Check for Updates...

Tabs

The tabs preferences tab contains the following options:

Command-click opens a task in a new tab
When enabled a command click selection in the task browser opens the task in a new tab.
Alt-click opens a task in a new tab
When enabled an alt click selection in the task browser opens the task in a new window.
Confirm before closing multiple tabs or windows
Enables a warning message when closing the application and multiple tabs or windows are open. Task results and files are only retained while the containing task tab or window remains open. When the task closes all results and files are deleted unless previously saved.
Pin task
When browsing through a list of tasks each item selected is displayed in the active task tab. This enables the user to easily assess a sequence of tasks without opening a separate tab for each task. When this option is enabled any task that the user explicitly opens in a new tab is automatically pinned. Pinned task tabs cannot have their task replaced.

Security

Preference window security

By default all communications to and from KosmicTask are encrypted using SSL (TLS v1) to ensure privacy. This applies to local, remote and Internet based communication. If the application is being used in a single user or trusted environment then the encryption can be disabled for public task access if performance/network throughput has to be maximised. A closed padlock icon in the top right of the application windows indicates that a secure connection is currently in use. User mode and admin access to KosmicTask involves the exchange of user authentication details and for this reason encryption is non optional for these modes.

A task has the capability to obtain data from many application and operating system sources. This data may be of a personal or sensitive nature. It is therefore important that the SSL encryption remains enabled so that data transmitted over public networks cannot be observed. Only disable the encryption if you are using KosmicTask in a private or secure network environment.

Disclose your username to other KosmicTask users
By default your user name will not be visible to other KosmicTask users in the sharing information browser view. You may optionally disclose your user name only to local users or to all users. When logging in to remote instances of KosmicTask a valid user name and password combination may be required.
Encrypt public tasks
Enables encryption of public task information. SSL encryption is enabled by default and is the recommended configuration.
Show SSL Certificate
SSL encryption requires a digital certificate in order to establish a secure connection and to maintain the integrity of that connection. By default KosmicTask will generate a suitable self signed root certificate and store it in the Keychain for future use. The fact that the certificate reports "This root certificate is not trusted" is not indicative of an error or problem. It merely highlights the fact that the certificate is a self signed root and was not issued by a root authority such as Thawte, VeriSign or Comodo. KosmicTask uses the certificate solely to enable encryption not to establish a trust relationship.

Password Security

All entered user passwords, for either the local or remote instances of KosmicTask, may be saved into the system Keychain for secure storage and easy retrieval. KosmicTask uses SSL encryption when transmitting authentication details over the network.

Internet Sharing

An integrated port mapper is included to facilitate easy access to KosmicTask from the Internet. By default Internet sharing is disabled. The current Internet sharing status is displayed in the bottom right hand corner of the application window.

Once Internet sharing has been enabled it should be possible to connect to the shared instance of KosmicTask using the connections sheet.

When enabling Internet sharing you should be aware that all public scripts will be available to any user who connects via the Internet. If in doubt about this then do not share any of your tasks so that users are forced to authenticate. Always ensure that SSL encryption is selected when enabling Internet sharing (see application Preferences - Security).

To enable Internet sharing click the Internet status display or select the Internet tab in the preferences panel at KosmicTask - Preferences. Note that the automatic sharing facility requires a UPnP or NAT-PMP compliant router. In the absence of this a manual router configuration will be required in order to accept incoming external requests.

Preference window internet
Allow other users to connect via the Internet
Enable external users to connect via the Internet. Click Start to begin sharing and Stop to end. If the operation is successful the sharing indicator will turn green. Otherwise an error condition will be reported.
External port number
The TCP port number on which the router should accept external connections. By default all instances of KosmicTask use port 7742 for local and remote network communication. However, if the router is already mapping port 7742 for another instance of KosmicTask then the next highest available port number will be automatically assigned and displayed. This automatic assignment may move the port into the range registered for another application (though it is very unlikely that the registered application will be present). If a particular automatic port assignment causes problems then simply change the port to a known unused port number. IANA maintains the master list of registered ports.
Remote KosmicTask users wishing to connect should enter this port number into the Port number field of the connections sheet.
External IP address
The external IP address of your router. Remote KosmicTask users wishing to connect should enter this IP address into the Connect to field of the connections sheet.
Gateway name
Router/gateway name as reported by router.
Automatically start Internet sharing
Internet sharing will start automatically whenever KosmicTask is launched. Defaults to off.

Manual Router Configuration

Consult your router documentation to determine how to open an external port (7742) and direct it to the local IP of your machine on port 7742. Should you need to obtain your local network IP address you can consult System Preferences-Network (select the connected interface - Airport, Built-in Ethernet etc).