The settings on the Client Certificate Key Store tab are only required when a client requires that HTTPS connections are authenticated with a certificate.
Key Store File
The location of the key store containing the client certificates and private keys. This is required only when the GHTTPS server requires that HTTPS clients are authenticated with a certificate. You can browse for the client key store on the file system by clicking the button next to the field. Certificates can be managed inGoAnywhere Director'sSSL Certificate Managerscreen.
A default key store is provided inGoAnywhere Directorfor holding client certificates and private keys. The location of this key store is[installdirectory]/userdata/keys/x509/privateKeys.jkswhere [installdirectory] is the installation directory of theGoAnywhere Directorproduct.
Client Certificate Store Password
The password to use for accessing the Client Certificate Store. After entering the password, you can optionally click theEncryptbutton, which will encrypt the password when it is stored inGoAnywhere Director'sdatabase.
If you do not wish to store the password with the GHTTPS server resource, this password can be supplied when executing a Project.
Is Password Encrypted
Indicates whether or not the password for the Client Certificate Store is encrypted. You should choose the option of Yesif you clicked theEncryptbutton for the Client Certificate Store Password.
Client Certificate Alias
A particular key within the default key store can be used for client authentication by indicating the key alias. The specified key will be used when required by the GHTTPS server. Browse for the client key store on the file system by clicking the button next to the field.
Client Certificate Store Type
Indicates if the type of the key store isJKS(Java Keystore) orPKCS12(Public Key Cryptology Standard). If this field is left blank, then the default store type of JKS will be used.
GoAnywhere Directors Resource
A GoAnywhere Director resource is another installation ofGoAnywhere Directorthat you can remotely call Projects on. When defining a GoAnywhere Director resource, you need to indicate the connection properties such as the host name (or IP address), user and password. If connecting via a secure HTTPS connection, then you can optionally specify the SSL certificates to use for authentication.
Basic Tab
Name
A user-defined name which identifies theGoAnywhere Directorserver. This name should be descriptive enough so users can quickly identify this server when prompted to choose from a list. The name cannot exceed 50 characters.
Description
A short paragraph that describes theGoAnywhere Directorserver. The description is optional.
Host
The host name or IP address of theGoAnywhere Directorserver.
Port
The port number to use for connecting to theGoAnywhere Directorserver. If this field is left blank, then the default port number for HTTP connection types is 8000 and 8001 for HTTPS connection types.
User
The user name (login name) to use for connecting to theGoAnywhere Directorserver.
Password
The password to use for connecting to theGoAnywhere Directorserver. After entering the password, you can optionally click theEncryptbutton, which will encrypt the password when it is stored inGoAnywhere Director's database.
If you do not wish to store the password for theGoAnywhere Directorserver resource, the password can be supplied when executing a Project.
Is Password Encrypted
Indicates whether or not the password is encrypted. You should choose the option of Yesif you clicked theEncrypt button for the Password.
Connection Tab
Connection Type
Indicates if the type of the connection is non-secureHTTPor secureHTTPS. If this field is left blank, then the default connection type of HTTP will be used.
Base URL
The base (or context) URL of theGoAnywhere Directorremote server. If a value is not specified, then the default of /goanywherewill be used as the base URL.
Connection Timeout
The maximum amount of time, in seconds, to wait when trying to establish a connection to theGoAnywhere Director remote server. A timeout value of 0 (zero) is interpreted as an infinite wait time. If the field is left blank, then the default value of 60 seconds will be used.
Read Timeout
The maximum amount of time, in seconds, to wait for a (read) response from theGoAnywhere Directorremote server. A timeout value of 0 (zero) is interpreted as an infinite wait time. If the field is left blank, then the default infinite value of 0 (zero) will be used.
Proxy Tab
These options are only needed if your system uses a proxy server to make HTTP(S) connections.
Host
The host name (or IP address) of the proxy server on your network. This is only needed if your system uses a proxy server to make HTTP(S) connections.
Port
Is Password Encrypted
Indicates whether or not the password is encrypted. You should choose the option of Yesif you clicked theEncrypt button for the Proxy Password.
SSL Tab
Implicit Trust
Indicates whether or not to trust theGoAnywhere Directorserver regardless of whether or not a valid server certificate is specified. If this field is left blank, then the default value ofNowill be used.
Verify Host Name
Indicates whether or not the host name of theGoAnywhere Directorserver should be verified against the server certificate. If this field is left blank, then the default value ofYeswill be used.
Server Certificate Key Store Tab
The settings on the Server Certificate Key Store tab are only required when theGoAnywhere Directorserver requires that HTTPS connections are authenticated with a certificate.
Key Store File
The location of the key store (which contains the trusted server certificates) for authenticating theGoAnywhere Directorserver. You can browse for the key store on the file system by clicking the button next to the field. If a key store is not specified, then theGoAnywhere Directorserver will be treated as a trusted server. Certificates are managed onGoAnywhere Director'sSSL Certificate Managerscreen.
A default key store is provided inGoAnywhere Directorfor holding trusted server certificates. The location of this key store is[installdirectory]/userdata/keys/x509/trustedCertificates.jkswhere
[installdirectory] is the installation directory of theGoAnywhere Directorproduct.
Password
The password to use for accessing the trusted Server Certificate Store. After entering the password, you can optionally click theEncryptbutton, which will encrypt the password when it is stored inGoAnywhere Director's database.
If you do not wish to store the password with theGoAnywhere Directorserver resource, this password can be supplied when executing a Project.
Is Password Encrypted
Indicates whether or not the password for the Server Certificate Store is encrypted. You should choose the option of Yesif you clicked theEncryptbutton for the Server Certificate Store Password.
Type
Indicates if the type of the key store isJKS(Java Keystore) orPKCS12(Public Key Cryptology Standard). If this field is left blank, then the default store type of JKS will be used.
Client Certificate Key Store Tab
The settings on the Client Certificate Key Store tab are only required when a client requires that HTTPS connections are authenticated with a certificate.
Key Store File
The location of the key store containing the client certificates and private keys. This is required only when the GoAnywhere Directorserver requires that HTTPS clients are authenticated with a certificate. You can browse for the client key store on the file system by clicking the button next to the field. Certificates can be managed in
GoAnywhere Director'sSSL Certificate Managerscreen.
A default key store is provided inGoAnywhere Directorfor holding client certificates and private keys. The location of this key store is[installdirectory]/userdata/keys/x509/privateKeys.jkswhere [installdirectory] is the installation directory of theGoAnywhere Directorproduct.
Password
The password to use for accessing the Client Certificate Store. After entering the password, you can optionally click theEncryptbutton, which will encrypt the password when it is stored inGoAnywhere Director'sdatabase.
If you do not wish to store the password with theGoAnywhere Directorserver resource, this password can be supplied when executing a Project.
Is Password Encrypted
Indicates whether or not the password for the Client Certificate Store is encrypted. You should choose the option of Yesif you clicked theEncryptbutton for the Client Certificate Store Password.
Type
Indicates if the type of the key store isJKS(Java Keystore) orPKCS12(Public Key Cryptology Standard). If this field is left blank, then the default store type of JKS will be used.
Projects
Projects are used to describe the work forGoAnywhere Directorto perform. For instance, a Project definition can indicate where to retrieve data from, what processes to perform on the data (for example, convert to Excel, Zip, encrypt) and where to distribute the output.
Project definitions are made up of Modules, Tasks and Elements.
Module
A Module is a logical grouping of one or more Tasks. For instance, a module may be defined with three Tasks to be executed in sequential order. The first Task in the Module may read (parse) data from an XML document. The second Task may insert that data into a database file. The third Task could then call a program to process that data.
Multiple modules can be defined in a Project. A Module can pass control to another Module based on certain conditions. For instance you could have a main Module to perform a series of tasks. If any errors are encountered in the main Module, you could have control passed to another module that sends an error notification to an email address or perform some other Tasks. TheCall Moduletask can execute another Module in a Project to perform a sub-routine of tasks based on specific criteria.
IF Condition
An IF Condition controls if a block of tasks will run if a condition is met. TheIF Conditionis like a Yes/No decision point in a process flow chart.
Loops
Loops are complex components that repeat a set of Tasks on the data or files produced in a Project. For instance, the data in a spreadsheet needs to be read into a database. ALoopcontains the Tasks that will read a row of data, evaluate and process it and then iterate to the next row of data and repeat the Loop.
Task
A Task is a discrete business process to perform. For instance, a Task may write data to an XML document, send an email, import data from an Excel file, or FTP a file. GoAnywhere Directorincludes dozens of differentTasksto choose from when building a Project. There is no logical limit to the number of Tasks that can be defined in a Project.
Element
A Task is made up of one or more Elements, which describes the types of work to perform within the Task. For example, the FTP task has an Element to put a file on a FTP server, an Element to get a file from a FTP server, an Element to rename a file on a FTP server, and so on. As another example, the Send E-Mail task has an Element to indicate the attachments to send.
Example of Modules, Tasks and Elements
Listed below is an example of a Project with two modules. In the first module, named "Main", it performs four different tasks. The first task (SQL) connects to a database and retrieves records from a table. The second task (CSV Write) converts the records into a CSV file. The third task (PGP Encrypt) will encrypt the CSV file. The fourth task (FTP) will send the encrypted CSV file to a FTP server and get back a confirmation file. In the second module, named "Error", it has a single task that sends an email with the job log attached.
Designing Projects
A Project can be createdfrom scratchby choosing the specific Tasks needed OR you can create a Project by using one of the includedGoAnywhere Directortemplates. Using a template is generally the fastest approach for creating a Project, since each template contains a pre-defined group of Tasks for performing commonly used business processes.
To work with Project definitions, click on theProjectsicon on the dashboard. Then drill down through the folders (on the left side of the screen) to view the list of Projects within them.
Options are available to create and managefoldersand Projects from within this screen. If a user does not have read, write or executepermissionfor a Project folder, the folder and theProjectsinside it are not displayed.