Type Definitions
req
The req object represents the HTTP request and has properties for the request query string, parameters, body, HTTP headers, and so on.
- Object
Name | Type | Attributes | Description |
---|---|---|---|
params | Object | HTTP request parameter. | |
body | Object | <optional> | HTTP POST request body. |
header | Object | HTTP request header. |
- Source
res
The res object represents the HTTP response that an [Express] app sends when it gets an HTTP request.
- Object
- Source
roles
- Object
Name | Type | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
roles | Object | roles configuration object Properties
|
- Source
template
A template is an object property of the workspace.templates
- Object
Name | Type | Description |
---|---|---|
_type | Object | The _type property distinguish the origin of a template. 'core' templates are added from the /mod/workspace/templates directory. A 'custom' is added from a custom_template JSON file defined in the xyzEnv. A 'workspace' is added from the workspace itself. A _type='template' object is assigned in the assignWorkspaceTemplates method. |
src | String | The source is a location from which a template object is loaded when required. Once loaded the template will be cached. |
cached | Object | The cached template. |
template | String | The string representation of a template, eg. html, sql. |
render | function | A method which resolves in a template string. |
module | Boolean | The template is a module. |
workspace
The workspace object defines the mapp resources available in an XYZ instance.
- Object
Name | Type | Attributes | Description |
---|---|---|---|
roles | Object | <optional> | Each property of the roles object is a role which can be assigned to a user. |
dbs | string | <optional> | The fallback dbs connection if not implicit in [query] template. |
locale | Object | The default locale which serves as a templates for all locales in workspace. | |
locales | Object | Each property in the locales object is a locale available from this workspace. |
xyzEnv
The process.ENV object holds configuration provided to the node process from the launch environment. The environment configuration allows the provision of keys and secrets which must not be accessible from the client. All xyzEnv properties are limited to string type.
- Object
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
DIR | String | <optional> | '' | The XYZ API path which concatenated with the domain for all requests. |
DBS_ | String | <optional> | '' | DBS_* values are the connections used to establish connections to pg servers with the dbs module. |
PORT | String | <optional> | '3000' | The port on which the express app listens to for requests. |
COOKIE_TTL | Integer | <optional> | 36000 | The Time To Live for all cookies issued by the XYZ API. |
TITLE | String | <optional> | 'GEOLYTIX | XYZ' | The TITLE value is used to identify cookies and is provided to as a param to Application View templates. |
LOGS | String | <optional> | The LOGS string will split on comma to determine which requests send to the LOGGER module will be logged. | |
LOGGER | String | <optional> | Required to configure the LOGGER module for a remote out. | |
RATE_LIMIT | String | <optional> | 1000 | Maximum requests per window in the express module |
RATE_LIMIT_WINDOW | String | <optional> | 60000 | Time window in ms in the express module |
PRIVATE | String | <optional> | All requests to XYZ API require authentication. The PRIVATE value represents the ACL connection. | |
PUBLIC | String | <optional> | General requests to XYZ API do require authentication. The PUBLIC value represents an ACL connection for optional authentication. | |
SECRET | String | <optional> | A secret string is required to sign and validate JWT. | |
USER_SESSION | String | <optional> | The auth module will store and check a session key if the USER_SESSION xyzEnv is not undefined. | |
AUTH_EXPIRY | String | <optional> | The user/fromACL module can expiry user authorization if the AUTH_EXPIRY xyzEnv is configured. | |
FAILED_ATTEMPTS | String | <optional> | '3' | The user/fromACL module will expire user validation if failed login attempts exceed the FAILED_ATTEMPTS value. |
PASSWORD_REGEXP | String | <optional> | '(?=.*?[A-Z])(?=.*?[a-z])(?=.*?[0-9])^.{10,}$' | The user/register module will apply PASSWORD_REGEXP value to check the complexity of provided user passwords. |
STATEMENT_TIMEOUT | String | <optional> | The utils/dbs module will apply the STATEMENT_TIMEOUT to the query.client. | |
RETRY_LIMIT | String | <optional> | '3' | The utils/dbs module will apply the RETRY_LIMIT to the query.client. |
WORKSPACE_AGE | String | <optional> | The workspace/cache module flashes the workspace cache after the WORKSPACE_AGE is reached. | |
CUSTOM_TEMPLATES | String | <optional> | The workspace/cache module caches templates defined as a src in the CUSTOM_TEMPLATES xyzEnv. | |
TRANSPORT | String | <optional> | The utils/mailer module requires a TRANSPORT xyzEnv. | |
TRANSPORT_HOST | String | <optional> | The hostname or IP address that the utils/mailer module module connects to. | |
TRANSPORT_NAME | String | <optional> | The optional hostname of the client, used for identifying to the server in the utils/mailer module module. | |
TRANSPORT_EMAIL | String | <optional> | The email used to send emails in the utils/mailer module module. | |
TRANSPORT_USERNAME | String | <optional> | The username used to authenticate in the utils/mailer module module. | |
TRANSPORT_PASSWORD | String | <optional> | The password used to authenticate in the utils/mailer module module. | |
TRANSPORT_PORT | String | <optional> | The port used to connect to the host in the utils/mailer module module. | |
TRANSPORT_TLS | String | <optional> | defines additional node.js TLSSocket options to be passed to the socket constructor used in the utils/mailer module module. | |
USER_DOMAINS | String | <optional> | The user/register module will limit the registration to user emails for domains provided in the comma seperated USER_DOMAINS xyzEnv. | |
SRC_ | String | <optional> | SRC_* values will replace the key wildcard [*] in the stringified workspace. | |
KEY_CLOUDFRONT | String | <optional> | A key [*.pem] file matching the KEY_CLOUDFRONT value is required for authentication requests in the cloudfront provider module. | |
AWS_S3_CLIENT | String | <optional> | A AWS_S3_CLIENT xyzEnv is required to sign requests with the s3 signer module. | |
CLOUDINARY_URL | String | <optional> | A CLOUDINARY_URL xyzEnv is required to sign requests with the cloudinary signer module. | |
SAML_ACS | String | <optional> | Assertion Consumer Service URL where SAML responses are received | |
SAML_SSO | String | <optional> | Single Sign-On URL of the Identity Provider | |
SAML_SLO | String | <optional> | Single Logout URL for terminating sessions | |
SAML_ENTITY_ID | String | <optional> | Service Provider Entity ID (your application identifier) | |
SAML_IDP_CRT | String | <optional> | Path to IdP certificate file for validation | |
SAML_SP_CRT | String | <optional> | Base name for SP certificate pair files | |
SAML_WANT_ASSERTIONS_SIGNED | String | <optional> | Require signed assertions (true/false) | |
SAML_AUTHN_RESPONSE_SIGNED | String | <optional> | Require signed responses (true/false) | |
SAML_SIGNATURE_ALGORITHM | String | <optional> | Algorithm for signing (e.g., 'sha256') | |
SAML_IDENTIFIER_FORMAT | String | <optional> | Format for name identifiers | |
SAML_ACCEPTED_CLOCK_SKEW | String | <optional> | Allowed time difference in ms | |
SAML_PROVIDER_NAME | String | <optional> | Display name for your service | |
SLO_CALLBACK | String | <optional> | URL for handling logout callbacks |
- Source