1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
#ifndef HYBBX_AUTH_H
#define HYBBX_AUTH_H
#include "hybbx/password.h"
#include <stddef.h>
#include <stdint.h>
#ifdef __cplusplus
extern "C" {
#endif
#define HYBBX_AUTH_GUEST_PREFIX_MAX 32
/** Default guest name prefix: Guest1, Guest2, … */
#define HYBBX_AUTH_DEFAULT_GUEST_PREFIX "Guest"
/** Highest guest number issued (Guest1 … Guest25); max simultaneous guests. */
#define HYBBX_GUEST_NUMBER_MAX 25u
/**
* Synthetic user IDs for ephemeral guest sessions (not stored in user files).
* Slot @p n is 1 … @ref HYBBX_GUEST_NUMBER_MAX.
*/
#define HYBBX_GUEST_USER_ID(n) (0xffffffffffffff00ULL + (uint64_t)(n))
#define HYBBX_USERNAME_MIN_LEN 4u
#define HYBBX_USERNAME_MAX_LEN 12u
#define HYBBX_USERNAME_MAX_DIGITS 4u
/** Default Sysop account (auto-created when no Sysop exists in the user database). */
#define HYBBX_DEFAULT_SYSOP_USERNAME "Sysop"
#define HYBBX_SYSOP_INIT_PASSWORD_MIN 10u
#define HYBBX_SYSOP_INIT_PASSWORD_MAX 14u
/** Plain-text password length policy for new passwords (/changeme, future set-password). */
#define HYBBX_PASSWORD_MIN_LEN 8u
#define HYBBX_PASSWORD_MAX_LEN 24u
/**
* User privilege levels (highest to lowest).
* Sysop: exactly one account on the system.
*/
typedef enum hybbx_user_level {
HYBBX_LEVEL_SYSOP = 1,
HYBBX_LEVEL_ADMIN = 2,
HYBBX_LEVEL_MOD = 3,
HYBBX_LEVEL_USER = 4,
HYBBX_LEVEL_GUEST = 5
} hybbx_user_level_t;
typedef struct hybbx_auth_config {
int auto_login;
char guest_prefix[HYBBX_AUTH_GUEST_PREFIX_MAX];
} hybbx_auth_config_t;
void hybbx_auth_config_defaults(hybbx_auth_config_t *auth);
const char *hybbx_user_level_name(hybbx_user_level_t level);
hybbx_user_level_t hybbx_user_level_parse(const char *name);
int hybbx_user_level_is_guest(hybbx_user_level_t level);
/** Non-zero when @p level is Sysop or Admin. */
int hybbx_user_level_is_sysop_or_admin(hybbx_user_level_t level);
/** Non-zero when @p level is the protected Sysop account tier. */
int hybbx_user_level_is_sysop(hybbx_user_level_t level);
/** Non-zero when @p password meets the plain-text password policy (8–24 characters). */
int hybbx_password_plain_valid(const char *password);
/**
* Return non-zero when @p username is valid for registration:
* 4–12 characters, letters (a–z), digits (max 4), and at most one `_` or one `-`
* (not both); case-insensitive.
*/
int hybbx_username_valid(const char *username, const char *guest_prefix);
/** Fold @p username to lowercase in place (for case-insensitive lookup). */
void hybbx_username_normalize(char *username);
/** Presentation form for output (e.g. Sysop instead of stored sysop). */
const char *hybbx_username_display(const char *username,
hybbx_user_level_t level);
struct hybbx_user_record;
/** User-facing display name (nickname when set, else username). */
const char *hybbx_user_display_name(const struct hybbx_user_record *user);
/**
* Derive a default nickname from a legacy stored username when none is set.
*/
void hybbx_nickname_infer(const char *stored_username,
char *nickname,
size_t nickname_len);
/**
* Parse @p username as @c <guest_prefix><1-25> (case-insensitive prefix).
* Writes slot to @p slot_out. Returns 1 on match, else 0.
*/
int hybbx_guest_slot_from_username(const char *guest_prefix,
const char *username,
unsigned *slot_out);
struct hybbx_user_record;
/** Fill @p out with an ephemeral guest record for @p slot (1 … 25). */
void hybbx_guest_fill_record(const char *guest_prefix,
unsigned slot,
struct hybbx_user_record *out);
#ifdef __cplusplus
}
#endif
#endif /* HYBBX_AUTH_H */
|
