How to create a driver

It is very simple to create a custom driver for Two Factor in order to send messages using your own service or one that is not bundled in the core drivers. All you have to do is to use a plugin in October (a new one or existing one). In this plugin you have to create a class that will take care of sending the actual message. This class has to implement the \TwoFactor\Interfaces\SenderInterface interface that has two methods:

• getDriver() - this is here you make a new instance of the dependency you use for your driver. For example, if you use a driver to send the message in Slack, here you make a new instance of new SlackBot and then you send it.
• send($to, $message) - this is the function that sends the message. As you can see, this function has two parameters: $to - this is the number where you would send an SMS and message that includes the message that was set in the plugin settings.

After the sender class is ready and implemented with those two message, you can go on and register the sender class into the plugin. To do this, in your plugin.php you should make (if you don't have it already) the register() function and in this function listen to an event called filipac.twofactor.drivers. In this event you would return a single array with two keys: class that is the full class name of the driver you created and name - the name of the driver. Below is an example of a working register function:

public function register()
    {
        \Event::listen('filipac.twofactor.drivers', function () {
            return [ 'class' => 'Demo\Driver\DemoSender', 'name' => 'Slack Gateway' ];
        });
    }

Also, make sure that the plugin you made (or already had) requires the main plugin in order to avoid errors:

protected $requires = [ 'filipac/TwoFactor' ];

This is the minimal configuration you have to make in order to have a custom driver.

Adding settings and validation rules

For a driver you might want to add custom configuration fields and form rules in the Settings page. In order to do this, you should listen to another event in the register function, like so:

\Event::listen('filipac.twofactor.fields', function () {
            return static::class;
        });

After you listened to this event, you can go further and implement another function called fields. This function should return an array with fields to include in the form. This configuration is detailed in the October documentation - here.

public static function fields() {
        $arr                 = [ ];
        $arr['slack_sid']      = [
            'label' => 'SID',
            'tab'   => 'Slack',
            'span'  => 'auto'
        ];
        return $arr;
    }

Now your fields will appear in the settings page of the Two Factor plugin, in the tab you specified. You can add custom validation rules and messages by adding another function called validation. Quick demonstration:

public static function validation() {
        return [
            'rules' => ['slack_sid' => 'required_if:driver,'.DemoSender::class],
            'messages' => ['slack_sid.required_if' => 'Required if msg']
        ];
    }

The code above adds a rule for the field slack_sid that says that this field is required if the driver field is set to DemoSender class. In the messages array, you include the custom messages for the rules you want. Read more about validation service on the October documentation.

You can find a fully-working plugin made for demonstration that posts the message on Slack on Github filipac/demo-driver