Changes

From SME Server
Jump to navigationJump to search
2,249 bytes added ,  06:52, 10 March 2023
New version of smeserver-virtualbox and smeserver-phpvirtualbox which added in multiple authentication types
Line 40: Line 40:  
  yum install smeserver-extrarepositories-epel smeserver-extrarepositories-virtualbox
 
  yum install smeserver-extrarepositories-epel smeserver-extrarepositories-virtualbox
 
  yum --enablerepo=smedev,smecontribs,epel,virtualbox  install smeserver-phpvirtualbox
 
  yum --enablerepo=smedev,smecontribs,epel,virtualbox  install smeserver-phpvirtualbox
+
The install will prompt you to accept the VirtualBox GPG key
 
</tab><tab name="4.3 For SME 8 and 9">
 
</tab><tab name="4.3 For SME 8 and 9">
 
You need to install the [[VirtualBox_Repository]], the [[stephdl|Stephdl_repository]] And the [[Epel|Epel Repository]]
 
You need to install the [[VirtualBox_Repository]], the [[stephdl|Stephdl_repository]] And the [[Epel|Epel Repository]]
Line 98: Line 98:  
Go to the phpvirtualbox panel at the url https://your-sme-ip/phpvirtualbox on your local-network. '''You can not reach this contrib trought internet'''.
 
Go to the phpvirtualbox panel at the url https://your-sme-ip/phpvirtualbox on your local-network. '''You can not reach this contrib trought internet'''.
   −
{{Note box|Authentication is not currently working.
+
=== Authentication ===
Any device on the local network will have access.}}
+
{{Note box|Authentication is partially working.
 +
 
 +
- BuiltIn, will use the phpvirtualbox builtin authentication which lets you manage users within phpvirtualbox ONLY. It does not have any interface/interaction with smeserver users
 +
 
 +
- LDAP, will allow any smeserver user access, with whoever is defined in the phpvirtualbox adminUser config item as the administrator (default is admin)
 +
 
 +
- WebAuth, will allow any user defined in the phpvirtualbox Users config item, or belonging to groups defined in the phpvirtualbox userGroups config items access (Note: using group access will generate lots of errors in the /var/loh/httpd/error.log file ATM). Admin access is defined by the phpvirtualbox adminUser config item
 +
 
 +
- AD, is defined, but has not been tested}}
    
Your credentials are the user admin of the SME Server and its password but you can add more users by the [[Phpvirtualbox#DB_Configuration|DB Configuration]].
 
Your credentials are the user admin of the SME Server and its password but you can add more users by the [[Phpvirtualbox#DB_Configuration|DB Configuration]].
{{Tip box|You can see [[VirtualBox_4.0_on_SME_Server_v8_beta_6|the Tutorial]] hosted on our Wiki in order to learn :   
+
 
 +
to add individual users<syntaxhighlight lang="bash">
 +
config setprop phpvirtualbox Users <list of comma separated users>
 +
</syntaxhighlight>to add groups<syntaxhighlight lang="bash">
 +
config setprop phpvirtualbox userGroups <list of comma separated smeserver groups>
 +
</syntaxhighlight>then you'll need to activate via:<syntaxhighlight lang="bash">
 +
signal-event smeserver-phpvirtualbox-update
 +
</syntaxhighlight>{{Tip box|You can see [[VirtualBox_4.0_on_SME_Server_v8_beta_6|the Tutorial]] hosted on our Wiki in order to learn :   
 
*how to create [[VirtualBox_4.0_on_SME_Server_v8_beta_6#Creating_a_Virtual_Machinecreate| your first VM]]
 
*how to create [[VirtualBox_4.0_on_SME_Server_v8_beta_6#Creating_a_Virtual_Machinecreate| your first VM]]
 
*how to automatically [[VirtualBox_4.0_on_SME_Server_v8_beta_6#Automatically_Start_Virtual_Machine|start VM with the server]] }}
 
*how to automatically [[VirtualBox_4.0_on_SME_Server_v8_beta_6#Automatically_Start_Virtual_Machine|start VM with the server]] }}
Line 139: Line 154:  
===Installation of Extension Pack===
 
===Installation of Extension Pack===
   −
Support for USB 2.0 devices, VirtualBox RDP and PXE boot for Intel cards. See this chapter [https://www.virtualbox.org/manual/ch01.html#intro-installing from the User Manual] for an introduction to this Extension Pack. See this page to [https://www.virtualbox.org/wiki/Downloads download the extension pack] if the url below is no longer good.
+
The Extension Pack is now automatically installed with VirtualBox.
 +
 
 +
You can trigger a recheck and possible install. This will also check the installed driver and recompile if required (e.g. after a kernel upgrade).<syntaxhighlight lang="bash">
 +
signal-event smeserver-virtualbox-update
 +
</syntaxhighlight>Support for USB 2.0 devices, VirtualBox RDP and PXE boot for Intel cards. See this chapter [https://www.virtualbox.org/manual/ch01.html#intro-installing from the User Manual] for an introduction to this Extension Pack. See this page to [https://www.virtualbox.org/wiki/Downloads download the extension pack] if the url below is no longer good.
    
For example :
 
For example :
Line 220: Line 239:     
====Authentication====
 
====Authentication====
{{Note box|Authentication is not currently working.
+
{{Note box|Authentication is still being worked on, but mostly works as advertised.}}
Any device on your local network will have access.}}
   
you can allow authentication to phpvirtualbox via number of methods. This feature is the default behaviour since the bug opened is solved http://sourceforge.net/p/phpvirtualbox/bugs/7/.
 
you can allow authentication to phpvirtualbox via number of methods. This feature is the default behaviour since the bug opened is solved http://sourceforge.net/p/phpvirtualbox/bugs/7/.
   −
  config setprop phpvirtualbox webauth enabled
+
  config setprop phpvirtualbox authtype WebAuth
  signal-event console-save
+
  signal-event smeserver-phpvirtualbox-update
 
+
{| class="wikitable"
and you have to modify manually the file config.php
+
|+authtype
 +
!
 +
!
 +
|-
 +
|BuiltIn
 +
|will use the phpvirtualbox builtin authentication which lets you manage users within phpvirtualbox ONLY. It does '''NOT''' have any interface/interaction with smeserver users
 +
|-
 +
|LDAP
 +
|will allow any smeserver user access, with whomever is defined in the phpvirtualbox adminUser config item as the administrator (default is admin)
 +
|-
 +
|WebAuth
 +
|will allow any user defined in the phpvirtualbox Users config item, or belonging to groups defined in the phpvirtualbox userGroups config items access
 +
Admin access is defined by the phpvirtualbox adminUser config item
   −
nano /opt/phpvirtualbox/config.php
+
('''''Note:''''' using group access will generate lots of errors in the /var/log/httpd/error.log file ATM).
 +
|-
 +
|AD
 +
|is defined, but has not been tested.
 +
will allow any user defined in the phpvirtualbox Users config item, or belonging to AD groups defined in the phpvirtualbox userGroups config items access.  
   −
// Authentication library.
+
Admin access is defined by the phpvirtualbox adminUser config item
var $authLib = 'Builtin';
+
|-
#var $authLib = 'WebAuth';
+
|none
#var $authConfig = array('adminUser' => 'admin');
+
|everyone on your local network has access, without needing to log in
 
+
|}
to
  −
  −
// Authentication library.
  −
#var $authLib = 'Builtin';
  −
var $authLib = 'WebAuth';
  −
var $authConfig = array('adminUser' => 'admin');
      +
=====Allow Specific Users=====
 +
Works with WebAuth and AD
   −
=====Allow Specific Users=====
   
The users must be declared  and a password must be set in the server-manager.
 
The users must be declared  and a password must be set in the server-manager.
   −
  config setprop phpvirtualbox User user1,user2,user3
+
  config setprop phpvirtualbox Users user1,user2,user3
  signal-event console-save
+
  signal-event smeserver-phpvirtualbox-update
    
=====Allow Specific Groups=====
 
=====Allow Specific Groups=====
 +
Works with WebAuth and AD
 +
 
These groups must be declared in the server-manager and users need to be included
 
These groups must be declared in the server-manager and users need to be included
   −
  config setprop phpvirtualbox Group Group1,Group2,Group3
+
  config setprop phpvirtualbox userGroups Group1,Group2,Group3
  signal-event console-save
+
  signal-event smeserver-phpvirtualbox-update
    
=== Access The Web Interface Remotely ===
 
=== Access The Web Interface Remotely ===
371

edits

Navigation menu