API Credentials for Selenium WebDriver

Guide to obtaining tokens, keys, and connections.

For Botize to communicate with your Selenium installation you need four MySQL database credentials: “Database Host,” “Database User,” “Database Password,” and “Database Name.” Below you’ll find every step —installation included— to obtain each value.

Database Host

  1. 1

    Download the SeleniumBotize software by running git clone https://github.com/Botize/SeleniumBotize.git or, if you prefer, download the ZIP from https://github.com/Botize/SeleniumBotize/archive/master.zip and extract it.

  2. 2

    Go into the newly created folder (SeleniumBotize).

  3. 3

    Download the Chrome Driver that matches your Chrome version from https://sites.google.com/a/chromium.org/chromedriver/downloads. Unzip it and copy the chromedriver file into the SeleniumBotize folder.

  4. 4

    Create a virtual environment with virtualenv -p python3 SeleniumBotize. If you don’t have virtualenv yet, install it first with pip install virtualenv.

  5. 5

    Activate the environment with . SeleniumBotize/bin/activate (notice how the prompt changes).

  6. 6

    Install the dependencies: pip install selenium and then pip install pymysql.

  7. 7

    Run the installer: python install.py.

  8. 8

    When the installer shows “Enter Database Host:” type the MySQL server name. If the database is on your own computer, enter localhost; if it’s on another server, type its IP or domain.

  9. 9

    The value you just entered is your “Database Host.” Copy it exactly as-is into Botize’s connection form.

Database User

  1. 1

    After entering the host, the installer asks “Enter Database User:”. Type the username that has rights on the database (for example selenium).

  2. 2

    If you don’t have that user yet, create it in MySQL with something like CREATE USER 'selenium'@'%' IDENTIFIED BY 'Apassword'; and grant it rights with GRANT ALL ON selenium_botize.* TO 'selenium'@'%';.

  3. 3

    The name you typed in the installer is your “Database User.” Keep it handy for Botize.

Database Password

  1. 1

    Next the installer shows “Enter Database Password:”. Type the password of the user you just specified.

  2. 2

    If you created the user with CREATE USER, enter the same password you set in that command.

  3. 3

    That password is your “Database Password.” Store it safely; you’ll use it in Botize.

Database Name

  1. 1

    The installer finishes by asking “Name (default 'selenium_botize'):”. Press Enter to accept the default selenium_botize or type another name you prefer.

  2. 2

    If you choose a different name, make sure to create that database first in MySQL with CREATE DATABASE your_name;.

  3. 3

    The name you confirm here is your “Database Name,” and that’s what you’ll need to enter in Botize.