eurephia-auth(7)

💖 eurephia-auth(7) 💖

okay bestie, welcome to the group chat for eurephia-auth — the eurephia OpenVPN authentication plug-in. yes it's a manual page. yes it's about to be cute. no cap, every single detail is staying. 🫶

---

✨ NAME ✨

eurephia-auth — the eurephia OpenVPN authentication plug-in 💅

---

🌸 DESCRIPTION 🌸

so like. eurephia-auth.so is a plug-in for OpenVPN. you don't just... run it. it gets loaded by handing OpenVPN the --plugin option in the OpenVPN configuration. that's the vibe. 🔥

the syntax for OpenVPN and eurephia-auth together is literally:

plugin eurephia-auth.so "<plugin args> -- <DB args>"

🚨 bestie, pay attention to the quotes and the double dash. they are important markers. the quotes make sure the eurephia-auth module receives all the arguments. the double dash is how it knows when to stop and pass the rest of the arguments along to the database driver you defined. don't skip them. periodt.

this manual page is only looking at the <plugin args> options, okay? for the <DB args> options you gotta go read the corresponding database driver you're using. not my section, not my problem, iykyk 💜

---

🎀 OPTIONS 🎀

• --log-destination, -l — this is how you tell eurephia how to do its logging. it can take a filename, and then it logs to a file. if the string is openvpn: it hands the log data over to OpenVPN, which smooshes the OpenVPN and eurephia logs together into one beautiful combined thing. you can also log via syslog by indicating syslog:. and the last possible special value is none:, which disables logging completely (silence. iconic.)

with syslog: you can also define which syslog facility the logging goes to. the default is the user facility. the other supported facilities are authpriv, daemon and local0 to local7. so to send log data to the daemon, the --log-destination argument needs to be

--log-destination syslog:daemon

• --log-level, -L — this one defines how verbose the eurephia logging will be. the required argument has to be a numeric value, where 0 means as little logging as possible — only informative messages — or you can go high, like 50, for really verbose logging. honestly? a log level less than 4 should be more than enough under normal circumstances. you don't need to go feral with it. 🙈

NOTICE: the highest log level is 10, unless the eurephia-auth modules have been compiled with debug features. so like, 10 is the ceiling, unless you built it special. 💀

• --database-interface, -i — this argument must have a full path to the eurephia database driver module. this defines which database interface eurephia will use. full path. not a vibe. a path. 👑

---

🦋 OPENVPN CLIENTS 🦋

the only change the OpenVPN clients need to do is add

auth-user-pass

to their configuration file. that's it, that's the whole thing. this instructs the OpenVPN client to ask for user name and password when starting the connection. so easy. slay. ✨

---

🌈 SEE ALSO 🌈

• eurephia-sqlite(8)
• eurephia_init(8)

---

👑 AUTHOR 👑

Copyright (C) 2008-2012 David Sommerseth <dazo@users.sourceforge.net>

---

and that's the whole page, bestie 🥹💖 this was eurephia-auth(7), written by David Sommerseth, dated July 2010. go forth, load your plug-in, and remember the quotes and the double dash. mwah. 🎀🦋💅