Basic with Redis

Basic authentication with Redis

This filter is superseded by the HTML form auth filter, which offers a nicer login experience and supports sign-out. It is the recommended way to authenticate users backed by Redis. This page is kept for reference and existing deployments.

Basic authentication is a simple protocol that uses HTTP headers and the browser to authenticate users. User credentials are sent to the server in the Authorization header with user:password base64-encoded:

Authorization: Basic dXNlcjpwYXNzd29yZA==

Credentials are sent in plain text (base64 is not encryption). Always run Datashare behind TLS when using this filter.

See Provisioning users for how to hash passwords, structure user records, and store them in Redis.

Login experience

When accessing Datashare, the browser prompts with its native basic-auth popup:

basic auth popup

There is no sign-out: users remain logged in until the browser is closed.

Example

Launching Datashare with Docker and the basic-auth filter backed by Redis:

docker run -ti ICIJ/datashare app start --mode SERVER \
    --batchQueueType REDIS \
    --dataSourceUrl 'jdbc:postgresql://postgres/datashare?user=<username>&password=<password>' \
    --sessionStoreType REDIS \
    --auth basic \
    --authUsersProvider redis