Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 3 Next »

Alison Wizard docker image includes an ACME tenant inside.

You must overwrite that definition to include your own company or project tenants.

Wizard can manage serveral tenants, each one of them defining logo, styles, certificate filter and validation. A detailled description of validation can be found into the Debbie module.


Debbie

Debbie is module used to validate certificates and signatures.

Wizard Configuration


Environment Variables

Configure the following variables to customize your wizard instance.


KeyDescriptionValue example
ENABLED_TENANTSList of enabled tenants separated by a comma.acme, looney
WIZARD_SECRET_KEY_BASE

Internal encryption key. It's a random 128 hexadecimal characters long key.

Create your own key and replace it.

95820b3cea66376d0...95820
BASE_INSTALLERS_PATHURL where Alison Desktop installers for Windows, Mac, and Linux are published. Depending on your configuration, this URL can be internal or external.https://download.yousite.com/installers.

Inside of this directory you have to create a subforder for each product version as it is described below.
DEBBIE_BASE_URLURL  where Debbie service will be listening. Debbie is used to test and validate certificates.https://debbie-site:4443

You don't need to expose this site to internet, just need to be accessed by Alison Wizard.
ENABLED_BROWSERSList of enabled browsers supported by the wizard.ie>=8,chrome,firefox,opera, edge,safari
ENABLED_PLATFORMSList of enabled platforms supported by the wizard.windows, mac, Linux

Volumes

The following volumes can be mounted on the Docker image to overwrite the variables of each defined tenant.

Source (host)Path (container)Description
./wizard/images/opt/jboss/config/imagesBrowser and platform Images 


Multi-Product

Available from version 1.9.x, it is possible do define following variables and folders. This allows to change the name of the product and images.

KeyDescriptionValue example
PRODUCT_NAMEName of the product to be downloaded and installedAlison Desktop
PRODUCT_PACKAGE

Base name of the file to be downloaded.

This name is completed with the version.

Alison-Desktop

Finally, the file name to be downladed will be Alison-Desktop-Installer-vX.Y.Z.exe or Alison-Desktop-Installer-vX.Y.Z.pkg, for example.

PRODUCT_ACTIVEX

Name of the ActiveX used for IExplorer 8.

This value is maintained by backward compatibility, but IExplorer 8 is not supported by Desktop Application.

Alison-ActiveX

.


Tenant Configuration



Each tenant has its own configuration, and every Alison Wizard docker instance can manage one or several tenants. 

The configuration file allows defining all the behavior of the Wizard for each tenant. It is easy to make changes in the operation of the application. It requires to reload the Alison Wizard container image to apply any change made on these files.

The following files define tenant configuration and must be customized or replaces.

FileDescriptionDefault Value
alison-config.json

This is the main configuration file. It defines keystores, providers, filters, and plugins.

It also defines minimal and suggested Alison-Desktop version.


background_world_map.png
background_world_map_ie.png

Background images. It can be replaced.
custom.cssCSS style of main buttons, banner, and color. You can modify this .css file in order to reflect the font type or colors defined by your organizationACME colors
clientLogo.jpgLogo image.ACME logo
alison-license-desktop.json

This file includes a license for the enabled domains.
This file must be replaced by a definitive license file, that can extend new domains and expiration date.

1-year validity license
alison-authtoken-desktop.jsonDefines the authentication token used by Alison-Desktop to manage the session.


Create a new Tenant

The best way to create a new tenant is to download Lonnie example tenant configuration, or copy ACME included tenant distributed on the last version of Docker Image, modify its name and apply changes on each related file.


Extend enabled tenants

After copying and configuring the new Tenant, the new name must be included in the ENABLED_TENANTS variable and restart the container.


Principal variables that you can modify to custom your tenant:



License


License

Alison Wizard comes preinstalled with a universal license valid for up to 1 year.

To obtain a full license, contact CertiSur team (support@certisur.com) and inform the domain list (from all environments: development, staging, production) where the container will be published.

CertiSur will return a definitive license covering all the domains informed with a 3 years validity.

The license file must be included in each tenant configuration folder.


Plugins

These optional components may be installed on some browsers (Firefox, Chrome, Internet Explorer) to allow a different communication between the browser and Alison Desktop.

Plugins must be enabled by domain, similar to license.

Internet Explorer 11

In the particular case of Internet Explorer, you will download an ActiveX component, that will require administrator privileges to be installed.


  • No labels