Environment variables
#Environment variables ##Environment variables
ANALYTICS_BATCH_INTERVAL
ANALYTICS_BATCH_INTERVALAnalytics batch interval
How long to wait before sending batched analytics events to Google Analytics if batch size has not been exceeded.
Milliseconds (integer)
False
Default value:
Example value:
ANALYTICS_BATCH_SIZE
ANALYTICS_BATCH_SIZEAnalytics batch size
How many analytics events to batch before sending data to Google Analytics. Max 20.
Integer
False
Default value:
Example value:
AWS_USE_EMPTY_CREDENTIALS
AWS_USE_EMPTY_CREDENTIALSUse empty AWS credentials
Set to true to use empty credentials for AWS. Only set if you use AWS mocks that do not require credentials.
Boolean
False
Example value:
CORS_ALLOWED_ADDITIONAL_HEADERS
CORS_ALLOWED_ADDITIONAL_HEADERSCORS allowed additional headers
Any extra headers (other than Accept,Authorization,Content-Type,If-None-Match) used by the service that should be allowed when CORS in IMSG is activated.
Comma separated values (string)
False
Default value:
Example value:
CORS_ALLOWED_ORIGINS
CORS_ALLOWED_ORIGINSCORS allowed origins
Origins that should be allowed by Access-Control-Allow-Origin. This will override the service's CORS configuration
Comma separated values (string)
False
Default value:
Example value:
CORS_ALLOW_ANY_HEADERS
CORS_ALLOW_ANY_HEADERSCORS allow any headers
Allow any headers in CORS. This will reflect the value of access-control-request-headers into the response access-control-allow-headers. Use with care.
Boolean
False
Example value:
ECS_CONTAINER_METADATA_FILE
ECS_CONTAINER_METADATA_FILEDo not set manually. Filepath to the ECS container metadata file. Set automatically by ECS if ECS_ENABLE_CONTAINER_METADATA is set.
String
False
Example value:
ENABLE_API_DOCUMENTATION
ENABLE_API_DOCUMENTATIONSet to true to enable Swagger API documentation
Boolean
False
Example value:
FIREHOSE_ACCESS_KEY
FIREHOSE_ACCESS_KEYIAM user access key
The access key for the IAM user connected to the specific Firehose stream.
String
False
Example value:
FIREHOSE_AWS_REGION
FIREHOSE_AWS_REGIONAWS region
The aws region where the Firehose is install at
String
False
Example value:
FIREHOSE_HOST_PATH
FIREHOSE_HOST_PATHFirehose host path
The host path to where the Firehose is installed. Mostly used in testing
String
False
Example value:
FIREHOSE_SECRET_KEY
FIREHOSE_SECRET_KEYIAM user secret key
The secret key for the IAM user connected to the specific Firehose stream.
String
False
Example value:
FIREHOSE_STREAM_NAME
FIREHOSE_STREAM_NAMEFirehose stream name
The chosen name of the Firehose Delivery stream to send data to.
String
False
Example value:
GRACE_PERIOD_TTL
GRACE_PERIOD_TTLState API grace period
How long to stay in grace once connection to the state API is lost. Defaults to 60 minutes.
Milliseconds (integer)
False
Default value:
Example value:
IMAS_URL
IMAS_URLIMAS URL
URL to IMAS
String
True
Example value:
IMID_COOKIE_DOMAINS
IMID_COOKIE_DOMAINSIMID cookie domains
Domains to restrict the IMID cookies to. Usually infomaker.io
Comma separated values (string)
False
IMID_COOKIE_DOMAIN, IMID_TOKEN_COOKIE_DOMAIN
Default value:
Example value:
IMID_COOKIE_PREFIX
IMID_COOKIE_PREFIXIMID cookie prefix
Prefix to apply to IMID token cookie. Defaults to none.
Ex. if set to "dev", the cookie name will be "dev_imidToken"
In production this should always be unset.
String
False
Example value:
IMID_COOKIE_SAME_SITE
IMID_COOKIE_SAME_SITEIMID cookie SameSite
Sets the SameSite directive on the IMID token cookie. Defaults to Lax. If set to 'none', the SameSite` directive will not be set.
In production this should always be unset or set to lax`
Enum (string) [Strict, Lax, false]
False
Default value:
Example value:
IMID_COOKIE_SECURE
IMID_COOKIE_SECUREIMID cookie Secure
If the Secure flag should be set on the IMID token cookie. Defaults to true.
In production this should always be unset or set to true
Boolean
False
Default value:
Example value:
IM_LOG_LEVEL
IM_LOG_LEVELLog level
Log level used by Bunyan. See Bunyan docs - Levels for details
Enum (string) [trace, debug, info, warn, error, fatal]
False
Default value:
Example value:
IM_LOG_NAME
IM_LOG_NAMELog name
Log name used by Bunyan. See Bunyan docs - Introduction for details
String
False
SERVICE_NAME
Default value:
Example value:
INCLUDE_GROUPS_IN_SERVICE_TOKEN
INCLUDE_GROUPS_IN_SERVICE_TOKENWill perserve the groups claim from IMID token in the Service Token
Boolean
False
Example value:
INCLUDE_IMID_TOKEN_IN_REQUEST
INCLUDE_IMID_TOKEN_IN_REQUESTInclude IMID token in request
If enabled, authenticated requests to the service will contain the IMID token in the x-imid-token header. Note: Always make sure this header is never exposed. Only enable if access to the IMID token is necessary.
Boolean
False
Example value:
INTERNAL_SERVICE_URL
INTERNAL_SERVICE_URLInternal service URL
URL where the service protected by IMSG can be reached
String
True
Example value:
LEGACY_MODE_ONLY_INCLUDE_UNITS_WITH_EXPLICITLY_MAPPED_PERMISSIONS_IN_SERVICE_TOKEN
LEGACY_MODE_ONLY_INCLUDE_UNITS_WITH_EXPLICITLY_MAPPED_PERMISSIONS_IN_SERVICE_TOKENShould only be set for legacy services not yet updated. If set, units without explicit permissions will not be included in the service token and org permissions for those units are ignored.
Boolean
False
Example value:
ONLY_ACCEPT_ID_TOKENS
ONLY_ACCEPT_ID_TOKENSOnly accept ID tokens
If enabled, only ID tokens will be accepted as valid tokens. Access tokens will be rejected with an invalid token type error.
Boolean
False
Example value:
PORT
PORTHTTP port
Port to run the HTTP server on
Integer
True
Example value:
REFRESH_BACKOFF_TIMEOUT
REFRESH_BACKOFF_TIMEOUTModify refresh backoff timeout
Do not modify unless for tests. Changes the default backoff time when refresh fails with other than 403 error.
Milliseconds (integer)
False
Default value:
Example value:
SERVICE_ADMIN_INFOMAKER_GROUPS
SERVICE_ADMIN_INFOMAKER_GROUPSService admin Infomaker groups
Infomaker groups which should make subscribers service admininstrator for this service.
Comma separated values (string)
False
Default value:
Example value:
SERVICE_MAINTAINER
SERVICE_MAINTAINERService maintainer
Email or name used to identify who is responsible for the service.
String
False
Default value:
Example value:
SERVICE_NAME
SERVICE_NAMEService name
Name of the service protected by IMSG
String
False
Default value:
Example value:
SERVICE_TOKEN_SIGN_SECRET
SERVICE_TOKEN_SIGN_SECRETService token secret
Shared secret between IMSG and the service protected by IMSG
String
True
Example value:
STATE_API_READ_SECRET
STATE_API_READ_SECRETInternal API secret
Secret used to access state API.
String
True
Example value:
STATE_API_STARTUP_TIMEOUT
STATE_API_STARTUP_TIMEOUTState API grace period
How long to wait for startup before timing out.
Milliseconds (integer)
True
Example value:
STATE_API_URL
STATE_API_URLAWS region
URL to state API.
String
True
Example value:
TELEMETRY_API_URL
TELEMETRY_API_URLTelemetry API URL
URL to telemetry API
String
False
Example value:
Last updated