2023-01-09 01:22:54 +01:00
|
|
|
#ifndef AUTH_H
|
|
|
|
|
#define AUTH_H
|
|
|
|
|
|
2023-10-10 23:43:47 +02:00
|
|
|
#include <libweb/http.h>
|
Implement user quota
This feature allows admins to set a specific quota for each user, in
MiB. This feature is particularly useful for shared instances, where
unlimited user storage might be unfeasible or even dangerous for the
server.
Also, a nice HTML5 <progress> element has been added to the site that
shows how much of the quota has been consumed.
If no quota is set, slcl falls back to the default behaviour i.e.,
assume unlimited storage.
Limitations:
- While HTTP does specify a Content-Length, which determines the length
of the whole request, it does not specify how many files are involved
or their individual sizes.
- Because of this, if multiple files are uploaded simultaneously, the
whole request would be dropped if user quota is exceeded, even if not
all files exceeded it.
- Also, Content-Length adds the length of some HTTP boilerplate
(e.g.: boundaries), but slcl must rely on this before accepting the
whole request. In other words, this means some requests might be
rejected by slcl because of the extra bytes caused by such boilerplate.
- When the quota is exceeded, slcl must close the connection so that
the rest of the transfer is cancelled. Unfortunately, this means no
HTML can be sent back to the customer to inform about the situation.
2023-03-06 05:09:56 +01:00
|
|
|
#include <stdbool.h>
|
2023-01-09 01:22:54 +01:00
|
|
|
|
|
|
|
|
struct auth *auth_alloc(const char *dir);
|
|
|
|
|
void auth_free(struct auth *a);
|
|
|
|
|
int auth_cookie(const struct auth *a, const struct http_cookie *c);
|
|
|
|
|
int auth_login(const struct auth *a, const char *user, const char *password,
|
|
|
|
|
char **cookie);
|
|
|
|
|
const char *auth_dir(const struct auth *a);
|
Implement user quota
This feature allows admins to set a specific quota for each user, in
MiB. This feature is particularly useful for shared instances, where
unlimited user storage might be unfeasible or even dangerous for the
server.
Also, a nice HTML5 <progress> element has been added to the site that
shows how much of the quota has been consumed.
If no quota is set, slcl falls back to the default behaviour i.e.,
assume unlimited storage.
Limitations:
- While HTTP does specify a Content-Length, which determines the length
of the whole request, it does not specify how many files are involved
or their individual sizes.
- Because of this, if multiple files are uploaded simultaneously, the
whole request would be dropped if user quota is exceeded, even if not
all files exceeded it.
- Also, Content-Length adds the length of some HTTP boilerplate
(e.g.: boundaries), but slcl must rely on this before accepting the
whole request. In other words, this means some requests might be
rejected by slcl because of the extra bytes caused by such boilerplate.
- When the quota is exceeded, slcl must close the connection so that
the rest of the transfer is cancelled. Unfortunately, this means no
HTML can be sent back to the customer to inform about the situation.
2023-03-06 05:09:56 +01:00
|
|
|
int auth_quota(const struct auth *a, const char *user, bool *available,
|
|
|
|
|
unsigned long long *quota);
|
2023-01-09 01:22:54 +01:00
|
|
|
|
|
|
|
|
#endif /* AUTH_H */
|