Skip to content

Latest commit

 

History

History
123 lines (79 loc) · 3.39 KB

DEPLOY_FEDORA.md

File metadata and controls

123 lines (79 loc) · 3.39 KB

Deploying on Fedora

For simple one server deployments and tests, we have a deploy script available you can run on a fresh Fedora 28 installation. It will configure all components and will be ready for use after running!

Additional scripts are available after deployment:

  • Use Let's Encrypt for automatic web server certificate management;

Requirements

  • Clean Fedora 28 installation with all updates installed;
  • SELinux MUST be enabled;
  • Network equipment/VM platform allows access to the very least tcp/80, tcp/443, udp/1194 and tcp/1194 for basic functionality, the deploy script will take care of the host firewall;
  • Working DNS entry for your VPN server, e.g. vpn.example.org.

We test only with the official Fedora Cloud Base Images.

If you have a more complicated setup, we recommend to manually walk through the deploy script and follow the steps.

Base Deploy

Perform these steps on the host where you want to deploy:

$ curl -L -O https://github.com/eduvpn/documentation/archive/master.tar.gz
$ tar -xzf master.tar.gz
$ cd documentation-master

Run the script (as root):

$ sudo -s
# ./deploy_fedora.sh

Specify the hostname you want to use for your VPN server. Both the "Web" and "OpenVPN" DNS names can be identical for simple 1 machine setups.

NOTE: you can NOT use localhost as a hostname, nor an IP address!

Update

Periodically install updates!

Configuration

VPN

See PROFILE_CONFIG on how to update the VPN server settings.

Authentication

Username & Password

By default there is a user me with a generated password for the User Portal and a user admin with a generated password for the Admin Portal. Those are printed at the end of the deploy script.

If you want to update/add users you can use the vpn-user-portal-add-user and vpn-admin-portal-add-user scripts. Provide an existing account to update the password:

$ sudo vpn-user-portal-add-user
User ID: foo
Setting password for user "foo"
Password: 
Password (repeat):

LDAP

It is easy to enable LDAP authentication. This is documented separately. See LDAP.

RADIUS

It is easy to enable RADIUS authentication. This is documented separately. See RADIUS.

SAML

It is easy to enable SAML authentication for identity federations, this is documented separately. See SAML.

2FA

For connecting to the VPN service by default only certificates are used, no additional user name/password authentication. It is possible to enable 2FA to require an additional TOTP or YubiKey.

ACLs

If you want to restrict the use of the VPN a bit more than on whether someone has an account or not, e.g. to limit certain profiles to certain (groups of) users, see ACL.

Optional

Let's Encrypt

Run the script (as root):

$ sudo -s
# ./lets_encrypt_centos.sh

Make sure you use the exact same DNS name you used when running deploy_fedora.sh!

After completing the script, the certificate will be installed and the system will automatically replace the certificate before it expires.

Let's Connect! Branding

See BRANDING.

Port Sharing

If you also want to allow clients to connect with the VPN over tcp/443, see Port Sharing.