Developers guide

Chapter 7

Optional components 64

GitHub

To use GitHub, you also need an API code and a secret key. To get one, you need to create an App here:

https://github.com/settings/applications. When you create your App, make sure you input the following

as the Callback URL https://YOUR_PORTAL_HOSTNAME/oauth2/github

Of course, replace the hostname with the values from general.hostname and general.domain.

Once you have your information, Once you have your information, you need to configure the OAuth2

provider. This can be done by adding a GitHub OAuth2 authentication source from Configuration �

Sources.

Moreover, don’t forget to add GitHub as a registration mode from your portal profile definition, available

from Configuration � Portal Profiles and Pages.

Gaming Devices Registration

Users have the possibility to register gaming devices (Microsoft XBOX/XBOX360, Nintendo DS/Wii, Sony

PlayStation and so on) right from a special portal page. When accessing this page, users will be prompted

to login as if they were registering themselves. Once logged in, the portal will ask them to enter the

gaming device MAC address that will then be matched against a predefined list of authorized MAC OUI.

The gaming device will be registered with the user’s id and can be assigned into a specific category for

easier management.

Here’s how to configure the whole thing. The portal page can be accessed by the following URL: https://

YOUR_PORTAL_HOSTNAME/gaming-registration This URL is accessible from within the network, in any VLAN

that can reach the PacketFence server.

The following can be configured by editing the pf.conf file:

[registration]

gaming_devices_registration = enabled

gaming_devices_registration_role = gaming

Make sure the role exists in PacketFence otherwise you will encounter registration errors. Moreover, make

sure the role mapping for your particular equipment is done.

These parameters can also be configured from the Configuration � Registration section.