NAME

SYNOPSIS

  use Net::Google::SafeBrowsing2;
  use Net::Google::SafeBrowsing2::Sqlite;
  
  my $storage = Net::Google::SafeBrowsing2::Sqlite->new(file => 'google-v2.db');
  my $gsb = Net::Google::SafeBrowsing2->new(
        key     => "my key", 
        storage => $storage,
  );
  
  $gsb->update();
  my $match = $gsb->lookup(url => 'http://www.gumblar.cn/');
  
  if ($match eq MALWARE) {
        print "http://www.gumblar.cn/ is flagged as a dangerous site\n";
  }

  $storage->close();

DESCRIPTION

The library passes most of the unit tests listed in the API documentation. See the documentation (<http://code.google.com/apis/safebrowsing/developers_guide_v2.html>) for more details about the failed tests.

The Google Safe Browsing database must be stored and managed locally. Net::Google::SafeBrowsing2::Sqlite uses Sqlite as the storage back-end, Net::Google::SafeBrowsing2::MySQL uses MySQL. Other storage mechanisms (databases, memory, etc.) can be added and used transparently with this module.

You may want to look at "Google Safe Browsing v2: Implementation Notes" (<http://www.zscaler.com/research/Google%20Safe%20Browsing%20v2%20API.pdf>), a collection of notes and real-world numbers about the API. This is intended for people who want to learn more about the API, whether as a user or to make their own implementation.

The source code is available on github at <https://github.com/juliensobrier/Net-Google-SafeBrowsing2>.

If you do not need to inspect more than 10,000 URLs a day, you can use Net::Google::SafeBrowsing2::Lookup with the Google Safe Browsing v2 Lookup API which does not require to store and maintain a local database.

IMPORTANT: If you start with an empty database, you will need to perform several updates to retrieve all the Google Safe Browsing information. This may require up to 24 hours. This is a limitation of the Google API, not of this module. See "Google Safe Browsing v2: Implementation Notes" at <http://www.zscaler.com/research/Google%20Safe%20Browsing%20v2%20API.pdf>.

CONSTANTS

DATABASE_RESET

Google requested to reset (empty) the local database.

MAC_ERROR

The replies from Google could not be validated with the MAC keys.

MAC_KEY_ERROR

The request for the MAC keys failed.

INTERNAL_ERROR

An internal error occurred.

SERVER_ERROR

The server sent an error back to the client.

NO_UPDATE

No update was performed, probably because it is too early to make a new request to Google Safe Browsing.

NO_DATA

No data was sent back by Google to the client, probably because the database is up to date.

SUCCESSFUL

The operation was successful.

MALWARE

Name of the Malware list in Google Safe Browsing (shortcut to 'goog-malware-shavar')

PHISHING

Name of the Phishing list in Google Safe Browsing (shortcut to 'googpub-phish-shavar')

CONSTRUCTOR

  my $gsb = Net::Google::SafeBrowsing2->new(
        key     => "my key", 
        storage => Net::Google::SafeBrowsing2::Sqlite->new(file => 'google-v2.db'),
        debug   => 0,
        mac             => 0,
        list    => MALWARE,
  );

PUBLIC FUNCTIONS

  $gsb->update();

  my $result = $gsb->import_chunks(list => MALWARE, file => 'malware.dat');

  my $match = $gsb->lookup(url => 'http://www.gumblar.cn');

  my $@lists = $gsb->get_lists();

  print "Last error: ", $gsb->last_error(), "\n";
  $gsb->last_error(''); # Reset last error

PRIVATE FUNCTIONS

  my $match = $gsb->local_lookup(url => 'http://www.gumblar.cn');

  print $gsb->hex_to_ascii('hex value');

CHANGELOG

1.09

Use HTTPS to access safebrowsing.clients.google.com/.

1.07

Add "import_chunks()" feature to import add chunks and sub chunks from a file.

1.05

No code change. Move "local_lookup" to PRIVATE FUNCTIONS to avoid confusions.

1.04

Introduce Net::Google::SafeBrowsing2::Lookup. Remind people that Google Safe Browsing v1 has been deprecated by Google.

1.03

The source code is available on github at <https://github.com/juliensobrier/Net-Google-SafeBrowsing2>.

1.02

Fix uninitialized $self->{errors} variable

1.01

Use String::HexConvert for faster hex_to_ascii.

1.0

Separate the error output from the debug output.

0.9

Fix bug with local whitelisting (sub chunks). Fix the parsing of full hashes.

0.8

Reduce the number of full hash requests.

0.7

Add local_lookup to perform a lookup against the local database only. This function should be used for debugging purpose only. Small code optimizations.

0.6

Handle local database reset.

0.5

Update documentation.

0.4

Speed update the database update. The first update went down from 20 minutes to 20 minutes.

0.3

Fix typos in the documentation.

Remove dependency on Switch (thanks to Curtis Jewel).

Fix value of FULL_HASH_TIME.

0.2

Add support for Message Authentication Code (MAC)

SEE ALSO

Google Safe Browsing v2 API: <http://code.google.com/apis/safebrowsing/developers_guide_v2.html>

Net::Google::SafeBrowsing (Google Safe Browsing v1) is deprecated by Google since 12/01/2011.

AUTHOR

COPYRIGHT AND LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.