HTTP(S)

The HTTP(S) integration uses an HTTP or HTTPS endpoint as a Kloset store backend. It is used to connect to a Kloset store exposed by plakar server.

The integration includes one connector:

Requirements

• Plakar v1.1.0 or later.
• An HTTP or HTTPS endpoint serving a Kloset store, for example one exposed by plakar server.

Installation

The integration is pre-installed in Plakar v1.1.0 or later and requires no additional setup.

Configuration

The store connector uses the http:// or https:// protocol. The location can be given directly on the command line with either prefix, or registered as a store alias.

When the endpoint requires a bearer token, for example a plakar server started with -token, configure the store as an alias so the token is stored with it. The token is then sent in the Authorization header on every request.

Plakar refuses to open the store when credentials could be read in transit. Credentials are the auth_token and a username and password in the location, such as https://user:pass@example.com/data. The channel is insecure over plaintext HTTP, or over HTTPS with tls_no_verify=true. Set insecure=true to send credentials over such a channel anyway.

Redirects are followed only when they keep the scheme and host of the location. A redirect between HTTP and HTTPS is always refused. Set allow_cross_host_redirects=true to follow redirects to a different host.

Store configuration

Example

Initialize a store at an HTTP endpoint, back up a local directory to it, and list its snapshots:

# Initialize a Kloset store at the HTTP endpoint
$ plakar at http://example.com/data create

# Back up a local directory to the store
$ plakar at http://example.com/data backup /var/www

# List snapshots in the store
$ plakar at http://example.com/data ls

Register an endpoint that requires a bearer token:

# Register the endpoint along with its token
$ plakar store add remote https://example.com/data auth_token=<token>

# Use the alias, the token is sent on every request
$ plakar at @remote ls

See also

• Creating a Kloset Store
• Serving a Kloset Store over the Network