Versions Compared
| Version | Old Version 17 | New Version 18 |
|---|---|---|
| Changes made by | ||
| Saved on |
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Service configuration
The following section explains the different parameters needed to configure a Debbie service deployment.
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
Server section
The server object defines the properties necessary to run the embedded Web server. By default the debbie.json file provided is setup to run the Web server on the following URL: "http://localhost:8080/".
| Field | Required | Description | Default/Example |
|---|---|---|---|
| license | yes | License key provided by CertiSur. | 20180814032223:dW5pdm.............RA== |
| ip | yes | Web server IP address | 127.0.0.1 |
| port | yes | Web server port number. | 8080 |
| protocol | yes | Web server protocol. | HTTP |
| minThreadPool | yes | The minimum number of Web server threads. | 10 |
| maxThreadPool | yes | The maximum number of Web server threads. | 30 |
| timeout | yes | Internal Web server timeout. | 5000 |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"server": {
"license": "20180814032223:dW5pdmVyc2FsPVo.............RA==",
"ip": "127.0.0.1",
"port": 8080,
"protocol": "http",
"minThreadPool": 10,
"maxThreadPool": 30,
"timeout": 5000
}
} |
For those environments where an SSL proxy/balancer is not available, an SSL certificate can be configured using the ssl object key in the server object definition. For more details of this feature check the user manual.
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"server": {
...
"ssl": {
"keyStoreFile": "ssl/keystore",
"keyStorePassword": "OBF:1vny1zlp2x9e6vmw1vn61x8g1zau2vn4",
"keyManagerPassword": "OBF:1u3u4wmn4z5s1z7a5wnl1u2g"
},
...
}
} |
If you use a proxy server to download the CRLs or obtain OCSP responses, the proxy object key must be added in the server object definition.
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"server": {
...
"proxy": {
"server": "proxy.internal.local",
"port": 3128
},
...
}
} |
Related Product
Alison SDK js
Alison SDK allows a developer to integrate Alison Desktop in its pages in an easier way. Go to the Alison SDK documentation.
Alison Desktop
You can obtain the current version of Alison Desktop from ACME Alison Wizard site.
For developers, go to the Alison Desktop documentation.
Debbie section
The debbie object defines the properties necessary to run the validation service.
| Field | Required | Description | Default |
|---|---|---|---|
| cacheDir | yes | The path where offline CRL files are stored when a download script is used. | cache/ |
| policyDir | yes | The path where the validation policies are stored. | policies/ |
documentRepositoryDir | no | The path where uploaded documents are stored. | /tmp |
| urlMaxRedirects | yes | The number of URL redirects supported to access CRL distribution points and OCSP responders. | 1 |
| crlConnectionTimeout | yes | CRL distribution point connection timeout. (msec) | 2000 |
| crlReadTimeout | yes | CRL distribution point read timeout. (msec) | 5000 |
| ocspConnectionTimeout | yes | OCSP responder connection timeout. (msec) | 2000 |
| ocspReadTimeout | yes | OCSP responder read timeout. (msec) | 5000 |
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"debbie": {
"cacheDir": "cache/",
"policyDir": "policies/",
"documentRepositoryDir": "/app/repository",
"urlMaxRedirects": 1,
"crlConnectionTimeout": 2000,
"crlReadTimeout": 5000,
"ocspConnectionTimeout": 2000,
"ocspReadTimeout": 5000
}
} |
Sample configuration
Following is the content of the "debbie.json" demo configuration file included in with the validation service distribution.
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"server": {
"license": "20191024050858:dW5pdmVyc2FsPVo.............RA==",
"ip": "127.0.0.1",
"port": 8080,
"protocol": "http",
"minThreadPool": 10,
"maxThreadPool": 30,
"timeout": 5000
},
"debbie": {
"cacheDir": "cache/",
"policyDir": "policies/",
"documentRepositoryDir": "/app/repository",
"urlMaxRedirects": 1,
"crlConnectionTimeout": 2000,
"crlReadTimeout": 5000,
"ocspConnectionTimeout": 2000,
"ocspReadTimeout": 5000
}
} |
According to this configuration, the validation service is available at "http://localhost:8080". The policy configuration files can be found in "config/policies/".