Settings

MOMOTOR_BROKER

A dictionary with connection settings for the Momotor broker.

Example:

MOMOTOR_BROKER = {
    'HOST': 'localhost',
    'PORT': 50052,
    'USE_SSL': True,

    'API_KEY': 'momotor-api-key',
    'API_SECRET': 'momotor-api-secret',

    'TOKEN_STORE_CLASS': 'momotor.django.token_store.model.ModelTokenStore',
}

HOST

The dns name or ip address of the Momotor broker.

Default: localhost

PORT

The tcp port the Momotor broker is listening too. If not provided, defaults to 50051 if USE_SSL is False, otherwise 50052

USE_SSL

Indicates whether to use SSL when connecting to the broker. There are three possible values:

  • yes indicates an SSL connection is required. The certificate provided by the broker will be validated.

  • insecure indicates an SSL connection is required, but the certificate will not be validated. Use this when the broker uses a self-signed certificate.

  • no indicates SSL should not be used (not recommended).

API_KEY and API_SECRET

The key and secret to use to authenticate to the broker with.

TOKEN_STORE_CLASS

The token store class to use. See the Token Store section for more information.

Available token stores classes are:

Default: momotor.django.token_store.model.ModelTokenStore

INFO_MAX_AGE

Server info is cached for this time.

Default: 30

TOKEN_DATABASE_NAME

Only used when the TOKEN_STORE_CLASS setting is set to momotor.django.token_store.model.ModelTokenStore.

Name of the database where the model to store the Momotor tokens is created. This refers to the name of the database as defined in the default DATABASES Django setting.

Default: default

TOKEN_CACHE_NAME

Only used when the TOKEN_STORE_CLASS setting is set to momotor.django.token_store.cache.CachedTokenStore.

Name of the cache where tokens are stored. This refers to the name of the cache as defined in the default CACHES Django setting.

Default: default

TOKEN_KEY

Only used when the TOKEN_STORE_CLASS setting is set to momotor.django.token_store.cache.CachedTokenStore.

Cache key for the tokens.

The key is formatted using the MOMOTOR_BROKER dictionary, so any value in the settings dictionary can be used to make the key unique.

Default: momotor-broker-auth-token-{[API_KEY]}