Using Token authentication

This page is for users that want to use token authentication on Death By Captcha API.

Token authentication FAQ

Why use token authentication?

Token-based authentication allows users to maintain username and password even more secure.

Why are tokens better than passwords?

Traditional passwords have one huge weakness: they’re human-generated. Human-made passwords tend to be pretty weak and easy to crack. We’ve all reused old passwords again and again because they’re easy to remember.

Where can I get my token for authentication?

You can get it from users panel, to use token authentication, you need to enable 2FA authentication.

Refer to 2FA help in order to activate 2FA: Learn how to enable 2FA authentication

After that you can get your token from the User panel

get token

Can I use token authentication and username/password authentication at the same time?

No, you can enable/disable token authentication at any time in user panel, but you cannot use both at the same time. If token authentication is disabled you should use username/password authentication, if token authentication is enabled you should use token authentication.

Where can I enable/disable token authentication?

In user panel there is an option to enable/disable token authentication.

enable/disable token

What should I do next?

When using token authentication on DeathByCaptcha API you need to change your clients to use authtoken instead of username/password.

Refers to each clients code in order to use token based authentication on each case

Client examples

require_once 'deathbycaptcha.php';

// Put your DBC credentials here.
// Use DeathByCaptcha_HttpClient class if you want to use HTTP API.
// To use token username must be authtoken.
$client = new DeathByCaptcha_SocketClient("authtoken", token-from-panel);

// Put the CAPTCHA file name or handler, and desired timeout (in seconds) here:
if ($captcha = $client->decode(CAPTCHA_FILE_NAME, TIMEOUT)) {
    echo $captcha['text'] . "\n";

    // Report the CAPTCHA if solved incorrectly.
    // Make sure the CAPTCHA was in fact incorrectly solved!
    if ( ... ) {
        $client->report($captcha['captcha']);
    }
}

// Repeat for other CAPTCHAs

// Do not forget to reference DeathByCaptcha.dll in your project!
using DeathByCaptcha;

// Put your DBC credentials here.
// Use HttpClient class if you want to use HTTP API.
// Using token authentication in C#/VB, username must be authtoken.

Client client = (Client) new SocketClient("authtoken", token-from-panel);

// Put your CAPTCHA file name, stream, or vector of bytes,
// and desired timeout (in seconds) here:
Captcha captcha = client.Decode(CAPTCHA_FILE_NAME, TIMEOUT);
if (captcha.Solved && captcha.Correct) {
    Console.WriteLine("CAPTCHA {0}: {1}", captcha.Id, captcha.Text);

    // Report the CAPTCHA if solved incorrectly.
    // Make sure the CAPTCHA was in fact incorrectly solved!
    if ( ... ) {
        client.Report(captcha);
    }
}

// Repeat for other CAPTCHAs

// Do not forget to reference DeathByCaptcha.dll in your project!
  Imports DeathByCaptcha
        ' Dim clnt As New HttpClient("autoken", token-from-panel)
        Dim clnt As New SocketClient("authtoken", token-from-panel)
        Console.WriteLine(String.Format(
                            "Your balance is {0,2:f} US cents", clnt.Balance))
        ' Uploading captchas with type = 2 (Coordinates API)
        ' Dim ext_data As New Hashtable()
        ' ext_data.Add("type", 2)
        ' Put your CAPTCHA image file name, file object, stream, or vector
        ' of bytes, and optional solving timeout (in seconds) here:
        ' Dim cptch As Captcha = clnt.Decode(
                    CAPTCHA_FILE_NAME, 2 * Client.DefaultTimeout, ext_data)
        ' Uploading captchas with type = 3 (Image Group API)
        ' Dim ext_data As New Hashtable()
        ' ext_data.Add("type", 3)
        ' ext_data.Add("banner_text", "Select all images with meat")
        ' ext_data.Add("grid", "4x4") ' this is optional
        ' ext_data.Add("banner", bannerFileName)
        ' Put your CAPTCHA image file name, file object, stream, or vector
        ' of bytes, and optional solving timeout (in seconds) here:
        ' Dim cptch As Captcha = clnt.Decode(
                        CAPTCHA_FILE_NAME, 2 * Client.DefaultTimeout, ext_data)
        ' Put your CAPTCHA image file name, file object, stream, or vector
        ' of bytes, and optional solving timeout (in seconds) here:
        Dim cptch As Captcha = clnt.Decode(
                            CAPTCHA_FILE_NAME, 2 * Client.DefaultTimeout)
        If cptch IsNot Nothing Then
            Console.WriteLine(String.Format(
                            "CAPTCHA {0:d} solved: {1}", cptch.Id, cptch.Text))
            ' Report an incorrectly solved CAPTCHA.
            ' Make sure the CAPTCHA was in fact incorrectly solved, do not
            ' just report it at random, or you might be banned as abuser.
            'If clnt.Report(cptch) Then
            '    Console.WriteLine("Reported as incorrectly solved")
            'Else
            '    Console.WriteLine("Failed reporting as incorrectly solved")
            'End If
        End If
  ' Repeat for other CAPTCHAs

  
      import deathbycaptcha
      import json
      # Put your DBC account username and password here.
      username = "username"
      password = "password"
      # you can use authtoken instead of user/password combination
      # activate and get the authtoken from DBC users panel
      authtoken = "authtoken-from-panel"
      # Put the proxy and reCaptcha token data
      Captcha_dict = {
          'proxy': 'http://user:password@127.0.0.1:1234',
          'proxytype': 'HTTP',
          'googlekey': '6Lc2fhwTAAAAAGatXTzFYfvlQMI2T7B6ji8UVV_f',
          'pageurl': 'http://google.com'}
      # Create a json string
      json_Captcha = json.dumps(Captcha_dict)
      client = deathbycaptcha.SocketClient(username, password, authtoken)
      # to use http client = deathbycaptcha.HttpClient(username, password)
      # client = deathbycaptcha.HttpClient(username, password, authtoken)
      try:
          balance = client.get_balance()
          print(balance)
          # Put your CAPTCHA type and Json payload here:
          captcha = client.decode(type=4, token_params=json_Captcha)
          if captcha:
              # The CAPTCHA was solved; captcha["captcha"] item holds its
              # numeric ID, and captcha["text"] item its list of "coordinates".
              print ("CAPTCHA %s solved: %s" % (captcha["captcha"],
                                                 captcha["text"]))
              if '':  # check if the CAPTCHA was incorrectly solved
                  client.report(captcha["captcha"])
      except deathbycaptcha.AccessDeniedException:
          # Access to DBC API denied, check your credentials and/or balance
          print ("error: Access to DBC API denied," +
                 "check your credentials and/or balance")
  # Repeat for other CAPTCHAs

  
      import deathbycaptcha
      import json
      # Put your DBC account username and password here.
      username = "username"
      password = "password"
      # you can use authtoken instead of user/password combination
      # activate and get the authtoken from DBC users panel
      authtoken = "authtoken-from-panel"
      # Put the proxy and reCaptcha token data
      captcha_dict = {
          'proxy': 'http://user:password@127.0.0.1:1234',
          'proxytype': 'HTTP',
          'googlekey': '6Lc2fhwTAAAAAGatXTzFYfvlQMI2T7B6ji8UVV_b',
          'pageurl': 'http://google.com'}
      # Create a json string
      json_captcha = json.dumps(captcha_dict)
      # to use socket client
      client = deathbycaptcha.SocketClient(username, password, authtoken)
      # to use http client
      # client = deathbycaptcha.HttpClient(username, password, authtoken)
      try:
          balance = client.get_balance()
          print(balance)
          # Put your CAPTCHA type and Json payload here:
          captcha = client.decode(type=4, token_params=json_captcha)
          if captcha:
                  # The CAPTCHA was solved; captcha["captcha"] item holds 
                  # its numeric ID, and captcha["text"] item its 
                  # list of "coordinates".
              print "CAPTCHA %s solved: %s" % (captcha["captcha"],
                                                captcha["text"])
              if '':  # check if the CAPTCHA was incorrectly solved
                  client.report(captcha["captcha"])
      except deathbycaptcha.AccessDeniedException:
          # Access to DBC API denied, check your credentials and/or balance
          print "error: Access to DBC API denied, check your credentials" +
                            "and/or balance"
  # Repeat for other CAPTCHAs

  
    const dbc = require('./deathbycaptcha.js');

    const username = 'username';     // DBC account username
    const password = 'password';     // DBC account password
    // if using username/password, authtoken must be an empty string
    // authentication token can be enabled in user panel
    const authtoken = 'token-from-panel'; //DBC account authtoken

    // Proxy and Recaptcha token data
    const token_params = JSON.stringify({
      'proxy': 'http://username:password@proxy.example:3128',
      'proxytype': 'HTTP',
      'googlekey': '6Lc2fhwTAAAAAGatXTzFYfvlQMI2T7B6ji8UVV_f',
      'pageurl': 'http://google.com'
    });

    // Death By Captcha Socket Client
    // const client = new dbc.SocketClient(username, password, authtoken);
    // Death By Captcha http Client
    const client = new dbc.HttpClient(username, password, authtoken);

    // Get user balance
    client.get_balance((balance) => {
      console.log(balance);
    });

    // Solve captcha with type 4 & token_params extra arguments
    client.decode({extra: {type: 4, token_params: token_params}},
        (captcha) => {

      if (captcha) {
        console.log('Captcha ' + captcha['captcha'] + ' solved: ' +
                                captcha['text']);
        // Report an incorrectly solved CAPTCHA.
        // Make sure the CAPTCHA was in fact incorrectly solved!
        // client.report(captcha['captcha'], (result) => {
        //   console.log('Report status: ' + result);
        // });
      }

    });
  // Repeat for other CAPTCHAs

  
    import com.DeathByCaptcha.AccessDeniedException;
    import com.DeathByCaptcha.Client;
    import com.DeathByCaptcha.HttpClient;
    import com.DeathByCaptcha.SocketClient;
    import com.DeathByCaptcha.Captcha;
    import java.io.IOException;

    class ExampleSimple
    {
        public static void main(String[] args)
            throws Exception
        {
            // Put your DBC username & password || authtoken here:
            // if the number of arguments is two we are using authtoken
            // if the number of arguments is three we are using 
            // username/password combination
            System.out.println(args.length);
            Client client;
            // using http API
            /*
            if(args.length == 3){
                client = (Client)(new HttpClient(args[0], args[1]));
            }else if(args.length == 2){
                client = (Client)(new HttpClient(args[0]));
            }else{
                System.out.println("Wrong number of arguments");
                System.out.println("You must use username/password combination");
                System.out.println("Or API key");
                return;
            }
            */
            // using sockets API
            if(args.length == 3){
                client = (Client)(new SocketClient(args[0], args[1]));
            }else if(args.length == 2){
                client = (Client)(new SocketClient(args[0]));
            }else{
                System.out.println("Wrong number of arguments");
                System.out.println("You must use username/password combination");
                System.out.println("Or API key");
                return;
            }
            client.isVerbose = true;

            try {
                try {
                    System.out.println("Your balance is " + client.getBalance()
                                                    + " US cents");
                } catch (IOException e) {
                    System.out.println("Failed fetching balance: " + e.toString());
                    return;
                }
                Captcha captcha = null;
                try {
                    // Upload a CAPTCHA and poll for its status with 120 seconds 
                    // timeout. Put you CAPTCHA image file name, file object, 
                    // input stream, or vector of bytes, and optional 
                    // solving timeout (in seconds) here.
                    if (args.length == 3){
                        captcha = client.decode(args[2], 120);
                    }else if (args.length == 2){
                        captcha = client.decode(args[1], 120);
                    }else{
                        System.out.println("Failed uploading CAPTCHA - args");
                        return;
                    }
                } catch (IOException e) {
                    System.out.println("Failed uploading CAPTCHA");
                    return;
                }
                if (null != captcha) {
                    System.out.println("CAPTCHA " + captcha.id + " solved: "
                                                           + captcha.text);

                    // Report incorrectly solved CAPTCHA if necessary.
                    // Make sure you've checked if the CAPTCHA was in fact 
                    // incorrectly solved, or else you might get banned as abuser.
                    /*try {
                        if (client.report(captcha)) {
                            System.out.println("Reported as incorrectly solved");
                        } else {
                            System.out.println(
                                      "Failed reporting incorrectly solved CAPTCHA");
                        }
                    } catch (IOException e) {
                        System.out.println(
                                "Failed reporting incorrectly solved CAPTCHA: "
                                        + e.toString());
                    }*/
                } else {
                    System.out.println("Failed solving CAPTCHA");
                }
            } catch (com.DeathByCaptcha.Exception e) {
                System.out.println(e);
            }
        }
    }

  // Repeat for other CAPTCHAs

  
      #!/usr/bin/env perl

      use strict;
      use warnings;
      use lib '.';
      use DeathByCaptcha::HttpClient;
      use DeathByCaptcha::SocketClient;


      my ($username, $password, $filename) = @ARGV;

      # Put your DeathByCaptcha username & password here:
      # if using authtoken authentication username must be "authtoken"
      # and $password must be the authtoken from user panel
      # using authtoken in user panel disables username/password authentication
      my $client = DeathByCaptcha::HttpClient->new($username, $password);
      # my $client = DeathByCaptcha::SocketClient->new($username, $password);

      printf("Your balance is %f US cents\n", $client->getBalance());

      if ($filename) {
        printf("Provided captcha: $filename \n");
        # Put your CAPTCHA image file name and desired solving timeout 
      # (in seconds) here:
        my $captcha = $client->decode($filename,
                                      +DeathByCaptcha::Client::DEFAULT_TIMEOUT);
        if (defined $captcha) {
            print "CAPTCHA " . $captcha->{"captcha"} .
                  " solved: " . $captcha->{"text"} . "\n";

            # Report if the CAPTCHA was solved incorrectly.
            # Make sure it was in fact solved incorrect, do not just report every
            # CAPTCHA, or you'll get banned as abuser.
            # $client->report($captcha->{"captcha"});
        }
      } else {
        printf("No captcha provided \n");
      }
  // Repeat for other CAPTCHAs

Using Token authentication

Token authentication FAQ

Client examples

Updates

Support

Live Support

About Us

Contact

Death By Captcha