Card Recon 3.0.1

Running the Card Recon CLI

Running the Card Recon CLI executable immediately attempts a scan.

When the Card Recon runs, it looks for these files in its directory:

  • cardrecon.cfg: default Card Recon configuration file.
  • <license-file-name>.li2: Offline License File; Card Recon looks for any file ending with .li2.

If it finds any of these files in the directory that the Card Recon executable occupies, it will try to load them when the Card Recon runs.

The Card Recon CLI automatically loads cardrecon.cfg when run, altering your scan configuration. If your loaded cardrecon.cfg is set up for Card Recon to load a specific journal file, Card Recon loads that journal file when run with cardrecon.cfg.

If you do not want to load these files when you run the Card Recon CLI, use the -c and -journal flags OR remove these files from the directory.

For more information, see Card Recon CLI Options.

Running the Card Recon CLI on Windows

Locate the Windows CLI executable: cr_x.x.x.exe

There are 2 ways to run the Windows CLI.

Method 1

  1. Locate cr_x.x.x.exe in Windows Explorer.
  2. Right-click cr_x.x.x.exe, select Run as administrator and enter the administrator password if prompted.
  3. In the terminal, Card Recon will prompt you to validate your license.
  4. Log in using one of the three methods (see Logging into Card Recon for more information):
    • Ground Labs Login.
    • Use an Online Token.
    • Use Offline License File.

Card Recon will run with default settings – i.e. it scans all local storage with default search parameters (see Selecting Card Data Types for more information).

Method 2

  1. Click Start to open the Start Menu.
  2. Enter cmd to search for cmd.exe, or find it in Start > All Programs > Accessories > Command Prompt.
  3. Right-click cmd.exe or the Command Prompt program and select Run as administrator. Enter the administrator password if prompted.
  4. In the newly-opened Command Prompt window, navigate to the folder where your Card Recon executable is located.

    # If your Card Recon executable is in the Downloads folder cd c:\User\username\Downloads\

  5. To run the Card Recon executable with default settings, issue this command:

    # Run a default scan, save a compliance report and an encrypted database journal file. cr_x.x.x.exe -j journal-filename.jnl -password-inline password

  6. Card Recon prompts you to validate your license.
  7. Log in using one of the three methods (see Logging into Card Recon for more information):
    • Ground Labs Login.
    • Use an Online Token.
    • Use Offline License file.
  8. Once logged in, Card Recon runs a scan with default settings. When the scan completes, Card Recon automatically saves a compliance report.

Running the Card Recon CLI on Linux and Unix-like Systems

  1. In the Terminal, locate the Card Recon executable. E.g. cr_linux26_x.x.x.
  2. Open your terminal and run:

    chmod u+x cr_linux26_x.x.x

  3. Run the following command as root:

    # Run a default scan, save a compliance report and an encrypted database journal file. ./cr_linux26_x.x.x -j journal-filename.jnl -password-inline password

  4. Card Recon prompts you to validate your license.

  5. Log in using one of the three methods (see Logging into Card Recon for more information):
    • Ground Labs Login.
    • Use an Online Token.
    • Use Offline License File.

If you have not assigned a license to the current Target, Card Recon will return a list of licenses available in your Ground Labs Services Portal.
Card Recon CLI displaying the list of available licenses when attempting to scan a Target without an assigned license.

Card Recon should ask you to confirm authorization of the Target. For more information on Card Recon licensing, see Card Recon Licensing.

Card Recon starts scanning the Target with default settings.

Once done, Card Recon automatically saves a compliance report. To inspect and remediate matches found by Card Recon, load the database journal file (e.g. journal-filename.jnl) saved by the Card Recon CLI in the Card Recon GUI (see Results and Remediation).

To open these files, issue the following command as administrator:

# Where <filename>.pdf is the file saved by Card Recon that you want to open. chmod 644 <filename>.pdf