eurephiadm-usercerts(7) [debian man page]

eurephiadm usercerts(7) 												   eurephiadm usercerts(7)

NAME

       eurephiadm-usercerts
	- Managing user accounts and certificate relations

DESCRIPTION

       For  a  user  to  connect  to a eurephia enabled OpenVPN server, a user account must have been created and activated and an SSL certificate
       available to the user must have been registered.  The user account and certificate the user may use must then be linked together, and  this
       linking the eurephiadm usercert command takes care of.

       It  is also this relation which gives you the option to control which network resources the VPN clients may access, by assigning a firewall
       profile to such user-certificate links.

       Available modes for the usercerts command are:

       -A | --add
	      Register a new certificate and user-cert link

       -D | --delete
	      Delete a certificate and user-cert link

       -S | --set-fwprofile
	      Sets the firewall access profile for a user-cert link

       -l | --list
	      List all registered user-cert links

       -h | --help <mode>
	      Help about a specific mode

       The list mode will list all registered links between user accounts and certificates.

LIST MODE

       The list mode will show all registered user-certificate links

       -S | --sort <sort keys>
	      Define the sorting of the list

	      Valid sort keys are:

	      uid
	       Nummeric User ID

	      certid
	       Nummeric Certificate ID

	      accessprofile
	       Nummeric firewall profile ID

	      registered
	       According to when the user-cert was registered

	      uicid
	       Nummeric user-cert link ID

SET FW PROFILE MODE

       The set-fwprofile mode will update the firewall access profile for a given user-cert link

       Options: (both required)

       -n | --uicid
	      Unique record id of certificate and user account link

       -a | --accessprofile
	      Firewall profile ID

ADD MODE

       The add mode will register a new link between a user account and a certificate.

       -c | --certid
	      Required - Certificate ID

       -i | --uid
	      Required - User account ID

       -a | --accessprofile
	      Firewall profile ID to use for this access

DELETE MODE

       The delete mode will delete a link between a user account and a certificate.

       -c | --certid
	      Certificate ID

       -i | --uid
	      User account ID

       -n | --uicid
	      Unique record id of certificate and user account link

       -a | --accessprofile
	      Firewall profile ID

SEE ALSO

       eurephiadm-users(7), eurephiadm-certs(7), eurephiadm-fwprofiles(7)

AUTHOR

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

David Sommerseth						     July 2010						   eurephiadm usercerts(7)

eurephiadm fwprofiles(7)												  eurephiadm fwprofiles(7)

NAME

       eurephiadm-fwprofiles - Configuring eurephia firewall profiles

SYNOPSIS

       eurephiadm  fwprofiles  --list|-l  [-v|--verbose]  [-a|--accessprofile  <acc.  ID>]  [-f|--fw-destination   <name>]  [-i|--uid	<user ID>]
       [-n|--username  <username>] [-c|--certid  <cert ID>] [-e|--email  <e-mail address>] [-d|--digest  <certificate SHA1 digest>]
       eurephiadm fwprofiles --add|-A [-d|--description <Description>] [-f|--fw-destination  <name>]
       eurephiadm fwprofiles --delete|-D [-a|--accessprofile  <acc. ID>] [-f|--fw-destination  <name>]

DESCRIPTION

       The eurephia plug-in can take advantage of the OS firewall to give a fine grained access control of each OpenVPN client.  The preconfigured
       firewall chains available to eurephia needs to be defined using this eurephiadm command.  When the firewall profiles are defined here, they
       can be assigned to the different user accesses you have enabled.

MODES

       Available modes for the fwprofiles command are:

       -A | --add
	      [-d|--description <Description>] [-f|--fw-destination  <name>]
	      Add a new firewall profile.  Both --description and --fw-destination are required.  The --description is just to give a human  read-
	      able description of the firewall profile name and is only used in the different reports available in eurephiadm.

       -D | --delete
	      [-a|--accessprofile  <acc. ID>] [-f|--fw-destination  <name>]
	      Delete a firewall profile.  Either --accessprofile or --fw-destination must be provided.

       -l | --list
	      [-v|--verbose]  [-a|--accessprofile  <acc.  ID>]	[-f|--fw-destination   <name>]	[-i|--uid   <user ID>] [-n|--username  <username>]
	      [-c|--certid  <cert ID>] [-e|--email  <e-mail address>] [-d|--digest  <certificate SHA1 digest>]
	      List available firewall profiles.  Without any arguments, a simple overview over all registered firewall profiles.  If the --verbose
	      argument is given, the list will be more comprehensive.

	      The  rest of the arguments are filters which is used to reduce the length of the list.  Multiple filters may be added, but they will
	      only work as additional "AND" argument in the query.

       -h | --help
	      <mode> Show a help screen.  Without any arguments, all modes are listed.	Providing a mode will show more information about the cho-
	      sen mode.

FILTERS

       These filters are used by the --list mode.

       -a | --accessprofile <id>
	      Numeric ID defining the access profile ID.

       -f | --fw-destination <name>
	      The firewall reference for the chain used by the OS when filtering the OpenVPN client traffic.

       -i | --uid <user id>
	      Numeric user ID

       -n | --username <username>
	      User name

       -c | --certid <certid>
	      Numeric reference to a certificate

       -e | --email <email addr>
	      e-mail address in certificates

       -d | --digest <SHA1 digest>
	      Certificate SHA1 digest

SEE ALSO

       eurephiadm(7), eurephiadm-usercerts(7)

AUTHOR

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

David Sommerseth						     July 2010						  eurephiadm fwprofiles(7)