Configuration

The Configuration menu option provides a tabbed interface to many standard configuration elements, stored on the server primarily in uf101d.ini, with some email-specific elements in the prog/mailcall.ini file and deliver.ini.  These are described in the Configuration chapter of the manual.  Note you can also manually edit either of these files on the server.

Some items require that the UnForm server be restarted to take effect.  These items have an asterisk (*) prefix.

When changes are complete, click Save.  The server will make a backup of uf101d.ini (as uf101d.ini.bak), and save the new information.

Main

•Primary Server - the port the server listens on for client connections

•HTTPD - the port the private Apache HTTP server listens on, for browser and REST connections

•SSL options for both the Primary and HTTPD servers.

•Certificate, chain, and private key paths used when SSL is configured for either server.  If not configured, a self-signed certificate is used.  Note the unform server/service user must have read access to these files.

•Directories - a list of directories searched for rule files and supporting files when print jobs run

•Purging - days the specified types of files and records are left on disk before automatically purged

•Rebuild - if checked, when the server is started it will attempt clean up of control files to eliminate many types of corruption

•CR Behavior - default handling of CR characters in text stream print job input

•Mail Server - default SMTP or SMTPS mail server

•Default From Address - default From address when emails are sent

•Default Login: SMTP authentication login

•Default Password: SMTP authentication password

Security

•Allowed IP's - IP addresses or wildcards that are allowed to connect to the server's main port

•Rule File Encryption - if checked, the design tool will save/publish rule files in encrypted format.  The UnForm server can use such rule files like any other, and the design tool can view/edit them, but a standard text editor cannot

Logs

•Log Directory - the location on the UnForm server for log files

•Purge Age - the number of days server and http log files are retained

•Server Detail Level - the logging detail level for the server

•Job Detail Level - the logging detail level for print jobs

•Deliver Age - the number of days deliver and Image Manager upload logs are retained

Archiving

•Library Name - default library name used when a library function is used with an empty library name

•Access - when a process creates a new library, these are the default security options applied

•Auto Sequence - when a process creates a new library, this auto-sequence setting is applied.  Auto-sequencing forces all duplicate images (sub ID's) to add a unique sequence value, preventing overwriting of any documents in that library.

•Session Lifespan - the number of hours browser sessions last.  If 0, sessions terminate when the browser is closed by the user.

•Self-Manage - allow users to change their own passwords, and also to get an email of a forgotten password.

•Suppress @text - If checked, new browser sessions will by default not display @text images.

•Default Mail From - The default From address for browser interface emails, in cases where the logged in user does not have an email address configured.

•External URL - a URL prefix used when a link is built by the webapi object or the rac object.  This value should point to web server address/port that forwards into the UnForm HTTP server "/arc" path.  This is typically configured by an administrator as a reverse proxy address in an external web server, or as a port forward from the public address of a router.

External Tools

•Support Server - enter the hostname or IP address, and port, of the default Windows Support Server.

•Ghostscript - the full path to the Ghostscript executable, typically "gs" on Linux/Unix, and gswin32.exe or gswin64.exe on Windows.  Use the latest version of GhostScript available.  Note that AFO requires Ghostscript 9.06 or higher.  If this is left blank, and a Windows Support Server is configured, UnForm will attempt to use a GhostScript configured in the Support Server, allowing a Windows version to be installed and used.

•Image Magick - the full path the the Magick "convert" or "convert.exe" program on the UnForm server.  If this is left blank, and a Windows Support Server is configured, UnForm will attempt to use the Windows Support Server for image scaling and conversion.

•GhostPCL - the full path to the GhostPCL executable, if available.  GhostPCL is used by the design tool for previewing PCL test prints on screen.

•Extension Printers - a list of name=settings lines.  The list  is read by the UnForm Web Extension and the SDSI Web Extension, a tool that provides an enhanced PDF viewer in a compatible web browser.  The names are presented in the extension, which can then submit that PDF file as an UnForm AFO job.

TCP Ports

Enter the port configuration for network print capture.  More details on this feature are in the TCP/IP Monitor chapter.

Email Sending with Modern (OAuth2) Authentication

UnForm supports XAUTH2 authentication with a SMTP server, as well as traditional LOGIN authentication.  This requires configuring a dedicated user record with its Notes field filled in with text lines provided by the publisher through a registration procedure at https://unform.com/support/oauthcode.html.  The user record can be disabled to prevent its use other than as a secure storage location for the authentication data.

After registering an application with your mail provider, such as the App Registration pages at Microsoft 365's Azure Active Directory, you can visit the above web page to configure, authorize, and receive the tokens required for UnForm to perform this type of authentication.  Instructions are found at that page.

Once a user has been configured with the proper lines in its Notes field, you can specify which user contains the token information with a specially formatted password: oauth:userid.  For example, if you set up a user "z_smtp", use the password "oauth:z_smtp" in the email configuration for the source.  That format of password triggers the XAUTH2 authentication method.

The notes field should look something like this (lines here are truncated):

cid=2991095c-2b2a-4...

cs=Z2F8Q~5dZSM4v...

ep=https://login.microsoftonline.com/ab44...

tk=LCJhbGciOiJSUzI1NiIsIng1dCI6ImpT...

rf=0.ARIAlplEqxeM...