authenticate.h

#ifndef AUTHENTICATE_H
#define AUTHENTICATE_H

// LDAPHOST is the address of the LDAP server used for authentication.
// Update this value to match the LDAP server's address.
#define LDAP_HOST "ldap://URL:PORT"

// The sizes of the char arrays used to store configuration values.
# ifndef SIMPLE_CHAR_SIZE
# define SIMPLE_CHAR_SIZE 256
# endif

/**
 * @brief Authenticate a user against the LDAP server.
 *
 * This function uses the `ldapwhoami` command to authenticate a user against the LDAP server.
 * If the server recognizes the user and password, the user is considered authenticated.
 *
 * @param username The username of the user to authenticate.
 * @param interactive Set to 1 to enable interactive input for LDAP password; 0 for non-interactive mode.
 * @param password_stored The password of the user to authenticate. This parameter is only used in non-interactive mode.
 *
 * @return 0 upon successful authentication; 1 in case of authentication failure.
 */
int authenticate_LDAP_user(char* username, int interactive, char password_stored[256]);
#endif