Add plivo gateway.

docs/configuration.rst

@@ -84,6 +84,7 @@ setting. Then, you may want to configure the following settings:
 
   * ``'two_factor.gateways.twilio.gateway.Twilio'`` for sending real text messages using
     Twilio_.
+  * ``'two_factor.gateways.plivo.gateway.Plivo'`` for sending SMS using Plivo_.
   * ``'two_factor.gateways.fake.Fake'``  for development, recording tokens to the
     default logger.
 
@@ -146,6 +147,26 @@ Additionally, you need to enable the ``ThreadLocals`` middleware:
 
 .. autoclass:: two_factor.gateways.twilio.gateway.Twilio
 
+Plivo Gateway
+--------------
+To use the Plivo you need to get the Auth ID and Auth Token from the Plivo console.
+You need to buy a source number from Plivo too, which is used by the gateway too.
+To use Plivo as a authentication service you need to setup a PHLO for Two-Factor
+authentication.
+The dependency needed is the plivo module.
+
+.. code-block:: console
+
+    pip install plivo
+
+Sample configuration in settings could look like this:
+
+.. code-block:: python
+
+    PLIVO_AUTH_ID = 'NANWFHZJDKYJG2YNNNN2'
+    PLIVO_AUTH_TOKEN = 'ZGYwMTVkMGE5NGiiiWFmHGHmYmNhOWY3NTRhYzQ4'
+    PLIVO_SOURCE_NUMBER = '+1 206-426-9999'
+
 Fake Gateway
 ------------
 .. autoclass:: two_factor.gateways.fake.Fake

requirements_dev.txt

@@ -4,6 +4,7 @@
 
 # Additional runtime dependencies
 
+plivo
 twilio
 phonenumberslite
 

two_factor/gateways/plivo/gateway.py

@@ -0,0 +1,32 @@
+import plivo
+from django.conf import settings
+from django.template.loader import render_to_string
+
+
+class Plivo:
+    """
+    Gateway for sending text messages using Plivo.
+    """
+
+    def __init__(self):
+        self.client = plivo.RestClient(
+            auth_id=getattr(settings, 'PLIVO_AUTH_ID'),
+            auth_token=getattr(settings, 'PLIVO_AUTH_TOKEN')
+        )
+        self.source_number = getattr(settings, 'PLIVO_SOURCE_NUMBER')
+
+    def make_call(self, device, token):
+        raise NotImplementedError
+
+    def send_sms(self, device, token):
+        text = render_to_string(
+            'two_factor/plivo/sms_message.html',
+            {'token': token}
+        )
+        send_kwargs = {
+            'src': self.source_number,
+            'dst': device.number.as_e164,
+            'text': text,
+        }
+
+        self.client.messages.create(**send_kwargs)

two_factor/templates/two_factor/plivo/sms_message.html

@@ -0,0 +1,5 @@
+{% load i18n %}
+{% blocktrans trimmed %}
+    Your OTP token is {{ token }}
+{% endblocktrans %}
+